Traiter un achat
POST /directdebit/v1/accounts/account_id/purchases
Une requête d’achat par prélèvement automatique vous permet de transférer de l’argent du compte bancaire d’un client vers votre compte de marchand. Pour traiter un achat, vous devez adresser une requête POST au point terminaison des achats pour le type de compte bancaire concerné : ACH, TEF, SEPA ou BACS; dans l’exemple ci-dessous, il s’agit d’un compte ACH. La transaction est effectuée en temps réel, mais le réseau bancaire prend généralement 3 à 5 jours pour transférer les fonds.
Pour plus d’informations sur le traitement d’un achat impliquant un paiement fractionné, cliquez ici.
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": "ORDER_ID:1231",
"amount": 10098,
"ach": {
"accountHolderName": "XYZ Company",
"accountType": "CHECKING",
"accountNumber": "988772192",
"routingNumber": "211589828",
"payMethod": "WEB"
},
"customerIp": "192.0.126.111",
"profile": {
"firstName": "Joe",
"lastName": "Smith",
"email": "Joe.Smith@hotmail.com"
},
"billingDetails": {
"street": "100 Queen Street West",
"city": "Los Angeles",
"state": "CA",
"country": "US",
"zip": "90210",
"phone": "3102649010"
}
} '
Cette requête contient un profil, une adresse de facturation et des informations complètes sur le compte bancaire. Vous pouvez effectuer cette requête sans ces données si vous utilisez un jeton de paiement créé avec l’API Coffre-fort client de Paysafe.
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"
}
],
"id": "a02e52c7-c991-4418-966a-b62989cb0eae",
"merchantRefNum": "ORDER_ID:1231",
"amount": 10098,
"ach": {
"accountHolderName": "XYZ Company",
"accountType": "CHECKING",
"lastDigits": "92",
"routingNumber": "211589828",
"payMethod": "WEB"
},
"customerIp": "192.0.126.111",
"profile": {
"firstName": "Joe",
"lastName": "Smith",
"email": "Joe.Smith@hotmail.com"
},
"billingDetails": {
"street": "100 Queen Street West",
"city": "Los Angeles",
"state": "CA",
"country": "US",
"zip": "90210",
"phone": "3102649010"
},
"txnTime": "2014-12-14T15:12:18Z",
"currencyCode": "USD",
"status": "PENDING"
}
La réponse renvoie une valeur d’identifiant et l’état indique si l’achat est terminé, en attente ou échoué. L’identifiant d’achat peut être utilisé pour rechercher ou annuler l’achat.
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.