Virements P2P

Transaction P2P

La fonctionnalité P2P vous aide à offrir aux utilisateurs (clients actuels ou potentiels) la possibilité de s'envoyer de l'argent mutuellement. Elle permet également de recevoir des virements sur vos cartes sans envoyer vos données à personne et de gagner des commissions en fournissant le service à un large éventail d'utilisateurs.

Le service P2P est un service disponible pour la configuration et l'intégration avec des sites web tiers, des applications mobiles, ainsi que des banques internet et mobiles.

Les utilisateurs ont accès à la liste complète des opérations, envoi/réception de virements, inscription/autorisation dans le service, gestion des cartes sauvegardées.

Une caractéristique importante du service P2P est la possibilité d'effectuer des virements par numéro de téléphone, même si l'utilisateur n'est pas encore enregistré dans le système.

Il existe plusieurs scénarios de mise en œuvre des transactions P2P :

• Les données du porteur de carte sont saisies côté passerelle
• Les données du porteur de carte sont saisies côté boutique en ligne

Scénario de traitement d'opération P2P avec saisie des données de paiement côté passerelle de paiement

1. Sur le site du vendeur (par exemple, dans une boutique en ligne) le porteur de carte demande l'exécution d'un virement d'argent P2P.
2. Le système de la boutique en ligne enregistre la commande dans la Passerelle de paiement via registerP2P.do. Les paramètres d'enregistrement utilisés incluent le montant du virement, la devise, le numéro de commande dans le système du vendeur et l'URL de retour pour le client.
   
