• 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

Format V1

L'enregistrement « TITRE »

Pos. Description Valeurs
01 Code d'enregistrement TITRE
02 Raison sociale de la société visible dans le Back Office Marchand. Ex : BOUTIQUE DE DEMO
03 Date de l'envoi (AA/MM/JJ) 20/01/14
04 Version V1
05 Description du fichier LES IMPAYÉS RAPPROCHÉS DU JOUR

Les enregistrements « ENTETE » et « DETAILS »

Pos. Description
01 ENTETE

Type : VARCHAR | Longueur : 6

Description : Code d'enregistrement.

Valeur : DETAIL

02 MERCHANT_COUNTRY

Type : VARCHAR | Longueur : 2

Description : Code pays de la société (norme ISO 3166-1 alpha-2).

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : FR pour la France.

03 MERCHANT_ID

Type : VARCHAR | Longueur : 255

Description : Identifiant légal de la société.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Valeurs :

0+Identifiant légal

(Identifiant légal = SIRET (Système d'Identification du Répertoire des Etablissements))

Ex : 045251785700028

04 CONTRACT

Type : VARCHAR | Longueur : 255

Description : Numéro de contrat du marchand.

Équivalent API Formulaire : vads_contract_used

Équivalent API REST : transactionDetails.mid

Ex : 0535875

05 PAYMENT_DATE

Type : DATE | Longueur : 8

Description : Date et heure du paiement.

Équivalent API Formulaire : vads_effective_creation_date

Équivalent API REST : creationDate

Ex : 20200107

06 TRANSACTION_ID

Type : VARCHAR | Longueur : 6

Description : Identifiant de la transaction.

Équivalent API Formulaire : vads_trans_id

Équivalent API REST : cardDetails.legacyTransId

Ex : xrT15p

07 OPERATION_TYPE

Type : VARCHAR | Longueur : 1

Description : Type d’opération.

Équivalent API Formulaire : vads_operation_type

Équivalent API REST : operationType

Valeurs :
  • D : Débit (Facture d'achat)
  • C : Crédit (Facture de crédit)

Ex : D

08 SOURCE_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant brut de la facture.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 4525 pour 45,25 EUR

09 SIRET

Type : VARCHAR | Longueur : 255

Description : Identifiant légal de la société.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Valeur :

SIRET (Système d'Identification du Répertoire des Etablissements)

Ex : 045251785700028

10 UNPAID_NB

Type : NUMERIC | Longueur : 11

Description : Numéro de dossier impayé.

Toujours vide pour les transactions réalisées sur le réseau GATECONEX.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 00000645948

11 UNPAID_CODE

Type : VARCHAR | Longueur : 255

Description : Code motif de l'impayé.

Toujours vide pour les transactions réalisées sur le réseau GATECONEX.

Toujours valorisé à 45 pour les transactions réalisées sur le réseau CB.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 45 (Voir Tableau des motifs d'impayés

12 CURRENCY_CODE

Type : NUMERIC | Longueur : 3

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

Équivalent API Formulaire : vads_currency

Équivalent API REST : currency

Valeurs : Liste des devises supportées

Ex : 978 pour l'euro (EUR)

13 CONTRACT_TYPE

Type : VARCHAR | Longueur : 1

Description : Type de contrat.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Valeurs :
  • 3 : paiement réalisé sur un des réseaux suivants: CB,SEPA,AMEX,GATECONEX.
  • vide : paiement réalisé sur le réseau PAYPAL

Ex : 3

14 POS_NB

Type : NUMERIC | Longueur : 8

Description : Numéro du point de vente.

Équivalent API Formulaire : vads_site_id

Équivalent API REST : shopId

Toujours vide pour les transactions réalisées sur le réseau GATECONEX.

Toujours vide pour les transactions réalisées sur le réseau AMEXGLOBAL.

Ex : 12345678

15 REMITTANCE_DATE

Type : DATE | Longueur : 8

Description : Date de la remise.

Équivalent API Formulaire : N/A

Équivalent API REST : transactionDetails.cardDetails.captureResponse.captureDate

Ex : 20200107

16 EXCHANGE_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant de la facture en contre-valeur. Champ vide si non fourni par l'acquéreur.

Toujours vide pour les transactions PayPal.

Toujours vide pour les transactions réalisées sur le réseau GATECONEX.

Toujours vide pour les transactions réalisées sur le réseau AMEXGLOBAL.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 4525 pour 45,25 EUR

17 VALUE_DATE

Type : DATE | Longueur : 8

Description : Date de valeur. Champ vide si non fourni par l'acquéreur.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 20200114

18 UNPAID_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant de l'impayé.

Toujours vide pour les transactions réalisées sur le réseau GATECONEX.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 4525 pour 45,25 EUR

19 EXCHANGE_UNPAID_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant de l'impayé en contre-valeur. Champ vide si non fourni par l'acquéreur.

Toujours vide pour les transactions PayPal.

Toujours vide pour les transactions réalisées sur le réseau GATECONEX.

Toujours vide pour les transactions réalisées sur le réseau AMEXGLOBAL.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 4525 pour 45,25 EUR

20 EXCHANGE_CURRENCY_CODE

Type : NUMERIC | Longueur : 3

Description : Code numérique de la devise de contre-valeur (norme ISO 4217). Champ vide si non fourni par l'acquéreur.

Toujours vide pour les transactions PayPal.

Toujours vide pour les transactions réalisées sur le réseau GATECONEX.

Toujours vide pour les transactions réalisées sur le réseau AMEXGLOBAL.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

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

21 CHARGED_BANK_CODE

Type : NUMERIC | Longueur : 5

Description : Code banque à imputer. Champ vide si non fourni par l'acquéreur.

Toujours vide pour les transactions PayPal.

Toujours vide pour les transactions réalisées sur le réseau GATECONEX.

Toujours vide pour les transactions réalisées sur le réseau AMEXGLOBAL.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 14707

22 CHARGED_COUNTER

Type : NUMERIC | Longueur : 5

Description : Code guichet d'origine. Champ vide si non fourni par l'acquéreur.

Toujours vide pour les transactions PayPal.

Toujours vide pour les transactions réalisées sur le réseau AMEXGLOBAL.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 00070

23 CHARGED_ACCOUNT

Type : VARCHAR | Longueur : 255

Description : Numéro de compte. Champ vide si non fourni par l'acquéreur.

Toujours vide pour les transactions PayPal.

Toujours vide pour les transactions réalisées sur le réseau GATECONEX.

Toujours vide pour les transactions réalisées sur le réseau AMEXGLOBAL.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 01234567890

24 CHARGED_ADMIN_ACCOUNT

Type : NUMERIC | Longueur : 5

Description : Guichet du gestionnaire. Champ vide si non fourni par l'acquéreur.

Toujours vide pour les transactions PayPal.

Toujours vide pour les transactions réalisées sur le réseau GATECONEX.

Toujours vide pour les transactions réalisées sur le réseau AMEXGLOBAL.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 00070

25 PBA_REMIT_NB

Type : NUMERIC | Longueur : 6

Description : Numéro de remise PBA. Champ vide si non fourni par l'acquéreur.

Toujours vide pour les transactions PayPal.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 123456

26 MATCH_STATUS

Type : VARCHAR | Longueur : 255

Description : Statut de rapprochement de l'impayé.

Valeurs :
  • MATCH_OK : Rapprochement effectué
  • MATCH_ANALYSE : A analyser
  • R_CHARGEBACK : Impayé SEPA

Toujours valorisé à MATCH_OK pour les transactions réalisées sur le réseau AMEXGLOBAL.

Toujours valorisé à MATCH_OK pour les transactions réalisées sur le réseau PAYPAL.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : MATCH_OK

27 CUSTOMER_ID

Type : VARCHAR | Longueur : 255

Description : Référence client générée par le site marchand.

Équivalent API Formulaire : vads_cust_id

Équivalent API REST : customer.reference

Toujours vide pour les transactions PayPal.

Toujours vide pour les transactions réalisées sur le réseau GATECONEX.

Ex : C2383333540

28 ORDER_ID

Type : VARCHAR | Longueur : 255

Description : Numéro de commande générée par le site marchand.

Équivalent API Formulaire : vads_order_id

Équivalent API REST : orderDetails.orderId

Ex : CX-1254

29 RETURN_CONTEXT

Type : VARCHAR | Longueur : 500

Description : Contexte de la commande d’un acheteur.

Concaténation des "informations complémentaires", séparées par le caractère "|".

Les informations complémentaires peuvent être transmises par le site marchand :

  • via les champs vads_order_info, vads_order_info2, vads_order_info3 du formulaire de paiement,
  • via les attributs orderInfo, orderInfo2, orderInfo3 de l'objet metadata de l'API REST.

Au-delà de 500 caractères, la chaîne est tronquée.

Champ vide si aucune information complémentaire n'est transmise.

Toujours vide pour les transactions PayPal.

Toujours vide pour les transactions réalisées sur le réseau GATECONEX.

Toujours vide pour les transactions réalisées sur le réseau AMEXGLOBAL.

Équivalent API Formulaire : vads_order_info | vads_order_info2 | vads_order_info3

Équivalent API REST : orderInfo | orderInfo2 | orderInfo3

Ex :
  • info1|info2|info3 si les 3 informations complémentaires sont transmises,
  • info1||info3: si seules les informations complémentaires 1 et 3 sont transmises.
30 TRANSACTION_STATUS

Type : VARCHAR | Longueur : 255

Description : Statut de la transaction.

Équivalent API Formulaire : vads_trans_status

Équivalent API REST : detailedStatus

Valeur : Toujours valorisé à CAPTURED

31 CURRENT_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant actuel de la transaction. Correspond au montant capturé moins le montant remboursé ou en attente de remboursement.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 4525 pour 45,25 EUR

32 ORIGIN_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant d'origine de la transaction

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 4525 pour 45,25 EUR

33 CARD_TYPE

Type : VARCHAR | Longueur : 255

Description : Type de carte.

Équivalent API Formulaire : vads_card_brand

Équivalent API REST : transactionDetails.cardDetails.effectiveBrand

Ex :
  • CB : Paiement par carte CB.
  • AMEX : Paiement par carte American Express.
  • PAYPAL : Paiement via un compte PayPal.
  • SDD : Paiement par prélèvement SEPA.
34 CHARGED_CARD_TYPE

Type : VARCHAR | Longueur : 0

Description : Type impayé.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Valeur : toujours vide.

35 UNPAID_SETTLE_DATE

Type : DATE | Longueur : 8

Description : Date de compensation de l'impayé. Champ vide si non fourni par l'acquéreur.

Toujours vide pour les transactions PayPal.

Toujours vide pour les transactions réalisées sur le réseau GATECONEX.

Toujours vide pour les transactions réalisées sur le réseau AMEXGLOBAL.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 20200114

36 UNPAID_DOC_REASON

Type : VARCHAR | Longueur : 255

Description : Motif de demande de document. Champ vide si non fourni par l'acquéreur.

Toujours vide pour les transactions PayPal.

Toujours vide pour les transactions réalisées sur le réseau GATECONEX.

Toujours vide pour les transactions réalisées sur le réseau AMEXGLOBAL.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex :

37 UNPAID_DOC_DATE

Type : DATE | Longueur : 8

Description : Date de demande de documentation initiale. Champ vide si non fourni par l'acquéreur.

Toujours vide pour les transactions PayPal.

Toujours vide pour les transactions réalisées sur le réseau GATECONEX.

Toujours vide pour les transactions réalisées sur le réseau AMEXGLOBAL.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 20200114

L'enregistrement « FIN »

Pos. Description Valeurs
01 Code d'enregistrement FIN

Exemple de fichier

Téléchargez le pack d'exemples : https://scelliuspaiement.labanquepostale.fr/doc/files/samples/sample-files.zip.

Vous trouverez un fichier d'exemple dans le dossier Reporting/JRI.

© 2025 Tous droits réservés à Scellius
25.18-1.11