• France
état des services
démonstrations
assistance
FAQContacter le support
Video tutorials
Rechercher
Catégories
Tags
docs.
France
Espagne
Europe (Anglais)
Inde
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 abonnement
Gérer vos abonnements
Gérer vos transactions (rembourser,...)
Analyser vos journaux
Docs API
Formulaire embarqué
API REST
Formulaire en redirection
SDK Mobile
Échange de fichiers
Mandats SEPA par API REST
Exemples de code
Moyens de paiement
Modules de paiement
Marketplace
Guides
Back Office Marchand
Back Office Expert
Guides fonctionnels

Format V1

L'enregistrement « TITRE »

L'enregistrement TITRE contient les données du virement. Il est valorisé comme suit :

Pos. Description
01 RECORD_CODE

Type : VARCHAR | Longueur : 5

Description : Code d'enregistrement.

Valeur : TITRE

02 RECORD_DATE

Type : TIMESTAMP | Longueur : 17

Description : Date et heure UTC de l'envoi au format ISO 8601.

Ex : 2020-01-15T16:53Z

03 Version

Type : VARCHAR | Longueur : 255

Description : Version du journal de réconciliation.

Ex : TABLE_JRFI_V1

04 ENTITY_CODE

Type : VARCHAR| Longueur : 255

Description : Code client Lyra Collect.

Ex : CLXXXXXX

05 ACTIVITY

Type : VARCHAR | Longueur : 255

Description : Le nom de la boutique en majuscule.

Les espaces éventuels sont remplacés par des "_"

Ex : DEMO_STORE

06 CURRENCY

Type : VARCHAR | Longueur : 3

Description : Code de la devise.

Valeur : EUR

07 WIRE_IBAN

Type : VARCHAR | Longueur : 255

Description : IBAN bénéficiaire du virement.

Ex : FR76XXXXXXXXXXXXXXXXXXX3739

08 WIRE_REFERENCE

Type : VARCHAR | Longueur : 255

Description : Référence du virement.

Ex : LYRA COLLECT 19100253200018

09 WIRE_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant du virement.

Ex : 4525 pour 45,25 EUR

10 WIRE_EXECUTION_DATE

Type : DATE | Longueur : 10

Description : Date du virement.

Ex : 2019-10-23

Les enregistrements « ENTETE » et « DETAILS »

Pos. Description
01 RECORD_CODE

Type : VARCHAR | Longueur : 6

Description : Code d'enregistrement.

Valeur : DETAIL

02 TYPE_OPERATION

Type : VARCHAR | Longueur : 255

Description : Libellé de l'opération.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Valeurs :
  • DEBIT : Paiement
  • REFUND : Remboursement
  • CHARGEBACK : Impayé
  • TRANSFERT_INT : Transfert interne entre un sous-marchand et un agent MarketPlace
  • OTHER_OPERATIONS : Autres opérations (contestation d'un impayé, remboursement d'un impayé etc..)

Ex : DEBIT

03 OPERATION_TYPE

Type : VARCHAR | Longueur : 2

Description : Code de l'opération.

Équivalent API Formulaire : vads_operation_type

Équivalent API REST : operationType

Valeurs :
  • DT : Débit
  • CT : Crédit

Ex : DT

04 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

05 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

Ex : C2383333540

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

07 ORIGIN_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant de la transaction au moment du paiement exprimé dans la plus petite unité de la devise.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 4525 pour 45,25 EUR

08 ORIGIN_CURRENCY_CODE

Type : VARCHAR | Longueur : 3

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

Équivalent API Formulaire : vads_currency

Équivalent API REST : currency

Ex : EUR

09 MERCHANT_ID

Type : VARCHAR | Longueur : 255

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

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Valeur :

0+Identifiant légal

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

Ex : 045251785700028

10 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

11 PAYMENT_DATE

Type : TIMESTAMP | Longueur : 17

Description : Date et heure du paiement (norme ISO 8601), dans le fuseau UTC.

Équivalent API Formulaire : vads_effective_creation_date

Équivalent API REST : creationDate

Ex : 2020-01-07T13:33+00Z

12 TRANSACTION_ID

Type : VARCHAR | Longueur : 255

Description : Identifiant de la transaction.

Équivalent API Formulaire : vads_trans_id

Équivalent API REST : cardDetails.legacyTransId

Ex : xrT15p

13 OPERATION_NUMBER

Type : VARCHAR | Longueur : 255

Description : Numéro de séquence de la transaction pour les paiements en plusieurs fois ou fractionnés.

Vide pour les paiements mono transaction.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 2

14 TRANSACTION_UUID

Type : VARCHAR | Longueur : 255

Description : Identifiant unique de la transaction.

Équivalent API Formulaire : vads_trans_uuid

Équivalent API REST : uuid

Ex : e078b7a6a01c494eae6afd52c4ea2bee