3. La passerelle de paiement en réponse à la demande d'enregistrement retourne un identifiant unique de commande dans le système de paiement et une URL pour rediriger le client vers le formulaire de collecte des données de carte.
4. Le système de la boutique en ligne transmet l'adresse URL de redirection reçue à l'Étape 3 au navigateur du client.
5. Le navigateur du client ouvre l'adresse URL.
6. À l'adresse URL indiquée le navigateur du client obtient le formulaire pour la collecte des données de carte.
7. Le client remplit le formulaire et les données sont envoyées au serveur de la passerelle de paiement.
8. Le système vérifie l'appartenance de la carte à 3-D Secure (SecureCode).
9. La passerelle envoie le lien de redirection vers la page du serveur de contrôle d'accès (ACS) de la banque émettrice dans le navigateur web du client (cette étape est nécessaire pour l'implémentation de 3DS).
10. Le navigateur web du client demande le formulaire d'autorisation utilisateur à ACS.
11. ACS envoie le formulaire d'autorisation dans le navigateur web du client.
12. Le client remplit le formulaire et les données sont envoyées au serveur de la passerelle de paiement.
13. ACS traite le formulaire et, indépendamment du résultat, envoie l'adresse URL de redirection des pages de la passerelle de paiement dans le navigateur web du client. Avec cette URL sont envoyés les paramètres chiffrés du résultat d'autorisation.
14. Le navigateur web du client demande la page de la passerelle de paiement lors de la transmission des paramètres chiffrés du résultat d'autorisation.
15. La passerelle de paiement transfère l'argent.
16. Quand l'argent est transféré, la passerelle de paiement envoie l'URL de retour au navigateur web du client (l'URL a été spécifiée lors de l'enregistrement de la commande par la boutique en ligne à l'Étape 2).
17. Le navigateur web du client demande les résultats du transfert d'argent à la boutique en ligne.
18. Le système de boutique en ligne demande les informations sur le statut de la commande à la passerelle de paiement – getP2PStatus.do.
    
19. La passerelle de paiement retourne le statut de la commande.
20. Le système de boutique en ligne montre au client le résultat du paiement.

Scénario de réalisation d'opération P2P avec saisie des données de paiement du côté de la boutique en ligne

1. Le porteur de carte (client) interagit avec la boutique en ligne pour créer une commande.
2. Le système de boutique en ligne collecte les données de carte de son côté.
3. Le système de boutique en ligne enregistre la commande dans la Passerelle de paiement via registerP2P.do. Les paramètres d'enregistrement utilisés incluent le montant du transfert, la devise, le numéro de commande dans le système vendeur et l'URL de retour pour le client.
   
4. La passerelle de paiement en réponse à la demande d'enregistrement retourne l'identifiant unique de commande dans le système de paiement.
5. Optionnel. Si la boutique en ligne travaille avec commission, la boutique en ligne envoie à la passerelle de paiement une demande sur le montant de commission via verifyP2P.do / verifyP2PByBinding.do.
   
6. Optionnel. La passerelle de paiement envoie en réponse le montant de commission.
7. La boutique en ligne envoie une demande de transfert de fonds à la Passerelle de paiement via performP2P.do / performP2PByBinding.do.
   À cette étape, le fonctionnement de 3DS2 est initié.
   
8. La Passerelle de paiement vérifie sur le serveur 3DS si le client peut s'authentifier en utilisant le protocole 2.0.
9. La Passerelle de paiement envoie une réponse à la demande faite à l'Étape 6. La réponse retourne également les paramètres suivants :
   
   • is3DSVer2 - indicateur de possibilité d'authentification 3DSv2 (true/false)
   • threeDSServerTransId - identifiant de transaction attribué par le serveur 3DS
   • threeDSMethodURLServer - adresse du serveur 3DS pour la collecte de données du navigateur
   • threeDSMethodURL - (facultatif) adresse du serveur ACS pour la collecte de données du navigateur
   • threeDSMethodDataPacked - (facultatif) données pour la collecte de données du navigateur sur ACS
   
   (Voir aussi la description de la demande).
10. La boutique en ligne appelle threeDSMethodURLServer dans un iframe séparé en utilisant la méthode POST, en utilisant la valeur obtenue de la réponse à la demande de transfert de fonds. Cela permet au serveur 3DS de collecter des données sur le navigateur du client.
11. Facultatif. Si les paramètres threeDSMethodURL et threeDSMethodDataPacked ont été obtenus dans la réponse à la demande de transfert de fonds, la boutique en ligne appelle dans un iframe séparé par méthode POST threeDSMethodURL.
    
12. Transfert de fonds - étape 2. La boutique en ligne renvoie une demande d'exécution de transfert via performP2P.do / performP2PByBinding.do.
    Il est nécessaire de transmettre le paramètre threeDSServerTransId - identifiant de transaction qui a été créé par le serveur 3DS et retourné à l'Étape 10.
    
13. La Passerelle de paiement envoie une demande d'authentification au serveur 3DS.
14. Le serveur 3DS envoie une demande d'authentification (AReq) au serveur ACS.
15. Le serveur ACS envoie une réponse à la demande d'authentification (ARes) au serveur 3DS.
16. Le serveur 3DS envoie les données reçues à la passerelle de paiement.
17. 
    
    • Si le client n'a pas besoin de passer l'authentification dans ACS, la passerelle de paiement retourne une réponse à la demande de transfert de fonds. Dans ce cas, le scénario continue avec l'Étape 27.
    • Si le client doit passer l'authentification dans ACS, la Passerelle de paiement enverra une réponse à la page de paiement avec des données de redirection vers ACS.
18. La page de paiement redirige vers acsUrl avec le paramètre creq=packedCReq.
19. ACS affiche la page d'authentification pour le client (page challenge).
20. Le client est authentifié.
21. Le serveur ACS vérifie l'authenticité des données d'authentification.
22. Un échange de données a lieu entre les serveurs ACS et 3DS et le résultat du traitement est confirmé.
23. Le serveur ACS redirige le client vers la page de la boutique.
24. La boutique en ligne envoie une demande /p2p/finishThreeDsVer2.do à la passerelle de paiement.
25. La Passerelle de paiement envoie à la boutique en ligne une réponse à la demande faite.
26. La boutique en ligne envoie getP2PStatus.do au passerelle de paiement, afin de connaître le statut de la commande.
27. La passerelle de paiement envoie une réponse à la demande effectuée.
28. La boutique en ligne affiche la page de résultat au client.

Transaction AFT

AFT (Account Funding Transaction) – type spécial d'opérations de débit de fonds dans le but de recharger le compte interne du client dans le système du marchand ou du compte bancaire dans le système de la banque (souvent utilisé comme alternative à l'opération d'achat).

Scénario de réalisation de transaction AFT

Le scénario d'opération AFT a les particularités suivantes :

• Lors de l'exécution de la transaction AFT dans la demande d'enregistrement de commande il est nécessaire de transmettre le paramètre features avec la valeur WITHOUT_TO_CARD.
• Dans la transaction AFT dans la demande de paiement ou dans la demande de paiement par liaison sont indiquées seulement les données de la carte de débit, c'est-à-dire fromCard (le bloc toCard est absent, sauf dans le cas de virements transfrontaliers, voir ci-dessous).
• En cas de virements transfrontaliers, lors desquels le débit de la carte et le crédit sur le compte de transit sont appelés via la passerelle de paiement, et le crédit est appelé depuis un autre système externe, dans la demande de paiement dans le bloc toCard il est nécessaire d'indiquer le bloc replacementData, qui contient le numéro de carte et le numéro de compte de transit. Voir la description ici.

Scénario d'opération AFT avec saisie des données de paiement du côté de la passerelle de paiement

1. Sur le site du vendeur (par exemple, dans la boutique en ligne) le porteur de carte demande l'exécution du virement monétaire P2P.
2. Le système de boutique en ligne enregistre la commande dans la Passerelle de paiement via registerP2P.do avec le paramètre features=WITHOUT_TO_CARD. Les paramètres d'enregistrement utilisés incluent le montant du virement, la devise, le numéro de commande dans le système du vendeur et l'URL de retour pour le client.
   
3. La Passerelle de paiement en réponse à la demande d'enregistrement retourne un identifiant unique de commande dans le système de paiement et une URL pour rediriger le client vers le formulaire de collecte des données de carte.
4. Le système de boutique en ligne transmet l'URL de redirection reçue à l'Étape 3 au navigateur du client.
5. Le navigateur du client ouvre l'URL.
6. À l'URL indiquée, le navigateur du client obtient le formulaire de collecte des données de carte.
7. Le client remplit le formulaire, et les données sont envoyées au serveur de la passerelle de paiement.
8. Le système vérifie l'appartenance de la carte à 3-D Secure (SecureCode).
9. La passerelle envoie le lien de redirection vers la page du serveur de contrôle d'accès (ACS) de la banque émettrice dans le navigateur web du client (cette étape est nécessaire pour implémenter 3DS).
10. Le navigateur web du client demande le formulaire d'autorisation utilisateur depuis ACS.
11. ACS envoie le formulaire d'autorisation dans le navigateur web du client.
12. Le client remplit le formulaire, et les données sont envoyées au serveur de la passerelle de paiement.
13. ACS traite le formulaire et, indépendamment du résultat, envoie l'URL de redirection des pages de la passerelle de paiement dans le navigateur web du client. Avec cette URL sont envoyés les paramètres chiffrés du résultat d'autorisation.
14. Le navigateur web du client demande la page de la passerelle de paiement lors de la transmission des paramètres chiffrés du résultat d'autorisation.
15. La Passerelle de paiement transfère l'argent.
16. Quand l'argent est transféré, la passerelle de paiement envoie l'URL de retour dans le navigateur web du client (l'URL a été indiquée lors de l'enregistrement de la commande par la boutique en ligne à l'Étape 2).
17. Le navigateur web du client demande les résultats du transfert d'argent depuis la boutique en ligne.
18. Le système de boutique en ligne demande les informations sur le statut de la commande à la passerelle de paiement – getP2PStatus.do.
    
19. La Passerelle de paiement retourne le statut de la commande.
20. Le système de boutique en ligne montre au client le résultat du paiement.

Scénario d'opération AFT avec saisie des données de paiement du côté de la boutique en ligne

1. Le porteur de carte (client) interagit avec la boutique en ligne pour créer une commande.
2. Le système de la boutique en ligne collecte les données de carte de son côté.
3. Le système de la boutique en ligne enregistre la commande dans la Passerelle de paiement via registerP2P.do avec le paramètre features=WITHOUT_TO_CARD. Les paramètres d'enregistrement utilisés incluent le montant du transfert, la devise, le numéro de commande dans le système du vendeur et l'URL de retour pour le client.
   
4. La Passerelle de paiement en réponse à la demande d'enregistrement retourne un identifiant unique de commande dans le système de paiement.
5. Optionnel. Si la boutique en ligne travaille avec commission, la boutique en ligne envoie à la passerelle de paiement une demande sur le montant de la commission via verifyP2P.do / verifyP2PByBinding.do.
   
6. Optionnel. La Passerelle de paiement envoie en réponse le montant de la commission.
7. La boutique en ligne envoie une demande de transfert de fonds à la Passerelle de paiement via performP2P.do / performP2PByBinding.do, en spécifiant les données de la carte de débit dans le bloc fromCard.
   À cette étape, le fonctionnement du 3DS 2.0 est initié.
   
8. La Passerelle de paiement vérifie sur le serveur 3DS si le client peut s'authentifier en utilisant le protocole 2.0.
9. La Passerelle de paiement envoie une réponse à la demande faite à l'Étape 6. La réponse retourne également les paramètres suivants :
   
   • is3DSVer2 - flag de possibilité d'authentification 3DSv2 (true/false)
   • threeDSServerTransId - identifiant de transaction attribué par le serveur 3DS
   • threeDSMethodURLServer - adresse du serveur 3DS pour la collecte des données du navigateur
   • threeDSMethodURL - (optionnel) adresse du serveur ACS pour la collecte des données du navigateur
   • threeDSMethodDataPacked - (optionnel) données pour la collecte des données du navigateur sur ACS
   
   (Voir aussi la description de la demande).
10. La boutique en ligne appelle threeDSMethodURLServer dans un iframe séparé en utilisant la méthode POST, en utilisant la valeur obtenue de la réponse à la demande de transfert de fonds. Cela permet au serveur 3DS de collecter les données sur le navigateur du client.
11. Optionnel. Si dans la réponse à la demande de transfert de fonds les paramètres threeDSMethodURL et threeDSMethodDataPacked ont été obtenus, la boutique en ligne appelle dans un iframe séparé par méthode POST threeDSMethodURL.
    
12. Transfert de fonds - étape 2. La boutique en ligne renvoie à nouveau une demande d'exécution de transfert via performP2P.do / performP2PByBinding.do.
    Il est nécessaire de transmettre le paramètre threeDSServerTransId - identifiant de transaction qui a été créé par le serveur 3DS et retourné à l'Étape 10.
    
13. La Passerelle de paiement envoie une demande d'authentification au serveur 3DS.
14. Le serveur 3DS envoie une demande d'authentification (AReq) au serveur ACS.
15. Le serveur ACS envoie une réponse à la demande d'authentification (ARes) au serveur 3DS.
16. Le serveur 3DS envoie les données reçues à la passerelle de paiement.
17. 
    
    • Si le client n'a pas besoin de passer l'authentification dans ACS, la passerelle de paiement retourne une réponse à la demande de transfert de fonds. Dans ce cas, le scénario se poursuit avec l'Étape 27.
    • Si le client doit passer l'authentification dans ACS, la passerelle de paiement enverra une réponse à la page de paiement avec les données de redirection vers ACS.
18. La page de paiement redirige vers acsUrl avec le paramètre creq=packedCReq.
19. ACS affiche une page d'authentification pour le client (page challenge).
20. Le client est authentifié.
21. Le serveur ACS vérifie l'authenticité des données d'authentification.
22. Il y a un échange de données entre les serveurs ACS et 3DS et le résultat du traitement est confirmé.
23. Le serveur ACS redirige le client vers la page du magasin.
24. Le magasin en ligne envoie une demande /p2p/finishThreeDsVer2.do à la passerelle de paiement.
25. La passerelle de paiement envoie au magasin en ligne une réponse à la demande effectuée.
26. Le magasin en ligne envoie getP2PStatus.do à la passerelle de paiement pour connaître le statut de la commande.
27. La passerelle de paiement envoie une réponse à la demande effectuée.
28. Le magasin en ligne affiche la page de résultat au client.

Transaction OCT

OCT (Original Credit Transaction) - type particulier de transactions pour créditer des fonds au destinataire en temps réel.

• Dans une transaction OCT, la demande de paiement spécifie uniquement les données de la carte de crédit, c'est-à-dire toCard.
• Lors de l'exécution d'une transaction OCT dans la demande d'enregistrement de commande, il est nécessaire de passer le paramètre features avec la valeur WITHOUT_FROM_CARD.

Scénario de réalisation de transaction OCT

1. Le porteur de carte (client) interagit avec le magasin en ligne pour créer une commande.
2. Le système du magasin en ligne enregistre la commande dans la passerelle de paiement via registerP2P.do. Les paramètres d'enregistrement utilisés incluent le montant du transfert, la devise, le numéro de commande dans le système du vendeur et l'URL de retour pour le client.
3. La passerelle de paiement en réponse à la demande d'enregistrement retourne un identifiant unique de commande dans le système de paiement et une URL pour rediriger le client vers le formulaire de collecte des données de carte.
4. Le système du magasin en ligne transmet l'adresse URL de redirection, reçue à l'Étape 3, au navigateur du client.
5. Le client remplit le formulaire, et les données sont envoyées au serveur de la passerelle de paiement.
6. La passerelle de paiement effectue le transfert de fonds via performP2P.do.
7. Quand l'argent est transféré, la passerelle de paiement envoie l'adresse URL de retour au navigateur web du client (l'adresse URL était spécifiée lors de l'enregistrement de la commande par le magasin en ligne à l'Étape 2).
8. Le navigateur web du client demande les résultats du transfert d'argent au magasin en ligne.
9. Le système du magasin en ligne demande des informations sur le statut de la commande à la passerelle de paiement – getP2PStatus.do.
10. La passerelle de paiement retourne le statut de la commande.
11. Le système du magasin en ligne montre au client le résultat du paiement.

Appels API

Les demandes pour les transactions P2P doivent être signées. Les informations sur les signatures de demandes sont disponibles dans notre Guide API.

Enregistrement de commande P2P

Pour effectuer une commande de transfert d'argent de carte à carte, utilisez la requête https://dev.bpcbt.com/payment/rest/api/p2p/registerP2P.do.

Lors de l'exécution de la requête, il est nécessaire d'utiliser l'en-tête : Content-Type: application/json

Paramètres de requête

Description des paramètres de l'objet shippingPayerData :

Description des paramètres de l'objet preOrderPayerData :

Description des paramètres de l'objet orderPayerData.

Ci-dessous sont présentés les paramètres du bloc billingPayerData (données sur l'adresse d'enregistrement du client).

Ci-dessous sont présentés les paramètres du bloc billingRecipientData (données sur le destinataire).

Paramètres de réponse

Exemples

Exemple de requête

curl -X POST 'https://dev.bpcbt.com/payment/rest/api/p2p/registerP2P.do'
-H 'Content-Type: application/json'
--data-raw '{
  "username":"test_user",
  "password":"test_user_password",
  "amount" : 50000,
  "currency" : "978",
  "returnUrl" : "https://mybestmerchantreturnurl.com",
  "orderNumber": "1"
}'

Exemple de requête d'opération OCT

curl -X POST 'https://dev.bpcbt.com/payment/rest/api/p2p/registerP2P.do'
-H 'Content-Type: application/json'
--data-raw '{
  "username":"test_user",
  "password":"test_user_password",
  "amount" : 50000,
  "currency" : "978",
  "returnUrl" : "https://mybestmerchantreturnurl.com",
  "orderNumber": "12",
  "clientId": "122313",
  "creditBindingId": "99ef0cee-34fe-7312-ad7c-78bc00b3236a",
  "transactionTypeIndicator": "A",
  "features":{
      "feature":["FEATURE_1", "FEATURE_2", .. "FEATURE_N"]
   }
}'

Exemple de requête avec indication des données de l'expéditeur et du destinataire

curl -X POST 'https://dev.bpcbt.com/payment/rest/api/p2p/registerP2P.do' \
--header 'Content-Type: application/json' \
--data-raw '{ 
  "username": "test_user",
  "password": "test_user_password",
  "amount" : 1500,
  "currency" : "978",
  "returnUrl" : "https://mybestmerchantreturnurl.com",
  "failUrl" : "https://failUrl.com",
  "orderNumber": "01rthtbkuysgr",
  "email" : "test@test.com",

    "billingPayerData": {
        "payerAccount": "DE89370400440532013000",
        "payerLastName": "CHINA",
        "payerFirstName": "Mieville",
        "payerMiddleName": "Tom",
        "payerCombinedName": "CHINA Mieville",
        "payerIdType": "IDTP1",
        "payerIdNumber": "792209292",
        "billingCity": "BUD",
        "billingCountry": "348",
        "billingAddressLine1": "Terez krt",
        "billingAddressLine2": "Terez krt",
        "billingAddressLine3": "Terez krt",
        "billingPostalCode": "1067",
        "billingState": "VI",
        "payerBirthday": "19900101"
    },
    "billingRecipientData": {
        "recipientAccount": "DE89370400440532013000",
        "recipientLastName": "CHINA",
        "recipientFirstName": "Mieville",
        "recipientMiddleName": "Tom",
        "recipientCombinedName": "CHINA Mieville",
        "recipientIdType": "IDTP1",
        "recipientIdNumber": "792209292",
        "recipientCity": "BUD",
        "recipientCountry": "348",
        "recipientAddressLine1": "Terez krt",
        "recipientPostalCode": "1067",
        "recipientState": "VI",
        "recipientBirthday": "19900101"
    }
}'

