Fichier de requête V6

Enregistrement d'en-tête

Pos. Description Valeurs
01 Code d'enregistrement 00
02 Type de fichier PAY
03 Version du fichier 06
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 Date d'exécution demandée.

Réservé à usage futur.

Ne pas renseigner

Enregistrement de détail

IMPORTANT

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 conseillé de générer plusieurs fichiers de paiement.

Pos. Description
01 Description : Code d'enregistrement.

Type : NUMERIC | Longueur : 2

Valeur : 02
02 Description : Numéro de séquence de l'enregistrement de détail dans le fichier.

Type : NUMERIC | Longueur : 6

Ex :
  • 1 pour la première ligne d'enregistrement de détail.
  • 2 pour la deuxième ligne d'enregistrement de détail.
03 Description : Date de la transaction au format AAAAMMJJ.

Type : NUMERIC | Longueur : 8

Ex : 20200603
04 Description : Heure de la transaction au format HHMMSS.

Type : NUMERIC | Longueur : 6

Ex : 120615
05 Description : Identifiant de transaction.

Type : NUMERIC | Longueur : 6

Équivalent API Formulaire : vads_trans_id

Équivalent API REST : N/A

Ex : 000001
06 Description : Type de transaction.

Type : VARCHAR | Longueur : 2

Valeur : CD
07 Description : Montant de la transaction exprimé dans la plus petite unité de la devise.

Type : NUMERIC | Longueur : 13

Équivalent API Formulaire : vads_amount

Équivalent API REST : amount

Ex : 4525 pour 45,25 EUR

08 Description : Code numérique de la devise du paiement (norme ISO 4217).

Type : NUMERIC | Longueur : 3

Équivalent API Formulaire : vads_currency

Équivalent API REST : currency

Ex : 978 pour l'euro (EUR) (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 : NUMERIC | Longueur : 8

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 20200603
10 Description : Mode de validation.

Type : NUMERIC | Longueur : 1

Équivalent API Formulaire : vads_validation_mode

Équivalent API REST : cardOptions.manualValidation

Valeurs possibles :
  • 0: pour validation automatique
  • 1: pour validation manuelle
  • Vide: pour utiliser le mode de validation configuré par défaut.

Ex : 0
11 Description : Alias ou Référence Unique du Mandat à débiter.

Type : VARCHAR | Longueur : 50

Équivalent API Formulaire : vads_identifier

Équivalent API REST : paymentMethodToken

Ex : 59ecb199110145338c5704505760ec31
12 Description : Numéro de contrat à utiliser. Laisser à vide pour utiliser le contrat par défaut.

Type : VARCHAR | Longueur : 128

Équivalent API Formulaire : vads_contracts

Équivalent API REST : cardOptions.mid

Ex : 1234567
13 Description : Référence de commande.

Type : VARCHAR | Longueur : 32

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.

Type : VARCHAR | Longueur : 255

Équivalent API Formulaire : vads_order_info

Équivalent API REST : metadata.orderInfo

Ex : Code interphone 3125

15 Description : Informations sur la commande 2.

Type : VARCHAR | Longueur : 255

Équivalent API Formulaire : vads_order_info2

Équivalent API REST : metadata.orderInfo2

Ex : Sans ascenseur
16 Description : Informations sur la commande 3.

Type : VARCHAR | Longueur : 255

É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 : VARCHAR | Longueur : 255

Valeurs possibles :
  • FIRST : premier paiement d'une série.
  • REPEAT: énième paiement d'une série.

É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 : VARCHAR | Longueur : 64

É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 : 20220303.12345678.PAY.REQ.T.01

00;PAY;06;12345678;TEST;20220303;102008;
02;1;20220303;102008;600001;CD;1199;978;20220304;0;59ecb199110145338c5704505760ec31;;CX-1254;;;;;
02;2;20220303;102008;600002;CD;7590;978;;0;3d62ec7ce4b249ffb53aa105419aae82;1999888;CX-1255;;;;;
02;3;20220303;102008;600002;CD;1230;840;;0;;1234567890;CX-1256;info1;info2;info3;;
01;3