An introduction to 3DSV2 is available in the section 3D Secure - Strong Authentication for Secure Payments |
The 3DS V2 protocol supports 150 data points transmitted to the issuer. However, processing these data points by the issuers can be time-consuming. Therefore, it is recommended to share the most essential and effective data points with the issuer to benefit from 'frictionless' payments.
In a payment request, the merchant must mandatorily transmit the following data:
To promote frictionless payments, the merchant can:
Certaines données complémentaires sont fortement recommandées pour améliorer l’analyse de risque de la transaction par l’émetteur :
Some additional data is strongly recommended to improve the transaction risk analysis by the issuer:
The following JSON objects can be added to payment requests:
customerInfo
The recommended data are as follows:
Note: All this data will be used to secure the online process with the aim of fighting fraud. Issuing banks are regulated in the management of these confidential data.
...
"customerInfo": {
"merchantCustomerId": "cus_1234567890abcdef",
"customerType": "individual",
"firstName": "Max",
"lastName": "Mustermann",
"email": "customer@example.com",
"phone": {
"countryCode": "+49",
"number": "1236547890"
},
"salutation": "Ms",
"title": "Dr",
"gender": "female",
"maidenName": "Mustermann",
"middleName": "sam",
"birthDate": "2001-01-01",
"birthPlace": "Bamberg",
"socialSecurityNumber": "123443534"
},
... |
...
"billingAddress": {
"streetName": "Schwarzenbergstr",
"streetNumber": "4",
"city": "Bamberg",
"country": "DEU",
"postalCode": "96050"
},
"shipping": {
"address": {
"streetName": "Schwarzenbergstr",
"streetNumber": "4",
"city": "Bamberg",
"country": "DEU",
"postalCode": "96050"
}
},
... |
The addition of these additional data without an explicit request for 'frictionless' payment corresponds to the 'no Preference' case. In this case, if the payment is 'frictionless', the transfer of responsibility to the issuing bank applies. For more details: Liability Shift and 3D-Secure Matrices |
L’objet JSON threeDsPolicy permet au commerçant d'indiquer son souhait d’offrir un parcours frictionless à son acheteur.
Le paramètre challengePreference indique la préférence du commerçant vis-à-vis de l’authentification :
In all cases, the final decision is made by the issuing bank (the cardholder's bank).
...
"paymentMethods": {
"integrationType": "HOSTED",
"type": "CARD",
"card": {
"threeDsPolicy": {
"challengePreference" : "NO_CHALLENGE"
}
}
}
... |
Le transfert de responsabilité vers la banque émettrice dépend du choix du marchand et de la marque de la carte. The transfer of liability to the issuing bank depends on the merchant's choice and the card brand. For more details: Liability Shift and 3D-Secure Matrices - Documentation Axepta BNP Paribas |
L’objet JSON threeDsPolicy permet au commerçant d'indiquer une demande d'exemption.
Le paramètre threeDsPolicy – exemption.reason indique l'exemption souhaitée par le commerçant :
Dans tous les cas, le choix final est défini par la banque émettrice (banque du porteur).
...
"paymentMethods": {
"integrationType": "HOSTED",
"type": "CARD",
"card": {
"threeDsPolicy": {
"exemption" : {
"reason" : "LOW_VALUE"
}
}
}
}
... |
Le transfert de responsabilité vers la banque émettrice dépend du choix du marchand et de la marque de la carte. Pour plus de détails : Transfert de reponsabilité et Matrices 3D-Secure |