Exemple de réponse

{
  "errorCode": 0,
  "errorMessage": "Successful",
  "orderId": "0a4eaae8-653a-71a9-8259-46fc00a8ea58",
  "formUrl": "https://dev.bpcbt.com/payment/merchants/ecom/payment.html?mdOrder=0a4eaae8-653a-71a9-8259-46fc00a8ea58&language=en",
  "orderNumber": "2009"
}

Montant de la commission

Pour obtenir le montant de la commission pour un virement bancaire, utilisez la requête https://dev.bpcbt.com/payment/rest/api/p2p/verifyP2P.do.

La structure de la requête prévoit la présence du bloc fromCard pour transmettre les attributs de la carte pour le débit et du bloc toCard pour transmettre les attributs de la carte pour le crédit.

En fonction des processus métier, lors de l'exécution d'un virement de carte à carte, les variantes suivantes peuvent être possibles :

• Les données de la carte de débit et les données de la carte de crédit des fonds sont transmises à la passerelle de paiement. Dans ce cas, les deux blocs de paramètres doivent être présents dans la requête — fromCard et toCard.
• Si le crédit sur la carte est effectué par un système tiers, alors seules les données de la carte de débit sont transmises à la passerelle de paiement. Dans ce cas, un seul bloc de paramètres doit être rempli – fromCard
• Si le débit de la carte est effectué par un système tiers, alors seules les données de la carte de crédit sont transmises à la passerelle de paiement. Dans ce cas, un seul bloc de paramètres doit être rempli – toCard

