Créer un jeton de paiement
POST /directdebit/v1/accounts/account_id/purchases
Vous pouvez traiter une requête d’achat par prélèvement automatique à l’aide d’un jeton à usage unique généré depuis l’API Coffre-fort client et créer en même temps un jeton de paiement permanent qui sera associé au profil client et qui sera disponible pour les requêtes futures dans l’API Prélèvement automatique.
Cette requête n’est actuellement prise en charge que pour les comptes bancaires ACH et TEF.
L’exemple suivant montre comment créer un jeton de paiement permanent pour un compte TEF en utilisant un jeton à usage unique. La valeur utilisée pour le champ paymentToken dans cette requête est le paymentToken précédemment généré qui est renvoyé dans la réponse à une requête de création d’un jeton TEF à usage unique dans l’API Coffre-fort client.
curl -X POST https://api.test.paysafe.com/directdebit/v1/accounts/89987201/purchases \
-u devcentre322:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H 'Content-Type: application/json' \
-d ' {
"merchantRefNum": "123456789",
"amount": 2599,
"customerIp": "192.0.126.111",
"dupCheck": true,
"merchantCustomerId": "eft_purchase01",
"eft": {
"paymentToken": "DNjEzMTM4NDg1",
"replaceWithMultiUsePaymentToken": true,
"paymentDescriptor": "Transaction"
}
} '
Par défaut, le système de traitement des prélèvements automatiques vérifie qu’il n’y a pas de transactions en double.
Avant d’essayer l’exemple, vous devez :
- Fournir un numéro de référence unique pour chaque transaction (si cette valeur n’est pas unique et que le numéro a été utilisé au cours des 90 derniers jours, la requête sera considérée comme un doublon).
- Remplacez le numéro de compte marchand (89987201 dans l’exemple ci-dessus) dans l’URL par le numéro de compte de test que vous avez reçu pour la devise que vous souhaitez tester.
- Remplacer la clé API (après le -u) par la clé API que vous avez reçue.
{
"links": [
{
"rel": "self",
"href": "https://api.test.paysafe.com/directdebit/v1/accounts/89987201/purchases/a02e52c7-c991-4418-966a-b62989cb0eae"
}
],
"merchantCustomerId": "eft_purchase01",
"id": "a02e52c7-c991-4418-966a-b62989cb0eae",
"txnTime": "2016-12-14T15:12:18Z",
"status": "COMPLETED",
"currencyCode": "USD",
"merchantRefNum": "123456789",
"amount": 2599,
"customerIp": "192.0.126.111",
"dupCheck": true,
"eft": {
"replaceWithMultiUsePaymentToken": true,
"multiUsePaymentToken": "Def6jC0Opljot9d",
"accountHolderName": "First Company",
"paymentToken": "DNjEzMTM4NDg1",
"transitNumber": "22446",
"institutionId": "001",
"paymentDescriptor": "Transaction",
"accountNumber": "******55"
},
"profile": {
"id": "ef2abd0c-8475-4cd9-85c6-70e1e226533c"
},
"billingDetails": {
"street": "100 Queen Street West",
"street2": "Apt. 55",
"city": "Ottawa",
"state": "ON",
"country": "CA",
"zip": "M1M 1M1",
"phone": "6139991100"
}
}
La réponse comprend une valeur multiUsePaymentToken dans l’objet eft. Vous pouvez maintenant utiliser cette valeur comme paymentToken dans toute requête de prélèvement automatique TEF qui peut utiliser ce jeton à la place des données bancaires complètes, p. ex. un achat par TEF.
Voir notre rubrique Référence API pour la description intégrale des paramètres requis pour la requête et renvoyés dans la réponse.