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