Aperçu
- Value Added Service
- Canada
- United States
L’API Validation de compte bancaire Paysafe permet à un marchand de valider la propriété du compte bancaire d’un client en invitant ce dernier à fournir ses authentifiants bancaires en ligne dans une interface utilisateur que Paysafe lui présente. Une fois que le client a été vérifié comme étant le titulaire du compte bancaire, le marchand peut alors procéder à un paiement sur le compte bancaire du client lorsque ce dernier souhaite effectuer un encaissement, par exemple.
Valider le compte bancaire d’un client
Voici un exemple de processus de validation d’un compte bancaire pour l’encaissement d’un client :
-
Le client souhaite encaisser l’argent sur le site du marchand.
-
Le marchand envoie une requête API de vérification de compte bancaire, comprenant des informations sur le profil du client.
curl -X https://api.test.paysafe.com/bankaccountvalidator/v1/accounts/123456789/verifications \
-u devcentre322:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H ’Content-Type: application/json’ \
-d ’{
"merchantRefNum": "1323563",
"profile": {
"firstName":"John",
"middleName": "James",
"lastName" : "Smith",
"locale": "en_CA"
},
"accountTypes": [
"SAVING",
"CHEQUING"
],
"currencyCodes": [
"CAD",
"USD"
],
"returnLinks": [
{
"rel": "default",
"href": "https://mysite.com/return"
}
],
"bankscheme": "EFT"
}’ -
-
Paysafe renvoie au marchand une réponse contenant une URL de redirection.
{
"merchantRefNum": "1323563",
"profile": {
"firstName":"John",
"middleName": "James",
"lastName" : "Smith",
"locale": "en_CA"
},
"accountTypes": [
"SAVING",
"CHEQUING"
],
"currencyCodes": [
"CAD",
"USD"
],
"returnLinks": [
{
"rel": "default",
"href": "https://mysite.com/return"
}
],
"bankscheme": "EFT",
"id": "6a275b7c-6f11-4ed1-ae77-21071724574a",
"sessionId": "MjM5NWRlMTQtNDE4Yy0xMWU5LWIyMTAtZDY2M2JkODczZDkz",
"status": "INITIATED",
"links": [
{
"rel": "redirect_bank_validation",
"href": "https://api.paysafe.com/bankaccountvalidator/v1/redirect?sessionId=MjM5NWRlMTQtNDE4Yy0xMWU5LWIyMTAtZDY2M2JkODczZDkz"
}
]
} -
-
Le marchand envoie une requête de redirection à Paysafe et transmet l’URL de redirection au navigateur du client, qui est alors redirigé vers une interface utilisateur lui permettant de sélectionner une banque.
-
Une fois que le client a sélectionné la banque, il doit fournir les authentifiants d’identification.
Remarque : En fonction de la configuration du compte bancaire, le client peut être invité à répondre à une question défi qu’il a lui-même définie au préalable.
-
Lorsque le client confirme avec succès son identité, l’API fait correspondre le nom du client fourni dans la requête de vérification du compte bancaire avec le nom associé aux authentifiants d’identification de la banque en ligne, puis redirige le client vers une page de sélection de compte.
-
Le client sélectionne le compte bancaire qu’il souhaite utiliser pour effectuer son encaissement. Remarque : Les comptes bancaires marqués comme étant des comptes d’entreprise au niveau de la banque ne seront pas présentés au client en tant qu’options de sélection.
-
Paysafe envoie une réponse finale à l’URL que le marchand a indiquée dans l’objet returnLinks dans la requête de vérification. <https://mysite.com/return>?status=SUCCESS&sessionId=MjM5NWRlMTQtNDE4Yy0xMWU5LWIyMTAtZDY2M2JkODczZDkz
-
Lorsque l’état de la réponse finale est SUCCESS, le marchand envoie une requête de vérification GET à Paysafe.
-
La réponse de Paysafe comprend un objet de compte bancaire (p. ex. eft) qui contient les détails du compte bancaire et un jeton de paiement à usage unique dont la durée de validité est de 15 minutes.
{
"merchantRefNum": "1323563",
...
"eft": {
"accountHolderName": "John Smith",
"institutionId": "001",
"transitNumber": "25039",
"lastDigits": "01",
"accountType": "SAVING",
"paymentToken": "8Y9u7WR3E32EB09J"
},
...
} -
-
Le marchand utilise le jeton de paiement à usage unique pour POST un crédit autonome au compte bancaire du client.
- Le client souhaite encaisser l’argent sur le site du marchand.
- Le marchand envoie une requête API de vérification de compte bancaire, comprenant des informations sur le profil du client.
curl -X https://api.test.paysafe.com/bankaccountvalidator/v1/accounts/123456789/verifications \
-u devcentre322:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H ’Content-Type: application/json’ \
-d ’{
"merchantRefNum": "1323563",
"profile": {
"firstName":"John",
"middleName": "James",
"lastName" : "Smith",
"locale": "en_CA"
},
"accountTypes": [
"SAVING",
"CHEQUING"
],
"currencyCodes": [
"CAD",
"USD"
],
"returnLinks": [
{
"rel": "default",
"href": "https://mysite.com/return"
}
],
"bankscheme": "EFT"
}’
- Paysafe renvoie au marchand une réponse contenant une URL de redirection.
{
"merchantRefNum": "1323563",
"profile": {
"firstName":"John",
"middleName": "James",
"lastName" : "Smith",
"locale": "en_CA"
},
"accountTypes": [
"SAVING",
"CHEQUING"
],
"currencyCodes": [
"CAD",
"USD"
],
"returnLinks": [
{
"rel": "default",
"href": "https://mysite.com/return"
}
],
"bankscheme": "EFT",
"id": "6a275b7c-6f11-4ed1-ae77-21071724574a",
"sessionId": "MjM5NWRlMTQtNDE4Yy0xMWU5LWIyMTAtZDY2M2JkODczZDkz",
"status": "INITIATED",
"links": [
{
"rel": "redirect_bank_validation",
"href": "https://api.paysafe.com/bankaccountvalidator/v1/redirect?sessionId=MjM5NWRlMTQtNDE4Yy0xMWU5LWIyMTAtZDY2M2JkODczZDkz"
}
]
}
- Le marchand envoie une requête de redirection à Paysafe et transmet l’URL de redirection au navigateur du client, qui est alors redirigé vers une interface utilisateur lui permettant de sélectionner une banque.
- Une fois que le client a sélectionné la banque, il doit fournir les authentifiants d’identification.
En fonction de la configuration du compte bancaire, le client peut être invité à répondre à une question défi qu’il a lui-même définie au préalable.
- Lorsque le client confirme avec succès son identité, l’API fait correspondre le nom du client fourni dans la requête de vérification du compte bancaire avec le nom associé aux authentifiants d’identification de la banque en ligne, puis redirige le client vers une page de sélection de compte.
- Le client sélectionne le compte bancaire qu’il souhaite utiliser pour effectuer son encaissement.
Les comptes bancaires marqués comme étant des comptes d’entreprise au niveau de la banque ne seront pas présentés au client en tant qu’options de sélection.
- Paysafe envoie une réponse finale à l’URL que le marchand a indiquée dans l’objet returnLinks dans la requête de vérification. <https://mysite.com/return>?status=SUCCESS&sessionId=MjM5NWRlMTQtNDE4Yy0xMWU5LWIyMTAtZDY2M2JkODczZDkz
- Lorsque l’état de la réponse finale est SUCCESS, le marchand envoie une requête de vérification GET à Paysafe.
- La réponse de Paysafe comprend un objet de compte bancaire (p. ex. eft) qui contient les détails du compte bancaire et un jeton de paiement à usage unique dont la durée de validité est de 15 minutes.
{
"merchantRefNum": "1323563",
...
"eft": {
"accountHolderName": "John Smith",
"institutionId": "001",
"transitNumber": "25039",
"lastDigits": "01",
"accountType": "SAVING",
"paymentToken": "8Y9u7WR3E32EB09J"
},
...
}
- Le marchand utilise le jeton de paiement à usage unique pour POST un crédit autonome au compte bancaire du client.