Lors de l'exécution de la requête, il est nécessaire d'utiliser l'en-tête : Content-Type: application/json

Paramètres de requête

Le bloc fromCard inclut les paramètres suivants :

Le bloc toCard inclut les paramètres suivants :

Ci-dessous sont présentés les paramètres du bloc billingPayerData (données sur l'adresse d'enregistrement du client).

Ci-dessous sont présentés les paramètres du bloc billingRecipientData (données sur le destinataire).

Paramètres de réponse

Le bloc feeDescriptionList inclut les paramètres suivants :

Exemples

Exemple de requête

curl -X POST 'https://dev.bpcbt.com/payment/rest/api/p2p/verifyP2P.do'
-H 'Content-Type: application/json'
--data-raw '{
  "username":"test_user",
  "password":"test_user_password",
  "orderId": "0a4eaae8-653a-71a9-8259-46fc00a8ea58",
  "fromCard": {
    "cardholderName": "TEST CARDHOLDER",
    "cvc": "123",
    "expirationMonth": 12,
    "expirationYear": 2030,
    "pan": "5000001111111115"
  },
  "toCard": {
    "pan": "4000001111111118"
  },    
  "amount" : 50000
}'

Exemple de réponse

{
  "errorCode": 0,
  "errorMessage": "Successful",
  "feeDescriptionList: [ {
    "feeAmount": 500,
    "feeCurrency": "978",
    "feeDescription": "Acquirer fee"
  } ]
}

