Dictionnaire des données
REMOTE MPI
L’ensemble des variables Paybox Direct est résumée dans ce tableau. Le détail de chaque variable (format, contenu, exemples) est donné dans les pages qui suivent.
VARIABLE | QUESTION | REPONSE | RESUME |
Amount | X | Montant de la demande d’autorisation | |
CCExpDate | X | Date d’expiration de la carte | |
CCNumber | X | Numéro de carte | |
Currency | X | Devise | |
CVVCode | X | Cryptogramme visuel | |
IdMerchant | X | Identifiant commerçant fourni par Paybox | |
IdSession | X | X | Identifiant de session unique |
URLHttpDirect | X | URL de retour serveur à serveur | |
URLRetour | X | URL de retour depuis le navigateur du client | |
3DCAVV | X | Valeur reçue des ACS | |
3DCAVVALGO | X | Identifiant de l’algorithme ayant servi à l’identification du porteur sur l’ACS | |
3DECI | X | E-Commerce Indicator | |
3DENROLLED | X | Etat de l’enrôlement du porteur | |
3DERROR | X | Erreur renvoyée par le MPI | |
3DSIGNVAL | X | Statut de la vérification de la signature du porteur | |
3DSTATUS | X | Statut de la demande d’authentification | |
3DXID | X | Référence provenant du MPI | |
Check | X | Signature Paybox | |
ID3D | X | Identifiant de contexte Paybox | |
StatusPBX | X | Statut de la demande d’authentification |
Tableau 1 : Liste des variables PAYBOX Remote MPI
Variables d’appel PAYBOX Remote MPI
Amount
Format : Numérique. Obligatoire.
Montant total de la transaction en centimes (sans virgule ni point).
Vous devez obligatoirement définir le même montant pour la demande d’authentification Remote MPI et pour la demande d’autorisation Paybox Direct.
Exemple pour 19€90 : 0000001990
Equivalent Paybox Direct : MONTANT
CCExpDate
Format : Date (MMAA) Obligatoire.
Date de fin de validité de la carte.
Exemple : 1213 (décembre 2013)
Equivalent Paybox Direct : DATEVAL
CCNumber
Format : 19 caractères. Obligatoire.
Numéro de carte du porteur (client) sans espace.
Exemple : 1111222233334444
Equivalent Paybox Direct : PORTEUR
Currency
Format : 3 chiffres. Obligatoire.
Code monnaie de la transaction suivant la norme ISO 4217 (code numérique)
Exemples :
- Euro : 978
- US Dollar : 840
- CFA : 952
Avant d’effectuer un paiement en devises, assurez-vous que votre banque et que votre contrat l’autorisent.
Equivalent Paybox Direct : DEVISE
CVVCode
Format : 3 ou 4 caractères. Obligatoire pour les questions de type 1, 3, 4, 12.
Cryptogramme visuel situé au dos de la carte bancaire.
Remarque : Les cartes AMERICAN EXPRESS ont sur leur recto un CIN (Card Identification Number) sur 4 chiffres.
Exemple : 123
Equivalent Paybox Direct : CVV
IdMerchant
Format : Numérique. Obligatoire.
Identifiant du commerçant fourni par Paybox lors de la souscription.
Exemple : 2
IdSession
Format : jusqu’à 250 caractères. Obligatoire.
Identifiant unique de la requête permettant d’éviter les confusions au niveau des réponses en cas de questions multiples et simultanées.
Chaque appel doit avoir un numéro de question unique pour un commerçant donné.
Exemple : Session001
URLHttpDirect
Format : jusqu’à 250 caractères.
URL de retour de serveur à serveur. Si l’URL n’est pas présente, PAYBOX utilisera celle paramétrée sur la fiche site du commerce.
Exemple : http://maboutique.com/retourMPI.php
URLRetour
Format : jusqu’à 250 caractères.
URL de retour depuis le navigateur du client. Si l’URL n’est pas présente, PAYBOX utilisera celle paramétrée sur la fiche site du commerce (équivalent à PBX_EFFECTUE).
Variables réponses Paybox Remote MPI
IdSession
Format : jusqu’à 250 caractères.
Identifiant unique de la requête permettant d’éviter les confusions au niveau des réponses en cas de questions multiples et simultanées.
Chaque appel doit avoir un numéro de question unique pour un commerçant donné.
Exemple : Session001
StatusPBX
Format : Alphanumérique.
Statut de la demande d’authentification (voir la liste des valeurs possibles dans le tableau ci-après). Il conditionne l’appel en autorisation effectué via le produit PAYBOX Direct.
STATUSPBX | DESCRIPTION |
Erreur Paybox | Envoyé dans le cas d’un incident propre aux traitements PAYBOX. L’authentification du porteur a échoué et la demande d’autorisation n’est pas à effectuer. Il faut recommencer la demande d’authentification. |
Autorisation à faire | Envoyé après la procédure d’authentification indiquant que le paiement pourra être réalisé après une demande d’autorisation. |
Autorisation à ne pas faire | Envoyé après la procédure d’authentification indiquant que le paiement ne pourra pas être réalisé avec succès et qu’une demande d’autorisation n’est pas à effectuer car l’authentification du porteur a échoué. |
Timeout | Envoyé lorsqu’il n’y a pas eu de retour du porteur après la demande d’authentification au-delà de 5 minutes. |
ID3D
Format : jusqu’à 20 chiffres.
Identifiant de contexte PAYBOX contentant les données d’authentification retournées par le MPI.
Ce contexte d’authentification est stocké pendant une durée de 5 minutes.
Au-delà, les applications de PAYBOX considèreront que la phase d’authentification du porteur est non valide car en timeout.
Exemple : 9900000000012
Check
Format : jusqu’à 256 caractères.
Signature électronique de PAYBOX sur l’ensemble des données passées en paramètre
3DCAVV
Format : 28 caractères.
Valeur reçue des ACS. URL-encodé.
3DCAVVALGO
Format : jusqu’à 64 caractères
Identifiant de l’algorithme ayant servi à l’identification du porteur sur l’ACS
Exemple : 0000000001
3DECI
Format : 2 chiffres
E-Commerce Indicator. Permet de connaitre le niveau de sécurisation de la transaction.
3DENROLLED
Format : 1 caractère
État sur l’enrôlement du Porteur au programme 3DS
Valeurs possibles :
- Y : Carte/Porteur enrôlée
- N : Carte/Porteur non enrôlée
- U : Erreur
3DERROR
Format : jusqu’à 6 caractères
Numéro d’erreur renvoyé nativement par le MPI.
3DSIGNVAL
Format : 1 caractère.
Généré par le MPI, il indique le statut de la vérification de la signature du porteur (Y, N)
Valeurs possibles : Y ou N
3DSTATUS
Format : 1 caractère.
Statut de la demande d’authentification (Y, N, A, U)
Valeurs possibles :
- Y : Porteur authentifié
- N : Porteur non authentifié
- A : Forçage de l’authentification par l’émetteur
- U : Authentification n’a pas pu être réalisée pour raison technique
3DXID
Format : jusqu’à 28 caractères
Référence provenant du MPI
Exemple : 1111222233334444