Traiter une transaction à l’aide d’un jeton de paiement
Vous pouvez traiter des paiements à l’aide de cartes de crédit (API Paiements par carte) ou de comptes bancaires (API Prélèvement automatique) que vous avez stockés dans le coffre-fort client en vous référant au paymentToken associé à la carte ou au compte bancaire. Dans ce cas, le jeton de paiement remplace toutes les informations relatives à la carte ou au compte bancaire qui pourraient autrement figurer dans la requête (p. ex. le numéro de la carte et la date d’expiration).
- Lorsque vous avez ajouté une carte au profil dans l’exemple précédent, vous avez reçu en retour un paymentToken avec la valeur de CaBP0abDKgROjYU.
- Lorsque vous avez ajouté un compte bancaire au profil dans l’exemple précédent, vous avez obtenu en retour un paymentToken avec la valeur CNjEzMTM4NDg1.
Vous pouvez traiter des paiements à l’aide d’un appareil mobile, p. ex. avec Apple Pay, en incluant le paymentToken à usage unique requis pour chaque requête de paiement mobile. Les jetons à usage unique ne sont valides que 15 minutes et ne sont pas consommés par la vérification. Lorsque vous avez créé un jeton Apple Pay à usage unique dans l’exemple précédent, vous avez obtenu en retour un jeton paymentToken avec la valeur ABC4AFQQBC5UR5H.
Pour traiter une transaction d’achat par carte de crédit à l’aide d’un jeton de paiement, vous devez l’inclure dans une requête POST au point de terminaison des autorisations dans l’API Paiements par carte. Voir l’illustration ci-dessous pour une vue d’ensemble des étapes.
Vue d’ensemble de l’achat par carte à l’aide d’un jeton de paiement
L’exemple suivant montre comment traiter une demande de carte de crédit à l’aide du paymentToken qui représente cette carte.
Avant d’essayer l’exemple, vous devez :
- Remplacer la clé API (après le -u) par la clé API que vous avez reçue.
- Remplacez l’identifiant du compte par votre identifiant de compte.
curl -X POST https://api.test.paysafe.com/cardpayments/v1/accounts/89987201/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"
}
} '
| Valeur | Requis? | Type | Description |
|---|---|---|---|
| merchantRefNum | Oui | string | L’identification de la carte du marchand. |
| montant | Oui | integer | Le montant en unités monétaires mineures. |
| card.paymentToken | Oui | string | Le jeton de paiement représentant la carte utilisée pour la requête. |
| settleWithAuth | boolean | « true » lorsque la requête est une autorisation et un règlement. | |
| dupCheck | boolean | La valeur « true » est attribuée si cette requête n’est pas un doublon. | |
| description | string | Il s’agit d’une description de la transaction, fournie par le marchand. | |
| billingDetails | object | La requête des détails de facturation. | |
| merchantDescriptor | object | Le descripteur du marchand figurant sur le relevé de carte du client. |
{
"links":[
{
"rel":"settlement",
"href":"https://api.test.paysafe.com/cardpayments/v1/accounts/89987201/settlements/81ed5db0-971b-475b-81fd-18023732acd3"
},
{
"rel":"self",
"href":"https://api.test.paysafe.com/cardpayments/v1/accounts/89987201/auths/81ed5db0-971b-475b-81fd-18023732acd3"
}
],
"id":"81ed5db0-971b-475b-81fd-18023732acd3",
"merchantRefNum":"payment-token-demo-1",
"txnTime":"2014-06-09T15:57:49Z",
"status":"COMPLETED",
"amount":500,
"settleWithAuth":true,
"availableToSettle":0,
"card":{
"type":"VI",
"lastDigits":"2345",
"cardExpiry":{
"month":12,
"year":2019
}
},
"authCode":"100001",
"profile":{
"firstName":"John",
"lastName":"Smith",
"email":"john.smith@somedomain.com"
},
"billingDetails":{
"street":"100 Queen Street West",
"city":"Toronto",
"state":"ON",
"country":"CA",
"zip":"M5H2N2",
"phone":"713-444-5555"
},
"merchantDescriptor":{
"dynamicDescriptor":"test",
"phone":"test"
},
"currencyCode":"USD",
"avsResponse":"MATCH",
"settlements":[
{
"links":[
{
"rel":"self",
"href":"https://api.test.paysafe.com/cardpayments/v1/accounts/89987201/settlements/81ed5db0-971b-475b-81fd-18023732acd3"
}
],
"id":"81ed5db0-971b-475b-81fd-18023732acd3",
"merchantRefNum":"payment-token-demo-1",
"txnTime":"2014-06-09T15:57:49Z",
"status":"PENDING",
"amount":500,
"availableToRefund":500
}
]
}
Voir notre Référence API pour une description complète des paramètres de ce type de requête.