Contenu
Fichier des opérations avec option réconciliation
Contenu des fichiers
Les fichiers comportent plusieurs types d'informations :
- Le contrat commerçant sur lequel vos transactions sont remisées
- Le détail des transactions autorisées et remisées,
- Un récapitulatif des opérations de débit et de crédit,
- Les transactions réconciliées, incluant les frais et les montants nets crédités sur votre compte
- Les transactions impayées ainsi que leurs montants.
Le fichier peut être généré pour tous les clients ayant souscrit à cette option, quel que soit le format de remise utilisé vis‑à‑vis de l’acquéreur :
- CB2A fichier
- AMEX
- FRFC
- autres
Le fichier de remise est généré à partir des données du système d’information Monext OnLine
Les données de réconciliation (commissions bancaires et impayés) sont générées à partir de deux fichiers bancaires :
- Le fichier « Relevé de compte »
- Le fichier des « Impayés »
A noter que le fichier image de remise qui sera envoyé à J contiendra les données de J-2.
Réconciliation
Après minuit, Monext Online transmet les opérations de type validation aux acquéreurs bancaires : fichier de remise.
Ensuite les acquéreurs confirment le traitement des opérations : réconciliation.
Monext Online vous transmet ensuite le fichier des paiements contenant les opérations remisées du J‑1 et les opérations réconciliées du J‑2.
Grâce à la réconciliation, vous pouvez identifier les opérations réellement créditées sur votre compte bancaire.
Format
Le format de génération du fichier est de type CSV en encodage ASCII.
Le nom du fichier aura le nommage suivant « Remise_enseigne_yyyymmdd ».
Un tel fichier peut être traité par des programmes, mais aussi manuellement. En effet, le format CSV peut être consulté par l'application Excel.
Vous avez le choix de la structure du fichier :
- Une ligne d’en‑tête, la liste des transactions remisées et une ligne d’en‑queue
- Le nom des colonnes et la liste des transactions remisées
Note : Le format XML est un format historique. Il reste pleinement supporté pour les clients existants mais n'évoluera plus. Ce format n'est pas proposé pour les nouvelles intégrations.
Fréquence et heure
Un fichier est généré chaque jour, même en l’absence de transactions. Le numéro de séquence fourni permet de garantir la séquence de ces fichiers.
Les fichiers peuvent être mis à disposition dans la matinée (à partir de 7h du matin)
Transfert de fichiers
Le fichier image de remise peut-être transmis au client par :
- Transfert de fichiers CFT, FTPS, SFTP via réseau IP (dans ce cas un lien doit être mis en place entre le client et Payline)
La diffusion par CFT, SFTP, FTPS est automatisée vers votre serveur.
Format des fichiers image de remise
Le format des fichiers image de remise est le CSV, il est très utile pour mettre à jour votre système d'information. Vous pouvez également consulter ce fichier directement dans Excel.
Règles générales du format
- Fichier de type ASCII
- Une ligne par transaction
- Chaque champ est séparé par un caractère « ; »
- La valeur des champs ne peut contenir « ; »
- Toutes les dates sont au format « YYYY/MM/DD HH:MI:SS.FFF » sauf précisé dans le tableau. Par exemple : « 2015/01/01 15:30:22.000 ».
- Les montants sont exprimés dans la plus petite unité de la devise
- Les codes devise sont exprimés sur 3 digits de la norme ISO 4217 (http://en.wikipedia.org/wiki/ISO_4217)
Structure du fichier CSV
La structure standard du fichier CSV est :
- une ligne d'entête : qui présente les noms des colonnes
- la liste des transactions remisées
En option, il est possible de générer le fichier CSV avec le format suivant :
- Une ligne d’en‑tête contenant des informations de synthèse
- La liste des transactions remisées
- Une ligne d'en-queue récapitulant le nombre total de transactions
Ligne d'entête
La ligne d'entête contient les données suivantes :
type;merchantname;merchantid;pointofsalename;paymentmethods;acquirername;contractnumber;contractdescription;currencycode;orderreference;orderdescription;transactionid;acquirertransaction;reference;transactiontypecode;capturefiledate;authorizationnumber;authorizationamount;authorizationcurrencycode;authorizationdate;authorizationorigin;cardnumber;liabilityshift;avs;capturedate;captureorigin;captureamount;acquirerfilenumber;operationtypecode;settledate;grossamount;feeamount;chargebackdate;chargebackamount;chargebackreason;chargebackdescription;chargebacknumber;rejectdate;rejectamount;rejectreason;rejectdescription;ifr;scheme
Cette ligne d’en‑tête vous permet d’identifier rapidement les informations essentielles liées aux transactions remisées et réconciliées.
En option, il est possible de générer une ligne d'entête qui aura le format ci-dessous. Cette version enrichie de l’en‑tête facilite le suivi, l’archivage et la vérification de la cohérence des fichiers reçus.
Nom de colonne | N° col | Type | Lg max | Format | Valeur ou description |
|---|---|---|---|---|---|
type | 1 | R | 6 | A | Type de ligne : HEADER |
name | 2 | R | 100 | AN | Nom du fichier |
date | 3 | R | 20 | AN | Horodatage local du fichier au format YYYY/MM/DD HH:MM:SS |
version | 4 | R | 10 | AN | Version du fichier. (Par exemple : 4.0.1) |
sequence | 5 | R | 6 | N | N° séquentiel du fichier incrémenté de 1 à chaque fichier |
Légende : R = requis, F = facultatif, C = conditionnel
Ligne des transactions
Chaque ligne du fichier CSV correspond à une transaction.
Les informations présentes dépendent du type de ligne (CAP, SET, CBK, REJ) et des options auxquelles vous avez souscrit.
Nom de colonne | N° col | Type | Lg max | Format | Option | Valeur ou description |
|---|---|---|---|---|---|---|
| type | 1 | R | 6 | A | Type de ligne : LIGNE si réconciliation non demandée, CAP, SET, CBK, REJ. | |
| merchantname | 2 | R | 100 | AN | Enseigne du commerçant. | |
| merchantid | 3 | R | 14 | N | Identifiant commerçant. | |
| pointofsalename | 4 | R | 50 | AN | Intitulé de l'enseigne. | |
| paymentmethods | 5 | R | 20 | AN | Code du moyen de paiement associé. | |
| acquirername | 6 | R | 30 | N | Nom de l'acquéreur du commerçant. | |
| contractnumber | 7 | R | 50 | AN | N° contrat commerçant accepteur. | |
| contractdescription | 8 | R | 30 | AN | Intitulé du contrat commerçant. | |
| currencycode | 9 | R | 3 | N | Devise principale. | |
| orderreference | 10 | R | 50 | AN | 1 | Référence de la commande. |
| orderdescription | 11 | F | 60 | AN | 1 | Description de la commande. |
| transactionid | 12 | R | 50 | AN | 1 | ID de la transaction. |
| acquirerTransactionReference | 13 | C | 12 | AN | 1 | Référence archivage généré à partir de la référence commande et respectant les contraintes de format de l'acquéreur. |
Champs valorisés uniquement si type=CAP ou LIGNE | ||||||
transactiontypecode | 14 | C | 1 | A | 1 | Code opération D pour débit ou C pour crédit (cette colonne est aussi utilisée pour le CBK). |
captureFileDate | 15 | C | 25 | AN | 1 | Date de la remise. |
| authorizationNumber | 16 | C | 6 | AN | 1 | N° autorisation. |
| authorizationAmount | 17 | C | 12 | N | 1 | Montant de l'autorisation. |
| authorizationCurrencyCode | 18 | C | 3 | N | 1 | Devise de l'autorisation. |
| authorizationDate | 19 | C | 25 | AN | 1 | Date de la transaction d'autorisation. |
| authorizationOrigin | 20 | C | 50 | AN | 1 | Origine de la transaction d'autorisation. |
| cardNumber | 21 | C | 19 | N | 1 | Numéro de carte masqué selon règles PCI/DSS. |
liabilityShift | 22 | C | 1 | N | 1 | Sécurisation par 3DSecure 0=non et 1=oui. |
| AVS | 23 | C | 1 | N | 1 | Sécurisation par vérification d'adresse postale AVS 0=non et 1=oui. |
| captureDate | 24 | C | 25 | AN | 1 | Date de la transaction de validation. |
| captureOrigin | 25 | C | 50 | AN | 1 | Origine de la transaction de validation. |
| captureAmount | 26 | C | 12 | N | 1 | Montant brut de la remise (avant déduction des commissions). |
acquirerFileNumber | 27 | C | 50 | N | 2 | Numéro du lot de remise. Présent uniquement si l'option « FileNumber » est demandée. |
Champs valorisés uniquement si type=SET et | ||||||
| operationTypeCode | 28 | C | 1 | A | 1 | Code opération D pour débit ou C pour crédit. |
| settleDate | 29 | C | 25 | AN | 1 | Date de la réconciliation. |
| grossAmount | 30 | C | 12 | N | 1 | Montant brut de la transaction. |
| feeAmount | 31 | C | 12 | N | 1 | Commission sur la transaction. |
| ifr | 32 | C | 16 | N | 3 | Montant de l'interchange IFR. |
Champs valorisés uniquement si type=CBK et option réconciliation demandé (cf. chap 6) | ||||||
| chargebackDate | 33 | C | 25 | A | 1 | Date de l'impayé |
| chargebackAmount | 34 | C | 12 | AN | 1 | Montant de l'impayé |
| chargebackReason | 35 | C | 20 | AN | 1 | Code de l'impayé |
| chargebackDescription | 36 | C | 100 | AN | 1 | La description de l'impayé est limitée à 100 caractères |
| chargebackNumber | 37 | C | 16 | AN | 4 | N° de dossier rattaché à l’impayé. Présent uniquement si l’option « charge_back_number» est demandé |
| Champs valorisés uniquement si type=REJ et contrat spécifique* (cf liste) | ||||||
| rejectDate | 38 | R | 20 | N | Date de rejet. | |
| rejectAmount | 39 | R | 12 | AN | Montant du rejet. | |
| rejectReason | 40 | C | 20 | AN | Code du rejet. | |
| rejectDescription | 41 | C | 100 | AN | Description du rejet tronquée sur 100 caractères. | |
Champs complémentaires | ||||||
| scheme | 42 | C | 20 | AN | Réseau utilisé (exple : CB ou VISA ou MASTERCARD...) | |
| forFutureUse | 43-53 | Champs vides réservés aux nouvelles fonctionnalités. | ||||
Légende : R = requis, F = facultatif, C = conditionnel
*Contrat spécifique = Cette fonction n'est pas supportée par tous les moyens de paiement et acquéreur.
Ligne d'en-queue (option)
En version standard, aucune ligne d’en‑queue n’est présente dans le fichier CSV.
Si vous activez l’option correspondante, une ligne d’en‑queue est ajoutée à la fin du fichier afin de récapituler le nombre total de transactions traitées.
Cette ligne permet de vérifier l’intégrité du fichier et de contrôler que le nombre de transactions reçues correspond bien au nombre attendu.
Nom de colonne | N° col | Type | Lg max | Format | Valeur ou description |
|---|---|---|---|---|---|
type | 1 | R | 6 | A | Type de ligne : FOOTER. |
captureNumber | 2 | R | 8 | N | Nombre total de transactions remisées dans le fichier. |
settlementNumber | 3 | R | 8 | N | Nombre total de transactions réconciliées dans le fichier. |
chargebackNumber | 4 | R | 8 | N | Nombre total de transactions impayées dans le fichier. |
Légende : R = requis, F = facultatif, C = conditionnel
Ces indicateurs vous aident à identifier les champs obligatoires selon les options activées et les types de transactions incluses.
Valorisation des données conditionnelles
Certaines données présentes dans le fichier des paiements ne sont renseignées que si les conditions suivantes sont réunies :
- l’organisme financier transmet l’information,
- vous avez souscrit à l’option correspondante auprès de MONEXT OnLine.
Les champs liés aux commissions bancaires, aux impayés ou aux informations avancées par l’acquéreur ne sont donc valorisés que si votre contrat inclut ces fonctionnalités.
Référence archivage (acquirerTransactionReference)
La référence archivage est la référence unique de transaction qui permet la réconciliation bancaire.
Elle dépend des contraintes imposées par l’acquéreur et est d'une longueur de 12 caractères maximum.
Crédit vs Débit
Les captures (CAP) et les settlements (SET) suivent la même logique de sens financier :
CAPTURE | SETTLEMENT | |
|---|---|---|
Paiement | C | C |
Remboursement | D | D |
Le code C indique un crédit (montant versé), tandis que le code D indique un débit (montant prélevé).
Tableau de correspondance entre les opérations et les paiements
Le tableau ci‑dessous indique la correspondance entre les opérations MONEXT OnLine et les lignes générées dans le fichier des paiements.
Opérations | Fichier des transactions | Fichier des paiements | Débit/crédit |
|---|---|---|---|
Autor (doAutor, action=100) | Autor | - | - |
Autor + Validation (doAutor, action=101) | Autor (101)Validation | CAP (J+1)SET (J+2) | C C |
Validation (doCapture, action=201) | Validation | CAP (J+1) | C |
Autor (doAutor, action=100)Cancel (doReset : avant la validation) | AutorAnnulation | - | - |
Autor (doAutor, action=100)Validation (doCapture, action=201)Remboursement (doReund, action=421 : après la validation) | AutorValidationRemboursement | CAP (J+1)SET (J+2) CAP (J+2) SET (J+2) | C CD D |
Autor (doAutor, action=100)Validation (doCapture, action=201) Chargeback | AutorValidationImpayé | CAP (J+1)SET (J+2)CBK | C CD |
Débit (doDebit, action=204 : opération non garantie) | Débit | CAP (J+1)SET (J+2) | C C |
Crédit (doCredit, action=422 : opération non garantie) | Crédit | CAP (J+1)SET (J+2) | D D |
Order (commande Paypal) | |||
Ré-autorisation (action.202) | Autor Autor | - | - |
Ce tableau vous permet de comprendre comment chaque action (autorisation, capture, remboursement, impayé…) se traduit dans le fichier des paiements, ainsi que le sens financier associé.