Paiement par carte avec jeton
Une fois que vous avez reçu le jeton à usage unique de Paysafe Checkout, vous pouvez l’utiliser pour effectuer un paiement à l’aide de l’API Paiements par carte.
Le jeton à usage unique est en fait appelé jeton lorsqu’il est créé par les SDK et paymentToken lorsqu’il est créé par le Coffre-fort. Il est également appelé paymentToken lorsqu’il est utilisé avec l’API Paiements par carte dans une autorisation, avec l’API Prélèvement automatique dans un achat et avec les MPA lors d’un paiement.
Si vos transactions sont libellées en plusieurs devises, vous devez réfléchir à la manière dont vous allez gérer les multiples comptes marchands concernés et sélectionner le bon compte à utiliser lors de l’encaissement des paiements.
Le point de terminaison de paiement utilise la clé API de serveur à serveur. N’utilisez pas l’API Paiements par carte à partir du navigateur Web du client, car cela exposerait cette clé.
Appelez le point de terminaison suivant à partir de votre serveur pour encaisser le paiement :
POST /cardpayments/v1/accounts/account_id/auths
curl -X POST https://api.test.paysafe.com/cardpayments/v1/accounts/1001087580/auths \
-u devcentre322:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H 'Content-Type: application/json' \
-d ' {
"merchantRefNum" : "payment-token-demo-1",
"amount" : 500,
"settleWithAuth":true,
"card" : {
"paymentToken" : "CaBP0abDKgROjYU"
},
"billingDetails": {
"street":"100 Queen Street West",
"city":"Toronto",
"state":"ON",
"country":"CA",
"zip":"M5H 2N2"
}
} '
Avant d’essayer l’exemple, vous devez :
- Remplacez le numéro de compte (1001087580) dans l’URL par le numéro de compte de test que vous avez reçu de Paysafe, en fonction de la devise que vous souhaitez utiliser. Dans cet exemple, il s’agit d’un objet ACH.
- Remplacez le nom d’utilisateur et le mot de passe de la clé API (après le -u) par la clé API Test que vous avez reçu de Paysafe.
- Substituez le paymentToken par le jeton de la carte de test que vous avez obtenu de Paysafe Checkout.
Si le système de vérification des adresses (AVS) est activé sur votre compte, vous devez inclure une adresse de facturation dans l’appel d’autorisation à l’aide de l’objet billingDetails. L’adresse de facturation est l’adresse de la carte représentée par le jeton de paiement. Notez que les comptes de test du Centre des développeurs ont activé AVS.
{
"links": [
{
"rel": "settlement",
"href": "https://api.test.paysafe.com/cardpayments/v1/accounts/1001087580/settlements/25c5a148-c5aa-4157-8318-c91961e1128e"
},
{
"rel": "self",
"href": "https://api.test.paysafe.com/cardpayments/v1/accounts/1001087580/auths/25c5a148-c5aa-4157-8318-c91961e1128e"
}
],
"id": "25c5a148-c5aa-4157-8318-c91961e1128e",
"merchantRefNum": "payment-token-demo-1",
"txnTime": "2017-03-06T20:42:06Z",
"status": "COMPLETED",
"amount": 520,
"settleWithAuth": true,
"preAuth": false,
"availableToSettle": 0,
"card": {
"type": "VI",
"lastDigits": "2345",
"cardExpiry": {
"month": 2,
"year": 2020
}
},
"authCode": "100614",
"billingDetails": {
"street": "100 Queen Street West",
"city": "Toronto",
"state": "ON",
"country": "CA",
"zip": "M5H2N2"
},
"merchantDescriptor": {
"dynamicDescriptor": "DD Line 1",
"phone": "000-111000099"
},
"currencyCode": "GBP",
"avsResponse": "MATCH",
"cvvVerification": "NOT_PROCESSED",
"settlements": [
{
"links": [
{
"rel": "self",
"href": "https://api.test.paysafe.com/cardpayments/v1/accounts/1001087580/settlements/25c5a148-c5aa-4157-8318-c91961e1128e"
}
],
"id": "25c5a148-c5aa-4157-8318-c91961e1128e",
"merchantRefNum": "payment-token-demo-1",
"txnTime": "2017-03-06T20:42:06Z",
"status": "PENDING",
"amount": 520,
"availableToRefund": 520
}
]
}
Si la carte spécifiée ou identifiée par un jeton dans la requête est enrôlée dans 3DS, il y aura un objet authentication dans la réponse, qui contiendra les données de l’inscription.
Conversion d’un jeton à usage unique en jeton permanent
Vous pouvez convertir le jeton à usage unique en un jeton de paiement permanent réutilisable en l’utilisant pour créer un profil dans le Coffre-fort client— le champ paymentToken renvoyé dans l’attribut card contient le jeton permanent. Paysafe vous recommande de vérifier que le jeton à usage unique correspond à une carte valide avant de créer le profil.