Commission pour le virement P2P par liaison

Pour obtenir le montant de la commission lors du virement de fonds par liaison, utilisez la requête https://dev.bpcbt.com/payment/rest/api/p2p/verifyP2PByBinding.do.

Lors de l'exécution de la requête, il est nécessaire d'utiliser l'en-tête : Content-Type: application/json

Paramètres de la requête

Le bloc fromCard comprend les paramètres suivants :

Le bloc toCard comprend les paramètres suivants :

Paramètres de la réponse

Exemples

Exemple de requête

curl --location --request POST 'https://dev.bpcbt.com/payment/rest/api/p2p/verifyP2PByBinding.do' \
--header 'Content-Type: application/json' \
--data-raw '{
    "username": "test_user",
    "password": "test_user_password",
    "orderId": "fa71bf70-7c81-484e-a6fc-7db7e4283b2a",
    "bindingId": "4d792471-cee0-742c-922d-a265072e6148",
    "fromCard": {
        "seToken": "ofVx1r3aIJ3Mlx3nkfeOIJgFOnwfsgFK+V6Yzm+KxJgsq19l74GChhX0We/LEFq78Rhn9uFAEZGdeyDhnIc/KfuvObf0EzoDA65Uj1Z8FjwWyjnEwTBHZL4KmdFBCSk8jLxHt70mXwyjiHYyCVH1fT/UVOnsrkZVGrqmEG4MTi5dX9Znzf24DwRg4iezvdT8vf0dUW5lJdvY1tgOsOnBulwy6kH/YbHVsnR6yxO6d6IsdnT5f8PxaB+7ZyUqgrd6VA88FGJKJgdoxk4721pqKSG5dYroLJG96s23EDJ2Hpi4e9wU2rP7E6dlFw+qzATqX/eaJbaQ9eakkdMWnkj7aQ=="
    },
    "toCard": {
        "cardholderName": "IVAN IVANOV",
        "cvc": "123",
        "expirationMonth": 12,
        "expirationYear": 2024,
        "pan": "5555555555555599"
    },
    "amount": 1000,
    "currency": "978",
    "clientId": "123",
    "fromCard": {
        "bindingId": "fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc"
    },
    "toCard": {
        "pan": "4000001111111118"
    }
}'

Exemple de réponse

{
  "errorCode" : 0,
  "errorMessage" : "Successful",
  "feeDescriptionList" : [ {
    "feeAmount" : 10,
    "feeCurrency" : "978",
    "feeDescription" : "Acquirer fee"
  } ]
}

Virement P2P

Pour effectuer un virement d'argent de carte à carte, utilisez la requête https://dev.bpcbt.com/payment/rest/api/p2p/performP2P.do.

Lors de l'exécution de la requête, il est nécessaire d'utiliser l'en-tête : Content-Type: application/json

La structure de la requête performP2P.do prévoit la présence du bloc fromCard pour transmettre les attributs de la carte pour le débit et du bloc toCard pour transmettre les attributs de la carte pour le crédit. Selon les processus métier définis pour la banque et le magasin, lors de l'exécution du virement de carte à carte, les variantes suivantes peuvent être possibles.

