Format V1

L'enregistrement « TITRE »

Pos. Description Valeurs
01 Code d'enregistrement TITRE
02 Nom de la boutique
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 : 3000 pour 30,00 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é.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 00000645948

11 UNPAID_CODE

Description : Code motif de l'impayé.

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

Ex : 978 pour l'euro (EUR) (Voir tableau vads_currency en annexes)

13 CONTRACT_TYPE

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, AMEX, PPRO, .
  • 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 AMEXGLOBAL.

Ex : 12345678

15 REMITTANCE_DATE

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 AMEXGLOBAL.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 3000 pour 30,00 EUR

17 VALUE_DATE

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é.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 3000 pour 30,00 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 AMEXGLOBAL.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 3000 pour 30,00 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 AMEXGLOBAL.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 978 pour l'euro (EUR) (Voir tableau vads_currency en annexes)

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

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

Description : Statut de rapprochement de l'impayé.

Valeurs :
  • MATCH_OK : Rapprochement effectué
  • MATCH_ANALYSE : A analyser

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

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.

Ex : C2383333540

28 ORDER_ID

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

Description : Statut de la transaction.

Équivalent API Formulaire : vads_trans_status

Équivalent API REST : detailedStatus

Valeurs :
  • REFUSED : Transaction refusée
  • TO_VALIDATE : Transaction à valider
  • TO_CAPTURE : Transaction en attente de remise
  • TO_CREDIT : Transaction de crédit (remboursement) en attente de remise
  • CANCELLED : Transaction annulée
  • CAPTURED : Transaction remisée
  • EXPIRED : Transaction expirée
  • TO_VALIDATE_AND_AUTHORIZE : Transaction à valider et autoriser
  • TO_AUTHORIZE : Transaction en attente de demande d’autorisation
  • TO_PRENOTIFY : Transaction en attente de pré-notification
  • ACCEPTED : Transaction de vérification acceptée
  • REFUSED_CAPTURED : La remise de la transaction a échoué

Ex : 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 : 3000 pour 30,00 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 : 3000 pour 30,00 EUR

33 CARD_TYPE

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.
34 CHARGED_CARD_TYPE

Description : Type impayé.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Valeur : toujours vide.

35 UNPAID_SETTLE_DATE

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 AMEXGLOBAL.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 20200114

36 UNPAID_DOC_REASON

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 AMEXGLOBAL.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex :

37 UNPAID_DOC_DATE

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 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://lyra.com/doc/files/samples/sample-files.zip.

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