Concept
<todo>
urls{
"succes":"https://myProcessingServer.net/myApi/success.php?transId=95330876-67ae-4949-a11c-b9a29257831b",
"error":"https://myProcessingServer.net/myApi/cancel.php?transId=95330876-67ae-4949-a11c-b9a29257831b",
"webhook":"https://myBackOfficeServer.net/webhook.php"
}
URL return & cancel
Ces adresses sont appelées à la fin du processus de paiement lorsque le client valide le résultat de la transaction.
L'url appelée est celle renseignée par le commerçant lors de l'initialisation du paiement.
Vous devez intégrer à l'url un paramètre propre à votre back-office permettant de lier ce retour à la vente.
- url return: c'est le point d'entrée du commerçant pour finaliser la commande coté back-office marchant.
Cette url est appelé lorsque la transaction est finalisée avec succès. - url cancel: même principe que pour l'url return, cette url est appelée lorsque la transaction à été refusée.
Une de ces deux url sera obligatoirement appelé à la fin du traitement bancaire de la transaction, afin de:
- Informer le commerçant du statut de la transaction : validée ou non.
- de retourner au back-office du commerçant l'identifiant unique de la transaction (payId) générée par Axepta Online.
URL webhook
Cette adresse est appelée en dehors du processus de paiement.
C'est le mécanisme asynchrone utilisé par la plateforme Axepta BNP Paribas Online pour notifier le commerçant de la validation de la transaction.
Il est indispensable pour le site marchand de prendre en charge la réception de ce message.
C'est le seul accusé de complétion de transaction dont l'envoie est garanti.
Si le client ferme la fenêtre de navigation lors de la validation du paiement, l'appel a l'url return ou cancel ne sera pas fait.
Il n'est donc pas garanti pour le site marchant de recevoir cette confirmation de paiement.
Action à faire lors de la reception de ces messages
Ces messages informent d'un changement d'état d'une transaction de paiement.
Pour connaitre en quoi consiste ce changement, vous devez contacter le serveur Axepta BNP Paribas Online pour récupérer le statut de la transaction.
Utilisez l'api GET /payments/getByPayId/<id> avec le Payment Id reçu en paramètre.
Eléments clés de la réponse à l'api getByPayId
- montant de la transaction
- autorisé
- capturé
- remboursé
- Identifiants de la transaction
- payId: id transaction Axepta BNP Paribas Online
- transId: id transaction Marchand
- xId: id action Axepta BNP Paribas Online
- refNr: numéro de reference de la transaction
- Status de la transaction
- status: Status de la transaction, succès (OK) ou en erreur (FAILED)
- responseCode: "000000000" si la transaction est réussi, un code erreur en cas d'echec.
- responseDescription: une phrase résumant l'état de la transaction.
{
"amount":{
"value":126,
"currency":"EUR",
"capturedValue":0,
"refundedValue":0
},
"payId":"91a6299a704147bf934aabd79fd1dc5d",
"merchantId":"MY_MERCHANT_ID",
"transId":"Trans361039",
"xId":"b55e68b7e4644a90836ae31effe1fc60",
"refNr":"refNb77254",
"status":"AUTHORIZED",
"responseCode":"00000000",
"responseDescription":"Transaction successful",
"paymentMethods":{
"type":"CARD"
}
}