• Le magasin transmet à la passerelle les données de la carte de débit et les données de la carte de crédit des fonds monétaires. Dans ce cas, les deux blocs de paramètres doivent être présents dans la requête — fromCard et toCard.
• Si le crédit sur la carte est effectué par un système tiers (opération AFT), alors le magasin transmet à la passerelle uniquement les données de la carte de débit. Dans ce cas, il ne doit y avoir qu'un seul bloc de paramètres – fromCard
• Si le débit de la carte est effectué par un système tiers (opération OCT), alors le magasin transmet à la passerelle uniquement les données de la carte de crédit. Dans ce cas, il ne doit y avoir qu'un seul bloc de paramètres – toCard

Paramètres de la requête

Valeurs possibles du paramètre tii :

Description des paramètres de l'objet shippingPayerData :

Description des paramètres de l'objet preOrderPayerData :

Description des paramètres de l'objet orderPayerData.

Ci-dessous sont présentés les paramètres du bloc billingPayerData (données sur l'adresse d'enregistrement du client).

Ci-dessous sont présentés les paramètres du bloc billingRecipientData (données sur le destinataire).

Le bloc fromCard comprend les paramètres suivants :

Lors des paiements utilisant des tokens (APPLE, SAMSUNG, GOOGLE) au lieu des données de carte dans le bloc fromCard est transmis :

