Fichier de requête V5 (déprécié)
Enregistrement d'en-tête
| Pos. | Description | Valeurs |
|---|---|---|
| 01 | Code d'enregistrement | 00 |
| 02 | Type de fichier | PAY |
| 03 | Version du fichier | 05 |
| 04 | Identifiant de la boutique | 12345678 |
| 05 | Mode (TEST ou PRODUCTION) | TEST |
| 06 | Date de création | Au format AAAAMMJJ |
| 07 | Heure de création | Au format HHMMSS |
| 08 | Réservé à usage futur. | Ne pas renseigner |
Enregistrement de détail
Le nombre d'enregistrements présents dans le fichier influe directement sur le temps de traitement du fichier ainsi que sur la mise à disposition du fichier de retour. Au-delà de 2000 enregistrements, il est recommandé de générer plusieurs fichiers de paiement.
| Pos. | Description |
|---|---|
| 01 | Description : Code d'enregistrement. Type : Numérique | Longueur : 2 | Obligatoire Valeur : 02 |
| 02 | Description : Numéro de séquence de
l'enregistrement de détail dans le fichier. Type : Numérique | Longueur : 6 | Obligatoire Ex :
|
| 03 | Description : Date de la transaction au format
AAAAMMJJ. Type : Numérique | Longueur : 8 | Obligatoire Ex : 20200603 |
| 04 | Description : Heure de la transaction au format
HHMMSS. Type : Numérique | Longueur : 6 | Obligatoire Ex : 120615 |
| 05 | Description : Identifiant de transaction unique pour chaque
transaction pour une boutique donnée sur la journée. L'unicité de l'identifiant de transaction se base sur l'heure universelle (UTC). Il est à la charge du site marchand de garantir cette unicité sur la journée. Type : Alphanumérique | Longueur : 6 | Obligatoire Équivalent API Formulaire : vads_trans_id Équivalent API REST : N/A Ex : 000001 |
| 06 | Description : Type de transaction. Type : String | Longueur : 2 | Obligatoire Valeur : CD |
| 07 | Description : Montant de la transaction exprimé
dans la plus petite unité de la devise. Type : Numérique | Longueur : 12 | Obligatoire Équivalent API Formulaire : vads_amount Équivalent API REST : amount Ex : 4525 pour 4525 XPF |
| 08 | Description : Code numérique de la devise du
paiement (norme ISO 4217). Type : Numérique | Longueur : 3 | Obligatoire |Équivalent API Formulaire : vads_currency Équivalent API REST : currency Ex : 953 pour le Franc CFP (XPF) (Voir chapitreListe des devises supportées en annexes) |
| 09 | Description : Date de remise demandée au format AAAAMMJJ. Laissez à
vide pour indiquer la date du jour. Type : Numérique | Longueur : 8 | Facultatif Équivalent API Formulaire : N/A Équivalent API REST : N/A Ex : 20200603 |
| 10 | Description : Mode de validation. Consultez le
manuel utilisateur Gestion des
transactions pour plus d'informations. Type : Numérique | Longueur : 1 | Facultatif Équivalent API Formulaire : vads_validation_mode Équivalent API REST : cardOptions.manualValidation Valeurs possibles :
Ex : 0 |
| 11 | Description : Alias ou Référence Unique du Mandat à
débiter. Type : String | Longueur : 50 | Obligatoire Équivalent API Formulaire : vads_identifier Équivalent API REST : paymentMethodToken Ex : 59ecb199110145338c5704505760ec31 |
| 12 | Description : Numéro de contrat à utiliser.
Ce paramètre est facultatif et n'est utile que dans le cas où vous avez plusieurs contrats sur le même réseau et si vous souhaitez en changer dynamiquement en fonction du paiement. Laisser à vide pour utiliser le contrat par défaut. Type : String | Longueur : 128 | Facultatif Équivalent API Formulaire : vads_contracts Équivalent API REST : cardOptions.mid Ex : 1234567 |
| 13 | Description : Référence de commande. Type : String | Longueur : 32 | Facultatif Le seul caractère spécial accepté est le tiret "-". Équivalent API Formulaire : vads_order_id Équivalent API REST : orderId Ex : CX-1254 |
| 14 | Description : Informations sur la commande 1.
La donnée sera ensuite visible dans le détail de la transaction
(onglet Extra) et peut être ajoutée par le marchand dans les
e-mails de confirmation de paiement (marchand et acheteur). Type : String | Longueur : 255 | Facultatif Équivalent API Formulaire : vads_order_info Équivalent API REST : metadata.orderInfo Ex : Code interphone 3125 |
| 15 | Description : Informations sur la commande 2. La donnée sera ensuite
visible dans le détail de la transaction (onglet Extra) et
peut être ajoutée par le marchand dans les e-mails de confirmation
de paiement (marchand et acheteur). Type : String | Longueur : 255 | Facultatif Équivalent API Formulaire : vads_order_info2 Équivalent API REST : metadata.orderInfo2 Ex : Sans ascenseur |
| 16 | Description : Informations sur la commande 3.
La donnée sera ensuite visible dans le détail de la transaction
(onglet Extra) et peut être ajoutée par le marchand dans les
e-mails de confirmation de paiement (marchand et acheteur). Type : String | Longueur : 255 | Facultatif Équivalent API Formulaire : vads_order_info3 Équivalent API REST : metadata.orderInfo3 Ex : Express |
| 17 | Description : Permet de qualifier les
transactions comme récurrentes (RecurringType). Champ réservé aux paiements récurrents
via l'acquéreur FISERV (First Data) en Amérique Latine. Peut être
envoyé à vide. Type : String | Longueur : 255 | Facultatif Valeurs possibles :
Équivalent API Formulaire : N/A Équivalent API REST : N/A Ex : FIRST |
| 18 | Description : Numéro de contrat signé par
l'acheteur (PONumber).
Champ réservé aux paiements récurrents au Mexique. Peut être envoyé
à vide. Type : String | Longueur : 64 | Facultatif Équivalent API Formulaire : N/A Équivalent API REST : N/A Ex : 12345 |
Enregistrement de fin
| Pos. | Description | Valeurs |
|---|---|---|
| 01 | Code d'enregistrement | 01 |
| 02 | Nombre d’enregistrements détail transmis. Il est conseillé de ne pas dépasser 2000 enregistrements par fichier. | Ex: 3 |
Exemple de fichier
Nom du fichier : 20200603.12345678.PAY.REQ.T.01
00;PAY;05;12345678;TEST;20200603;102008; 02;1;20200603;102008;600001;CD;1199;953;20200604;0;59ecb199110145338c5704505760ec31;;CX-1254;;;;; 02;2;20200603;102008;600002;CD;7590;953;;0;3d62ec7ce4b249ffb53aa105419aae82;1999888;CX-1255;;;;; 02;3;20200603;102008;600002;CD;1230;840;;0;;1234567890;CX-1256;info1;info2;info3;; 01;3