• France
état des services
démonstrations
assistance
FAQContacter le support
Video tutorials
Rechercher
Catégories
Tags
Français
Français
Anglais
Accueil
Cas d'usage
Créer un paiement
Créer un paiement en plusieurs fois
Proposer un paiement complémentaire
Créer un paiement par alias (token)
Créer un lien de paiement
Créer un paiement à l'expédition
Créer un abonnement
Gérer vos abonnements
Gérer vos transactions (rembourser,...)
Analyser vos journaux
Docs API
Formulaire embarqué
API REST
Formulaire en redirection
Intégration mobile
Échange de fichiers
Exemples de code
Moyens de paiement
Modules de paiement
Guides
Back Office Marchand
Guides fonctionnels

Fichier de requête V4 (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 04
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

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 :
  • 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 : 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 45,25 EUR

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 : 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 : 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 :
  • 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 : 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

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;04;12345678;TEST;20200603;102008;
02;1;20200603;102008;600001;CD;93599;978;20200604;0;59ecb199110145338c5704505760ec31;;CX-1254;;;
02;2;20200603;102008;600002;CD;7590;978;;0;3d62ec7ce4b249ffb53aa105419aae82;1999888;CX-1255;;;
02;3;20200603;102008;600002;CD;12300;858;;0;;1234567890;CX-1256;;;
01;3
© 2025 Tous droits réservés à Scellius
25.18-1.11