Ci-dessous sont énumérés les paramètres du bloc threeDsAuthResult (données sur le résultat de l'authentification 3 DS).

Le bloc toCard comprend les paramètres suivants :

Dans certains cas, la requête pour une transaction AFT comprend un bloc toCard avec un bloc imbriqué replacementData contenant les données pour remplacer la destination du transfert dans les transactions AFT. Il contient le numéro de carte et le numéro de compte de transit du destinataire. Certains systèmes de paiement exigent la transmission de ces données dans les transactions AFT, c'est-à-dire que ces données sont utilisées pour l'authentification sur ACS pendant l'autorisation 3DS.
Pour utiliser ce bloc, le marchand doit avoir une autorisation spéciale (vérifiez auprès de l'équipe de support).

Ci-dessous sont listés les paramètres du bloc replacementData (données pour remplacer la destination dans les transactions AFT) :

Lors de l'authentification par le protocole 3DS2, les paramètres suivants sont également transmis :

Paramètres de réponse

Lors de l'authentification par le protocole 3DS2 en réponse à la première demande, les paramètres suivants arrivent :

Ci-dessous sont présentés les paramètres qui doivent être présents dans la réponse, après une demande répétée de paiement et la nécessité de rediriger le client vers ACS lors de l'authentification par le protocole 3DS2 :

Paramètres du bloc statusResponse :

Pour finaliser la transaction, utilisez la méthode /p2p/finishThreeDsVer2.do.

Exemples

Exemple de première demande en cas d'authentification par le protocole 3DS2

curl -X POST 'https://dev.bpcbt.com/payment/rest/api/p2p/performP2P.do'
-H 'Content-Type: application/json'
--data-raw '{
  "username":"test_user",
  "password":"test_user_password",
  "orderId": "0a4eaae8-653a-71a9-8259-46fc00a8ea58",
  "amount" : "50000",
  "fromCard": {
    "vendor": "APPLE",
    "paymentToken": "eyJkZXZpY2VNYW51ZmFjdHVyZXJJZGVudGlmaWVyIjoiMDUwMTEwMDMwMjczIiwiY3VycmVuY3lDb2RlIjoiOTc4IiwiYXBwbGljYXRpb25FeHBpcmF0aW9uRGF0ZSI6IjI3MDEzMSIsInBheW1lbnREYXRhIjp7Im9ubGluZVBheW1lbnRDcnlwdG9ncmFtIjoiQUc5WW5Pak1YOUJXQUFSaElJOFBBb0FCRkE9PSJ9LCJwYXltZW50RGF0YVR5cGUiOiIzRFNlY3VyZSIsInRyYW5zYWN0aW9uQW1vdW50IjoxMDAsImFwcGxpY2F0aW9uUHJpbWFyeUFjY291bnROdW1iZXIiOiI1NTU1NTU1NTU1NTU1NTk5In0=",
    "decryptedToken":true,
    "protocolVersion":"ECv1"
  },
  "toCard" : {
    "pan" : "4111111111111111"
  },
  "params" : [
        {"name" : "recipientName", "Name" : "Surname"},
        {"name" : "payerName", "value" : "Name1 Surname1"},
        {"name" : "payerCity", "value" : "City"},
        {"name" : "payerCountry", "value" : "Country"},
        {"name" : "payerPostalCode", "value" : "777777"},
        {"name" : "payerState", "value" : "State"},
        {"name" : "payerAddress", "value" : "street, 18"]
  },        

}'

Exemple de deuxième demande en cas d'authentification par le protocole 3DS2

curl -X POST 'https://dev.bpcbt.com/payment/rest/api/p2p/performP2P.do'
-H 'Content-Type: application/json'
--data-raw '{
  "username":"test_user",
  "password":"test_user_password",
  "orderId": "0a4eaae8-653a-71a9-8259-46fc00a8ea58",
  "fromCard": {
    "cardholderName": "TEST CARDHOLDER",
    "cvc": "123",
    "expirationMonth": 12,
    "expirationYear": 2030,
    "pan": "5000001111111115"
  },
  "toCard": {
    "pan": "4000001111111118"
  },    
  "amount" : 50000,
  "params" : [
        {"name" : "recipientName", "Name" : "Surname"},
        {"name" : "payerName", "value" : "Name1 Surname1"},
        {"name" : "payerCity", "value" : "City"},
        {"name" : "payerCountry", "value" : "Country"},
        {"name" : "payerPostalCode", "value" : "777777"},
        {"name" : "payerState", "value" : "State"},
        {"name" : "payerAddress", "value" : "street, 18"
  "threeDSServerTransId" : "3afc168a-94b4-4eb3-8e2e-80f6c186669d",
  "threeDSVer2FinishUrl" : "https://example.com/acs2/acs/3dsMethod"
}'

Exemple de demande de virement AFT

curl -X POST 'https://dev.bpcbt.com/payment/rest/api/p2p/performP2P.do'
-H 'Content-Type: application/json'
--data-raw '{
    "username": "test_user",
    "password": "test_user_password",
    "orderId": "0a4eaae8-653a-71a9-8259-46fc00a8ea58",
    "fromCard": {
        "cardholderName": "TEST CARDHOLDER",
        "cvc": "123",
        "expirationMonth": 12,
        "expirationYear": 2030,
        "pan": "5000001111111115"
    },
    "toCard": {
        "replacementData": {
            "card": "4111111111111111",
            "account": "A044039940702810010192938471"
        }
    },
    "amountInput": "1000025",
    "type": "STANDARD"
}'

Exemple de réponse à la première demande en cas d'authentification par le protocole 3DS2

{
  "errorCode": 0,
  "is3DSVer2": true,
  "threeDSServerTransId": "3afc168a-94b4-4eb3-8e2e-80f6c186669d",
  "threeDSMethodURL": "https://example.com/acs2/acs/3dsMethod",
  "threeDSMethodURLServer": "https://example.com/3dsserver/api/v1/client/gather?threeDSServerTransID=3afc168a-94b4-4eb3-8e2e-80f6c186669d",
  "threeDSMethodDataPacked": "eyJ0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMIjoiaHR0cHM6Ly9hY3F1aXJlci5jb20vM2Rzc2VydmVyL2FwaS92MS9hY3Mvbm90aWZpY2F0aW9uP3RocmVlRFNTZXJ2ZXJUcmFuc0lEPTNhZmMxNjhhLTk0YjQtNGViMy04ZTJlLTgwZjZjMTg2NjY5ZCIsInRocmVlRFNTZXJ2ZXJUcmFuc0lEIjoiM2FmYzE2OGEtOTRiNC00ZWIzLThlMmUtODBmNmMxODY2NjlkIn0="
}

Exemple de réponse à la deuxième demande en cas d'authentification par le protocole 3DS2

{
  "errorCode": 0,
  "info": "Your order is proceeded, redirecting...",
  "acsUrl": "https://example.com/acs2/acs/creq",
  "is3DSVer2": true,
  "packedCReq": "eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6IjNhZmMxNjhhLTk0YjQtNGViMy04ZTJlLTgwZjZjMTg2NjY5ZCIsIm1lc3NhZ2VUeXBlIjoiQ1JlcSIsIm1lc3NhZ2VWZXJzaW9uIjoiMi4xLjAiLCJhY3NUcmFuc0lEIjoiOWM3NTkxMmEtZTg0NC00ODgyLWI5YzctYzZmYmMzNjIyNGQ3IiwiY2hhbGxlbmdlV2luZG93U2l6ZSI6IjA1In0"
}

Transfert P2P par liaison

Pour effectuer un transfert de carte à carte à l'aide d'une liaison, utilisez la requête https://dev.bpcbt.com/payment/rest/api/p2p/performP2PByBinding.do.

Lors de l'exécution de la requête, il est nécessaire d'utiliser l'en-tête : Content-Type: application/json

Paramètres de la requête

Valeurs possibles du paramètre tii :

Le bloc fromCard comprend les paramètres suivants :

Ci-dessous sont énumérés les paramètres du bloc threeDsAuthResult (données sur le résultat de l'authentification 3 DS).

Le bloc toCard comprend les paramètres suivants :

Description des paramètres de l'objet shippingPayerData :

Description des paramètres de l'objet preOrderPayerData :

Description des paramètres de l'objet orderPayerData.

Ci-dessous sont présentés les paramètres du bloc billingPayerData (données sur l'adresse d'enregistrement du client).

Ci-dessous sont présentés les paramètres du bloc billingRecipientData (données sur le destinataire).

Lors de l'authentification par le protocole 3DS2, les paramètres suivants sont également transmis :

Paramètres de réponse

Lors de l'authentification par le protocole 3DS2 en réponse à la première demande, les paramètres suivants arrivent :

Ci-dessous sont présentés les paramètres qui doivent être présents dans la réponse, après la demande répétée de paiement et la nécessité de rediriger le client vers ACS lors de l'authentification par le protocole 3DS2 :

Paramètres du bloc statusResponse :

Exemples

Exemple de demande

curl -X POST 'https://dev.bpcbt.com/payment/rest/api/p2p/performP2PByBinding.do'
-H 'Content-Type: application/json'
--data-raw '{ 
  "amountInput" : 1000,
  "fromCard" : {
     "seToken": "ofVx1r3aIJ3Mlx3nkfeOIJgFOnwfsgFK+V6Yzm+KxJgsq19l74GChhX0We/LEFq78Rhn9uFAEZGdeyDhnIc/KfuvObf0EzoDA65Uj1Z8FjwWyjnEwTBHZL4KmdFBCSk8jLxHt70mXwyjiHYyCVH1fT/UVOnsrkZVGrqmEG4MTi5dX9Znzf24DwRg4iezvdT8vf0dUW5lJdvY1tgOsOnBulwy6kH/YbHVsnR6yxO6d6IsdnT5f8PxaB+7ZyUqgrd6VA88FGJKJgdoxk4721pqKSG5dYroLJG96s23EDJ2Hpi4e9wU2rP7E6dlFw+qzATqX/eaJbaQ9eakkdMWnkj7aQ=="
  },
  "toCard": {
        "cardholderName": "IVAN IVANOV",
        "cvc": "123",
        "expirationMonth": 12,
        "expirationYear": 2024,
        "pan": "5555555555555599"
  },
  "orderId" : "3dbaf8bb-1d68-76b3-b4e6-784700f26b04",
  "password" : "test_user_password",
  "type" : "WITHOUT_TO_CARD",
  "username" : "test_user"
}'

Exemple de première demande en cas d'authentification par le protocole 3DS2

curl -X POST 'https://dev.bpcbt.com/payment/rest/api/p2p/performP2PByBinding.do'
-H 'Content-Type: application/json'
--data-raw '{ 
  "amountInput" : 1000,
  "currency" : "978",
  "fromCard" : {
    "bindingId" : "fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc"
  },
  "orderId" : "38b7a9e0-7cfa-46f7-8655-f206a8898e7a",
  "password" : "test_user_password",
  "type" : "WITHOUT_TO_CARD",
  "username" : "test_user",
  "params" : {
    "name" : "payerAddress",
    "value" : "payer Address"
  }
}'

