Format V1

L'enregistrement « TITRE »

L'enregistrement TITRE renseigne sur les caractéristiques du fichier pour permettre une meilleure identification. Il est valorisé comme suit :

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 »

La ligne ENTETE liste les différents libellés à valoriser dans le journal. Les données de la ligne DETAILS valorisent, pour chaque transaction, les libéllés de l'enregistrement ENTETE.

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

Equivalent API Formulaire: N/A

Equivalent API REST: N/A

Ex: FR pour la France.

03 MERCHANT_ID

Type: VARCHAR | Longueur: 255

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

Equivalent API Formulaire: N/A

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

Equivalent API Formulaire: vads_contract_used

Equivalent API REST: transactionDetails.mid

Ex: 0535875

05 PAYMENT_DATE

Type: DATE | Longueur: 8

Description: Date et heure du paiement.

Equivalent API Formulaire: vads_effective_creation_date

Equivalent API REST: creationDate

Ex: 20200107

06 TRANSACTION_ID

Type: VARCHAR | Longueur: 6

Description: Identifiant de la transaction.

Equivalent API Formulaire: vads_trans_id

Equivalent API REST: cardDetails.legacyTransId

Ex: xrT15p

07 OPERATION_TYPE

Type: VARCHAR | Longueur: 1

Description: Type d’opération.

Equivalent API Formulaire: vads_operation_type

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

Equivalent API Formulaire: N/A

Equivalent API REST: N/A

Ex : 3000 pour 30,00 EUR

09 SIRET

Type: VARCHAR | Longueur: 255

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

Equivalent API Formulaire: N/A

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

Equivalent API Formulaire: N/A

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

Equivalent API Formulaire: N/A

Equivalent 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).

Equivalent API Formulaire: vads_currency

Equivalent API REST: currency

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

13 CONTRACT_TYPE

Description: Type de contrat.

Equivalent API Formulaire: N/A

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

Equivalent API Formulaire: vads_site_id

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

Equivalent API Formulaire: N/A

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

Equivalent API Formulaire: N/A

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

Equivalent API Formulaire: N/A

Equivalent API REST: N/A

Ex: 20200114

18 UNPAID_AMOUNT

Type: NUMERIC | Longueur: 13

Description: Montant de l'impayé.

Equivalent API Formulaire: N/A

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

Equivalent API Formulaire: N/A

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

Equivalent API Formulaire: N/A

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

Equivalent API Formulaire: N/A

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

Equivalent API Formulaire: N/A

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

Equivalent API Formulaire: N/A

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

Equivalent API Formulaire: N/A

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

Equivalent API Formulaire: N/A

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

Equivalent API Formulaire: N/A

Equivalent API REST: N/A

Ex: MATCH_OK

27 CUSTOMER_ID

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

Equivalent API Formulaire: vads_cust_id

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

Equivalent API Formulaire: vads_order_id

Equivalent API REST: orderDetails.orderId

Ex: CX-1254

29 RETURN_CONTEXT

Description: Contexte de la commande d’un acheteur.

Concaténation des valeurs des champs vads_order_info, vads_order_info2, vads_order_info3 du formulaire de paiement, séparées par le caractère "|". Au-delà de 500 caractères, la chaine est tronquée. Champ vide si aucun champ vads_order_info n'est transmis.

Toujours vide pour les transactions PayPal.

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

Equivalent API Formulaire: vads_order_info | vads_order_info2 | vads_order_info3

Equivalent API REST: N/A

Ex:
  • info1|info2|info3 si les 3 champs sont transmis,
  • info1||info3: si seuls vads_order_info 1 et 3 sont transmis.
30 TRANSACTION_STATUS

Description: Statut de la transaction.

Equivalent API Formulaire: vads_trans_status

Equivalent API REST: detailedStatus

Valeurs: Voir chapitre vads_trans_status

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.

Equivalent API Formulaire: N/A

Equivalent API REST: N/A

Ex : 3000 pour 30,00 EUR

32 ORIGIN_AMOUNT

Type: NUMERIC | Longueur: 13

Description: Montant d'origine de la transaction

Equivalent API Formulaire: N/A

Equivalent API REST: N/A

Ex : 3000 pour 30,00 EUR

33 CARD_TYPE

Description: Type de carte.

Equivalent API Formulaire: vads_card_brand

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

Equivalent API Formulaire: N/A

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

Equivalent API Formulaire: N/A

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

Equivalent API Formulaire: N/A

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

Equivalent API Formulaire: N/A

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