15 PAYMENT_METHOD

Type : VARCHAR | Longueur : 255

Description : Méthode de paiement.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex :
  • MANDATE : Paiement par prélèvement SEPA
  • CARD : Paiement par carte bancaire
  • ELECTRONIC_MONEY : Paiement par wallet (PayPal, Alipay, etc..)
  • CREDIT_TRANSFERT : Virement bancaire (Sofort, iDeal, ...)
16 CARD_SCHEME

Type : VARCHAR | Longueur : 1

Description : Réseau de la carte. Champ vide si non transmis par l'acquéreur.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Valeurs :
  • 1 : CB
  • 2 : VISA
  • 3 : MCI
  • 4 : ECI
  • 9 : Indeterminé (CB ou VISA)

Ex : 1

17 CARD_NATURE

Type : VARCHAR | Longueur : 1

Description : Nature de la carte. Champ vide si non fourni par l'acquéreur.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Valeurs :
  • P : Consumer Card
  • E : Commercial Card

Ex : P

18 CARD_PRODUCT_CATEGORY

Type : VARCHAR | Longueur : 1

Description : Catégorie du produit de la carte.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Valeurs :
  • C : CREDIT
  • D : DEBIT
  • P : PREPAID

Ex : D

19 CARD_HOLDER_COUNTRY_CODE

Type : VARCHAR | Longueur : 3

Description : Code pays (norme ISO 3166 alpha-3) de la carte. Champ vide si non fourni par l'acquéreur.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : FRA pour France

20 TRANSACTION_REGIONALITY

Type : VARCHAR | Longueur : 255

Description : Zone géographique du paiement. Champ vide si non fourni par l'acquéreur.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Valeurs :
  • FRA : Domestique
  • UE : Zone Euro
  • HUE : Hors zone Euro

Ex : FRA

21 REMITTANCE_DATE

Type : TIMESTAMP | Longueur : 17

Description : Date et heure (norme ISO 8601) de la remise dans le fuseau UTC.

Équivalent API Formulaire : N/A

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

Ex : 2020-01-07T23:05Z

22 REMITTANCE_NB

Type : VARCHAR | Longueur : 255

Description : Numéro de remise.

Équivalent API Formulaire : N/A

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

Ex : 22

23 CAPTURE_DATE

Type : TIMESTAMP | Longueur : 17

Description : Date et heure (norme ISO 8601) d'envoi en banque demandée.

Équivalent API Formulaire : vads_presentation_date

Équivalent API REST : transactionDetails.cardDetails.expectedCaptureDate

Ex : 2020-01-07T23:05Z

24 BRUT_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant brut de la transaction remisée (exprimé dans la plus petite unité de la devise).

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 4525 pour 45,25 EUR

25 NET_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant net (exprimé dans la plus petite unité de la devise) crédité sur le compte du marchand.

Renseigné uniquement lorsque le rapprochement est effectué automatiquement et si l'acquéreur transmet l'information.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 4525 pour 45,25 EUR

26 SETTLEMENT_CURRENCY

Type : VARCHAR | Longueur : 3

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

Équivalent API Formulaire : vads_currency

Équivalent API REST : currency

Ex : EUR

27 VALUE_DATE

Type : DATE | Longueur : 10

Description : Date de valeur au format YYYY-MM-DD.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 2020-01-14

28 COMMISSION_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant hors taxe de la commission acquéreur.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 4525 pour 45,25 EUR

29 INTERCHANGE_CHARGE_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant des frais d'interchange. Champ vide si non fourni par l'acquéreur.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 4525 pour 45,25 EUR

30 SCHEME_CHARGE_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant de la commission Réseau. Champ vide si non fourni par l'acquéreur.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 4525 pour 45,25 EUR

31 BANK_CHARGE_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant des charges acquéreur.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 4525 pour 45,25 EUR

32 WIRE_REFERENCE

Type : VARCHAR | Longueur : 255

Description : Référence du virement.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : LYRA_COLLECT_xxxxx

33 WIRE_IBAN

Type : VARCHAR | Longueur : 255

Description : IBAN bénéficiaire du virement.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : FR76XXXXXXXXXXXXXXXXXXX3739

34 WIRE_EXECUTION_DATE

Type : DATE | Longueur : 10

Description : Date d'exécution du virement au format YYYY-MM-DD.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 2020-01-16

35 ORIGINAL_TRANSACTION_UUID

Type : VARCHAR | Longueur : 255

Description : Identifiant unique de la transaction d'origine.

UUID de la transaction d'origine dans le cas d'un remboursement ou d'un impayé.

Équivalent API Formulaire : N/A

Équivalent API REST : transactionDetails.parentTransactionUuid

Ex : 31c1d62734ef479f87cfd30bef8c7e01

36 CHARGEBACK_REASON

Type : VARCHAR | Longueur : 255

