Paiement par prélèvement automatique avec jeton
Une fois que vous avez reçu le jeton de prélèvement automatique à usage unique de Paysafe Checkout, vous pouvez l’utiliser pour effectuer un paiement à l’aide de l’API Prélèvement automatique. Le système de paiement par prélèvement automatique utilisé dépend de la devise choisie pour la transaction.
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.
Paysafe Checkout ne prend actuellement en charge que les requêtes de paiement par prélèvement automatique TEF (CAD) et par prélèvement automatique (ACH) (USD).
Le point de terminaison de paiement utilise la clé API de serveur à serveur. N’utilisez pas l’API Prélèvement automatique à 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 /directdebit/v1/accounts/account_id/purchases
curl -X POST https://api.test.paysafe.com/directdebit/v1/accounts/1001199750/purchases \
-u test_username:B-qa2-0-59564dfa-0-302c021426a55dde98dc2a052cccc1ddc8daa776a7a4fe2e0214080388fded986767abc445e58af123c01003cb8b \
-H 'Content-Type: application/json' \
-d ' {
"merchantRefNum": "61544433",
"amount": 9988,
"customerIp": "192.0.126.111",
"ach": {
"paymentToken": "DcoFHClVLIrToBR",
"payMethod": "WEB"
}
} '
Avant d’essayer l’exemple, vous devez :
- Remplacez le numéro de compte (1001199750) 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 prélèvement automatique de test que vous avez obtenu de Paysafe Checkout.
{
"merchantRefNum": "61544433",
"amount": 9988,
"ach": {
"lastDigits": "22",
"paymentToken": "DcoFHClVLIrToBR",
"accountHolderName": "Argon Corp.",
"accountType": "CHECKING",
"payMethod": "WEB",
"routingNumber": "123456789",
"accountNumber": "******22"
},
"profile": {
"firstName": "Jane",
"lastName": "Smith"
},
"customerIp": "192.0.126.111",
"dupCheck": true,
"id": "6c7fd6c4-6045-49ec-96ec-bb256d1fa191",
"txnTime": "2018-09-19T13:57:20Z",
"currencyCode": "USD",
"status": "COMPLETED",
"links": [{
"rel": "self",
"href": "https://api.test.paysafe.com/directdebit/v1/accounts/1001199750/purchases/6c7fd6c4-6045-49ec-96ec-bb256d1fa191"
}]
}
Pour plus de détails sur la manière de soumettre un achat par prélèvement automatique à l’aide d’un paymentToken, voir la rubrique Achats de la documentation de l’API Prélèvement automatique.
Conversion d’un jeton à usage unique en jeton permanent
Vous pouvez convertir le jeton à usage unique en un jeton de paiement réutilisable et permanent, ce qui permet de mettre en œuvre des fonctionnalités comme la facturation récurrente (utilisée notamment pour payer un abonnement) ou une fonctionnalité « se souvenir de moi ». Pour ce faire, vous pouvez soit :
- Utiliser le compte bancaire ACH/TEF pour créer un profil dans le Coffre-fort client – le champ paymentToken renvoyé dans l’ensemble achBankAccounts/eftBankAccounts contient le jeton de paiement permanent.
- Utiliser le jeton à usage unique pour un achat par prélèvement automatique ou un crédit autonome par prélèvement automatique et inclure replaceWithMultiUsePaymentToken défini sur « true ».