Exemple de deuxième demande en cas d'authentification par le protocole 3DS2

curl -X POST 'https://dev.bpcbt.com/payment/rest/api/p2p/performP2PByBinding.do'
-H 'Content-Type: application/json'
--data-raw '{ 
  "amountInput" : 1000,
  "currency" : "978",
  "fromCard" : {
    "bindingId" : "fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc"
  },
  "orderId" : "38b7a9e0-7cfa-46f7-8655-f206a8898e7a",
  "password" : "test_user_password",
  "type" : "WITHOUT_TO_CARD",
  "username" : "test_user",
  "params" : {
    "name" : "payerAddress",
    "value" : "payer Address"
  },
  "threeDSServerTransId" : "f44d6d21-1874-45a5-aeb0-1c710dd6e134",
  "threeDSVer2FinishUrl" : "https://example.com/acs2/acs/3dsMethod"
}'

Exemple de réponse

{
  "errorCode" : 0,
  "errorMessage" : "Successful",
  "info" : "Your order is proceeded, redirecting...",
  "redirect" : "https://example.com/?orderId=47743354-be15-7c70-b9ef-4bfc482e68dc&lang=en",
  "is3DSVer2" : false
}

Exemple de réponse à la première demande en cas d'authentification par le protocole 3DS2

{
  "errorCode": 0,
  "is3DSVer2": true,
  "threeDSServerTransId": "f44d6d21-1874-45a5-aeb0-1c710dd6e134",
  "threeDSMethodURLServer": "https://example.com/3dsserver/api/v1/client/gather?threeDSServerTransID=f44d6d21-1874-45a5-aeb0-1c710dd6e134",
}

Exemple de réponse à la deuxième demande en cas d'authentification par le protocole 3DS2

{
  "errorCode": 0,
  "info": "Your order is proceeded, redirecting...",
  "acsUrl": "https://example.com/acs2/acs/creq",
  "is3DSVer2": true,
  "packedCReq" : "eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6IjVmMzEyMjdlLTljZmQtNDQwYi1hNDNjLTE4NjljMzNhNGI5YiIsImFjc1RyYW5zSUQiOiI5YTQyYzQ4ZC1hNWRiLTQ3NjEtYmI4Mi05ZmY5MmM0NzZiM2QiLCJjaGFsbGVuZ2VXaW5kb3dTaXplIjoiMDQiLCJtZXNzYWdlVHlwZSI6IkNSZXEiLCJtZXNzYWdlVmVyc2lvbiI6IjIuMS4wIn0="
}

Traduction instantanée P2P

Pour effectuer une traduction instantanée P2P sans appeler une demande d'enregistrement de commande, utilisez la demande https://dev.bpcbt.com/payment/rest/api/p2p/instantPerformP2P.do.

Lors de l'exécution de la demande, il est nécessaire d'utiliser l'en-tête : Content-Type: application/json

La structure de la demande instantPerformP2P.do suppose la présence d'un bloc fromCard pour transmettre les attributs de la carte pour le débit et d'un bloc toCard pour transmettre les attributs de la carte pour le crédit. En fonction des processus métier définis pour la banque et le magasin, lors de l'exécution du transfert de carte à carte, les variantes suivantes peuvent être possibles.

• Le magasin transmet à la passerelle les données de la carte de débit et les données de la carte de crédit des fonds monétaires. Dans ce cas, les deux blocs de paramètres doivent être présents dans la demande — fromCard et toCard.
• Si le crédit sur la carte est effectué par un système tiers (opération AFT), alors le magasin transmet à la passerelle seulement les données de la carte de débit. Dans ce cas, il ne doit y avoir qu'un seul bloc de paramètres – fromCard
• Si le débit de la carte est effectué par un système tiers (opération OCT), alors le magasin transmet à la passerelle seulement les données de la carte de crédit. Dans ce cas, il ne doit y avoir qu'un seul bloc de paramètres – toCard

Paramètres de la demande

Valeurs possibles du paramètre tii :

Description des paramètres de l'objet shippingPayerData :