Description : Motif de l'impayé.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

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

37 MKP_OPERATOR_SALES_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant des ventes de l'opérateur.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 4525 pour 45,25 EUR

38 MKP_OPERATOR_FEE_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant des commissions de l'opérateur.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 4525 pour 45,25 EUR

39 DATA_COMP_1

Type : NUMERIC (21,5) |Longueur : 5

Description : Montant HT de la commission calculée sur les transactions de débit et de remboursement, facturé en fin de mois.

40 DATA_COMP_2

Type : VARCHAR | Longueur : 255

Description : Référence externe du vendeur Marketplace pour les opérations de virement interne.

41 DATA_COMP_3

Type : VARCHAR | Longueur : 255

Description : Code de l'opération diverse.

42 DATA_COMP_4

Type : VARCHAR | Longueur : 255

Description : Justification de l'opération diverse.

43 DATA_COMP_5

Type : VARCHAR | Longueur : 255

Description : Numéro logique du système d'acceptation (NLSA).

44 DATA_COMP_6

Type : NUMERIC | Longueur : 13

Description : Identifiant du système d'acceptation (IDSA).

45 DATA_COMP_7

Type : NUMERIC | Longueur : 12

Description : Identifiant du Terminal de Paiement ( ITP).

46 DATA_COMP_8

Type : VARCHAR | Longueur : 255

Description : Réservé pour une utilisation future

47 DATA_COMP_9

Type : VARCHAR | Longueur : 255

Description : Réservé pour une utilisation future

48 DATA_COMP_10

Type : VARCHAR | Longueur : 255

Description : Réservé pour une utilisation future

49 DATA_COMP_11

Type : VARCHAR | Longueur : 255

Description : Réservé pour une utilisation future

50 DATA_COMP_12

Type : VARCHAR | Longueur : 255

Description : Réservé pour une utilisation future

51 DATA_COMP_13

Type : VARCHAR | Longueur : 255

Description : Réservé pour une utilisation future

52 DATA_COMP_14

Type : VARCHAR | Longueur : 255

Description : Réservé pour une utilisation future

53 DATA_COMP_15

Type : VARCHAR | Longueur : 255

Description : Réservé pour une utilisation future

54 DATA_COMP_16

Type : VARCHAR | Longueur : 255

Description : Réservé pour une utilisation future

55 DATA_COMP_17

Type : VARCHAR | Longueur : 255

Description : Réservé pour une utilisation future

56 DATA_COMP_18

Type : VARCHAR | Longueur : 255

Description : Réservé pour une utilisation future

57 DATA_COMP_19

Type : VARCHAR | Longueur : 255

Description : Réservé pour une utilisation future

58 DATA_COMP_20

Type : VARCHAR | Longueur : 255

Description : Réservé pour une utilisation future

L'enregistrement « FIN »

Indique le nombre de lignes d'enregistrement de DETAIL et précise les différents totaux qui permettent de justifier le montant du virement.

Pos. Description
01 RECORD_CODE

Type : VARCHAR | Longueur : 3

Description : Code enregistrement

Valeur : FIN

02

LINES_NUMBER

Type : VARCHAR | Longueur : 255

Description : Nombre de lignes d'enregistrement de détail.

Ex : 5

03 SALES_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant des ventes.

Ex : 4525 pour 45,25 EUR

04 CHARGEBACK_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant des impayés.

Ex : 4525 pour 45,25 EUR

05 REFUND_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant des remboursements.

Ex : 4525 pour 45,25 EUR
06 FEES_TTC_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant des commissions Lyra Collect TTC.

Ex : 4525 pour 45,25 EUR

07 FEES_HT_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant des commissions Lyra Collect HT.

Ex : 4525 pour 45,25 EUR

08 FEES_VAT_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant de la TVA des commissions Lyra Collect.

Ex : 4525 pour 45,25 EUR

09 LITIGATION_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant des litiges.

Ex : 4525 pour 45,25 EUR

10 HOLDBACK_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant des dépôts de garantie.

Ex : 4525 pour 45,25 EUR

11 MISC_OPERATIONS_AMOUNT

Type : NUMERIC | Longueur : 13

Montant des opérations diverses (remboursement d'impayé ou nouvelle imputation d'un impayé contesté).

Ex : 4525 pour 45,25 EUR

12 MKP_OPERATOR_SALES_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant des ventes en propre d'un opérateur (pour les agents MarketPlace).

Ex : 4525 pour 45,25 EUR

13 MKP_OPERATOR_FEE_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant des commissions d'un opérateur (pour les agents MarketPlace).

Ex : 4525 pour 45,25 EUR

Exemple de fichier

Téléchargez le pack d'exemples : https://docs.lyra.com/files/samples/sample-files-collect.zip.

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

Nous recrutons
Mentions légales
Charte de Protection des Données Personnelles
25.19-1.11