Utilisation d’un service 3DS externe pour 3DS 2.0
Introduction
Vous pouvez utiliser le service externe 3D Secure de votre choix lorsque vous effectuez des paiements en ligne (sans présentation de carte) avec nous si vous en avez déjà un. Ce service permet à l’API Paiements Paysafe d’accepter des transactions d’achat et d’autorisation pour lesquelles la vérification 3D Secure est effectuée en externe à l’aide d’un MPI externe. En exécutant les règles de transfert de responsabilité de votre côté, vous décidez de procéder ou non à la transaction et, en conséquence, vous transmettez l’objet d’authentification à l’API Paiements.
Étapes à suivre dans 3D Secure
Veuillez suivre les étapes suivantes :
- Créer un gestionnaire de paiement Vous devez transmettre l’objet « authentification » dans la requête de traitement du paiement.
- Pour 3DS2.0, voici la structure de l’objet « authentification ».
Structure de l’objet d’authentification 3DS2.0
- Pour 3DS2.0, voici la structure de l’objet « authentification ».
"authentication": {
"eci": 6,
"cavv": "Y2FyZGluYWxjb21tZXJjZWF1dGg=",
"threeDResult": "A",
"threeDSecureVersion": "2.1.0",
"directoryServerTransactionId": "faf2069e-d630-4625-948a-e0479c278af1"
}
Requête de gestion de paiement
{
"merchantRefNum": "c2aff8e6-6265-4631-b186-1fcd2abd7978",
transactionType:"transactionType": "PAYMENT",
"accountId": "1009688230",
"authentication": {
"eci": 6,
"cavv": "Y2FyZGluYWxjb21tZXJjZWF1dGg=",
"threeDResult": "A",
"threeDSecureVersion": "2.1.0",
"directoryServerTransactionId": "faf2069e-d630-4625-948a-e0479c278af1"
},
"card": {
"cardNum": "4037112233000001",
"cardExpiry": {
"month": 12,
"year":2025
},
"cvv": "111",
"holderName": "Dilip"
},
"paymentType": "CARD",
"amount": 900,
"currencyCode": "USD",
"customerIp": "172.0.0.1",
"billingDetails": {
"nickName": "Home",
"street": "100 Queen",
"street2": "Unit 201",
"city": "Toronto",
"zip":"M5H2N2","zip": "M5H 2N2","zip": "M5H 2N2",
"country": "CA"
},
"merchantDescriptor": {
"dynamicDescriptor": "OnlineStore",
"phone": "12345678"
},
"returnLinks": [
{
"rel": "on_completed",
"href": "https://usgaminggamblig.com/payment/return/success",
"method": "GET"
},
{
"rel": "on_failed",
"href": "https://usgaminggamblig.com/payment/return/failed",
"method": "GET"
},
{
"rel": "default",
"href": "https://api.qa.paysafe.com/checkout/v2/pages/redirect-success.html",
"method": "GET"
}
]
}
- Dans la réponse de l’API Gestionnaire de paiement, vous obtiendrez un jeton « paymentHandleToken" » qui sera en l’état Payable.
- Utilisez le jeton paymentHandleToken pour traiter la requête de paiement via l’API Paiements à l’aide de la clé privée. Vous devez lancer une requête POST vers le point de terminaison :
- Post:paymenthub/v1/payments
Un gestionnaire de paiement peut être utilisé dans une requête de paiement seulement si l’état est PAYABLE.