• 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 réponse V3 (déprécié)

Enregistrement d'en-tête

Pos. Description Format Valeurs
01 Code enregistrement n2 00
02 Type de fichier   PAY
03 Version de fichier n2 03
04 Code de retour de la première phase du traitement n1

0 : Traitement effectué

1 : Erreur de format

2 : Erreur de valorisation

05 Information sur l’erreur ans..255 Complément d’information sur l’erreur, vide en cas de succès.
06 Identifiant de boutique n8 Idem demande si valide.
07 Environnement   Idem demande si valide.
08 Date de création n8 Idem demande si valide.
09 Heure de création n6 Idem demande si valide.
10 Date de fin de traitement

Au format AAAAMMJJ

n8 20161130
11 Heure de fin de traitement n6 130019

Enregistrements de détail

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 la transaction.

Type : NUMERIC | Longueur : 6

Équivalent API Formulaire : vads_trans_id

Équivalent API REST : cardDetails.legacyTransId

Ex : 700001

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

É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 chapitre Liste des devises supportées en annexes)

09 Description : Montant de la transaction exprimé dans la plus petite unité de la devise utilisée pour effectuer la remise en banque.

Type : NUMERIC | Longueur : 12

Équivalent API Formulaire : vads_effective_amount

Équivalent API REST : transactions.transactionDetails.effectiveAmount

Ex : 4525 pour 45,25 EUR

10 Description : Code numérique de la devise dans laquelle la remise en banque va être effectuée (norme ISO 4217).

Type : NUMERIC | Longueur : 3

Équivalent API Formulaire : vads_effective_currency

Équivalent API REST : transactions.transactionDetails.effectiveCurrency

Ex : 978 pour l'euro (EUR) (Voir chapitre Liste des devises supportées en annexes)

11
Description :
  • Date et heure (au format AAAAMMJJ) dans le fuseau UTC de la remise demandée par le marchand pour un paiement par carte.
  • Date et heure (au format AAAAMMJJ) dans le fuseau UTC du transfert de fond pour un paiement SEPA.

Type : NUMERIC | Longueur : 8

Équivalent API Formulaire : vads_presentation_date

Équivalent API REST : transactionDetails.cardDetails.expectedCaptureDate

Ex : 20200604

12 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

Ex : 0

13 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

14 Description : Numéro de contrat utilisé pour traiter la demande.

Type : VARCHAR | Longueur : 255

Équivalent API Formulaire : vads_contract_used

Équivalent API REST : cardOptions.mid

Ex : 1234567

15 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

16 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

17 Description : Informations sur la commande 2.

Type : VARCHAR | Longueur : 255

Équivalent API Formulaire : vads_order_info2

Équivalent API REST : metadata.orderInfo2

Ex : Sans ascenseur

18 Description : Informations sur la commande 3.

Type : VARCHAR | Longueur : 255

Équivalent API Formulaire : vads_order_info3

Équivalent API REST : metadata.orderInfo3

Ex : Express

19 Description : Code retour du traitement.

Type : NUMERIC | Longueur : 2

Valeurs :
  • 00 : Succès du traitement – Paiement accepté
  • 05 : Succès du traitement – Paiement refusé
  • 30 : Erreur de paramètre
  • 96 : Erreur technique

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Un complément d’information est disponible dans le champ 25.

20 Description : Code renvoyé par la banque émettrice en réponse à la demande d'autorisation.

Type : NUMERIC | Longueur : 2

Équivalent API Formulaire : vads_auth_result

Équivalent API REST : transactionDetails.cardDetails.authorizationResponse.authorizationResult

Valeurs: Voir chapitre conref- Liste des codes retour autorisation en annexes.

Ex: 00

21 Description : Numéro d'autorisation de la transaction.

Type : VARCHAR | Longueur : 6

Équivalent API Formulaire : vads_auth_number

Équivalent API REST : transactionDetails.cardDetails.authorizationResponse.authorizationNumber

Ex: 3fc116

22 Description : Mode d’autorisation.

Type : VARCHAR | Longueur : 4

Valeurs :
  • FULL : Paiement autorisé.
  • MARK : Paiement en attente d'autorisation.
23

Description : Date d’autorisation au format AAAAMMJJ, exprimée dans le fuseau UTC.

Type: DATE | Longueur: 8

Équivalent API Formulaire : N/A

Équivalent API REST : transactionDetails.cardDetails.authorizationResponse.authorizationDate

Ex: 20200114

24

Description : Heure de la demande d'autorisation au format HHMMSS, exprimée dans le fuseau UTC.

Type : TIME | Longueur : 6

Équivalent API Formulaire : N/A

Équivalent API REST : transactionDetails.cardDetails.authorizationResponse.authorizationDate

Ex: 142512

25 Description : Code retour complémentaire

Type : NUMERIC | Longueur : 2

Description :
  • Résultat de la gestion des risques (spécifique aux boutiques ayant souscrit au module). Champ vide si aucun contrôle n'a été effectué.
  • Valorisé avec la position du champ erroné si le code retour de traitement (position 19) est valorisé à 30.
  • Valorisé avec un message d'erreur si le code retour du traitement (position 19) est valorisé à 96.

Équivalent API Formulaire : vads_extra_result

Équivalent API REST : N/A

Valeurs : Voir chapitre Traitement des erreurs.

Ex: 00

26 Description : Numéro du moyen de paiement.
  • Numéro du moyen de paiement (carte ou token réseau) masqué. Contient les 6 premiers chiffres du numéro, suivi par “XXXXXX” et enfin les 4 derniers numéros.
  • IBAN et BIC (s'il est renseigné) utilisés pour le paiement, séparés par un « _ » dans le cas d’un paiement par prélèvement.
    Le BIC est optionnel donc le numéro peut juste être l'IBAN.
  • Identifiant du compte PayPal

Type : VARCHAR | Longueur : 36

|

Équivalent API Formulaire : vads_card_number

Équivalent API REST : transactionDetails.cardDetails.pan

Ex: 497010XXXXXX0014

27 Description : Date d'expiration du moyen de paiement au format AAAAMMJJ.

Type : NUMERIC | Longueur : 8

Équivalent API Formulaire : vads_expiry_year + vads_expiry_month

Équivalent API REST : transactionDetails.cardDetails.expiryYear + transactionDetails.cardDetails.expiryMonth

Ex : 20211130

28 Description : Montant du crédit d'impôt accordé au marchand pour cette transaction. Le montant est exprimé dans la plus petite unité de la devise.

Le champ est vide si la donnée n'est pas retournée par l'acquéreur.

Type : NUMERIC | Longueur : 12

Équivalent API Formulaire : vads_tax_refund_amount

Équivalent API REST : transactionDetails.taxRefundAmount

Ex : 199

Enregistrement de fin

Pos. Description Format Valeurs
01 Code enregistrement n2 01
02 Nombre total d’enregistrements détail transmis n..6  
03 Nombre de paiements réussis n..6  
04 Nombre de paiements échoués n..6  
© 2025 Tous droits réservés à Scellius
25.18-1.11