Axepta BNP Settlement File
Guide d'intégration
Version 1.0
Table des matières
Table of Contents |
---|
Historique des versions
Date | Nom | Modification |
---|---|---|
20/04/2020 | Peter Posse | Version originale |
Acronymes et abréviations
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Description
Le fichier de réconciliation ( Settlement File ) regroupe l'ensemble des données des différents moyens de paiement utilisés par le commerçant afin de répondre aux besoins de nos clients en matière de rapprochement et de reporting. Les informations de compensation (clearing) et de règlement (settlement) sont récupérées auprès des différents prestataires de services de paiement et acquéreurs.
Le fichier se présente dans un format CSV (Comma Separated Values – valeurs séparées par des virgules).
Il est disponible :
- depuis le backoffice AXEPTA BNP Paribas (le fichier est disponible jusqu’à 60 jours sur le Backofice).
- via une connexion SFTP (pour la configuration et les informations d'identification de compte, veuillez contacter le service d'assistance BNP Paribas).
- via email (non recommandée car la taille est souvent limitée en cas de large volume de transaction).
Veuillez noter que les fichiers de réconciliation sont générés en fonction de la fréquence à laquelle les informations de compensation et de règlement provenant du/des système(s) de paiement, du/des prestataire(s) ou du/des acquéreur(s) sont mises à disposition.
Moyens de paiement disponibles
Catégorie | Marque | Prestataire / Acquéreur / Passerelle |
---|---|---|
Cartes | CB, Visa, Mastercard, AMEX CAPN | BNP Paribas |
Solutions alternatives | Amazon Pay | Amazon |
PayPal | PayPal | |
Alipay Union Pay International (UPI) Paysafecard SEPA Direct Debit (SDD) MyBank Giropay Klarna Sofort TrustPay Bancontact iDeal EPS Przelewy24 (P24) Multibanco Finnish ebanking Zimpler FPX MyClear RHB Bank eNets POLi Payments AstroPay direct Boleto Bancario | PPRO Remarque : En cas de Bancontact via PPRO, les échecs de paiement seront également signalés dans le fichier de réconciliation pour que le commerçant puisse justifier les frais de transaction = 0,22 €. Les caractéristiques suivantes permettent au commerçant de reconnaître un échec de paiement : Les transactions erronées sont toujours renvoyées avec la date de la transaction (Transaction Date) = 01.01.1970 01:00:00 et une « saisie de montant » (Amount Capture) supplémentaire avec la valeur « 0 ». Seul le commerçant peut alors comptabiliser les frais de transaction (fixed_fee=0,22). | |
Klarna Payments | Klarna | |
iDEAL | BNP Paribas | |
Cetelem 3x4x Cetelem Presto | BNP Paribas |
Structure du fichier
Chaque fichier de réconciliation est structuré en
- un enregistrement d'en-tête,
- un ou plusieurs enregistrement(s) détaillé(s)
- et un enregistrement de cumul.
Le codage des sauts de ligne est configurable au niveau du commerçant. Certains champs peuvent contenir des valeurs de longueur variable. Lorsque les tailles ne sont pas indiquées, il n'y a pas de limite de taille de champ.
Format de données
Format | Description |
---|---|
a | Caractères alphabétiques A-Z, a-z |
n | Chiffres numériques, 0-9 |
an | Caractères alphanumériques A-Z, a-z, 0-9 |
ans | Alphanumérique avec caractères spéciaux |
ns | Numérique avec caractères spéciaux |
3 | Longueur fixe avec 3 caractères |
..17 | Longueur variable avec un maximum de 17 caractères. La longueur minimale est définie par les exigences spécifiques de l'élément de données lui-même, mais doit être d'au moins un caractère. |
tstp | Horodatage, format : <JJ.MM.AAAA hh:mm:ss> |
Les champs du fichier
Tous les éléments de données du fichier de règlement BNP sont décrits dans le tableau ci-dessous. Certains éléments peuvent contenir des sous-champs comportant des données spécifiques à un certain mode de paiement, système de paiement ou prestataire de services de paiement. Pour plus de détails sur ces données, veuillez consulter la documentation originale de l'acquéreur / du prestataire.
Nom du champ | Description du champ |
---|---|
RECORD_TYPE | Enregistrement en-tête Identifie l'entrée correspondante comme enregistrement d'en-tête, valeur « 100 ». Enregistrement détaillé Identificateur qui spécifie le mode de paiement et le type d'entrée dans le registre des comptes (par exemple: débit et de crédit). Les frais facturés aux clients sont indiqués comme des débits et les paiements aux clients comme des crédits. Enregistrement des cumuls Identifie l'entrée correspondante en tant qu'enregistrement de totaux, valeur « 900 ». |
MERCHANT_ID | Identification du commerçant BNP. |
PAYMENT_CREATION_DATE | Date et heure de la création du paiement, <JJ.MM.AAAA hh:mm:ss>. |
STATUS | L'état du paiement, actuellement toujours « OK ». |
REFERENCE_NUMBER | Le numéro de référence est une chaîne unique envoyée par le commerçant afin d'identifier un paiement (par exemple, numéro de facture, numéro de billet, etc.). Il est généralement transmis au système de paiement et est repris dans les enregistrements/rapports de compensation afin qu'il puisse être mis en correspondance avec les transactions soumises. |
TRANSACTION_ID | Référence unique transmise par le commerçant afin de reconnaître un paiement pour une commande. Elle peut être partagée à travers une séquence d'opérations connexes (requêtes) qui constituent un paiement (par exemple, autorisation, capture, remboursement, etc.). |
AUTHORIZATION_AMOUNT | Montant autorisé dans la plus petite unité de la devise de transaction. |
TRANSACTION_AMOUNT | Le montant traité par le dispositif de paiement dans la plus petite unité de la devise de la transaction. |
TRANSACTION_CURRENCY | Code pour la devise de transaction, trois caractères ISO 4217. |
CUSTOMER_INFO | Champ structuré contenant des informations spécifiques relatives au client en fonction du mode de paiement. Les sous-champs sont séparés par « # » (U+0023) (dièse). |
ORDER_DESCRIPTION | Une description de la commande à laquelle le paiement se rapporte. |
EXTENDED_INFO | Champ structuré contenant des informations supplémentaires disponibles en fonction du mode de paiement. Les sous-champs sont séparés par « # » (U+0023) (dièse). |
CAPTURE_DATE | Date et heure à laquelle une transaction a été acceptée par l'acquéreur / le système de paiement pour le règlement, <JJ.MM.AAAA hh:mm:ss>. Si l'heure n'est pas spécifiée, elle sera fixée à'00:00:00:00' |
PAYOUT_ID | Identifiant du Settlement file (Settlement file ID) |
PAYOUT_DATE | Date de réglement (clearing date) |
PAYOUT_REFERENCE | Numéro de remise (settlement file reference) |
PAYOUT_CURRENCY | Devise du compte de réglement (currency of account) |
INTERCHANGE_FEE | Frais facturés par l'émetteur de carte. |
ACQUIRER_FEE | Frais pour les services de l'acquéreur. |
SCHEME_FEE | Frais facturés par l'organisme émetteur de carte. |
PROCESSING_FEE | Frais pour les services des prestataires de services de paiement (PSP, Passerelle, Opérateur). |
COUNTER | L'énumérateur doit s'assurer que les noms de fichiers sont uniques (le champ est rempli de zéros à gauche et justifié à gauche). |
FILE_CREATION_DATE | Date de création du fichier de règlement BNP, <JJMMAAAA>. |
RECORD_COUNT | Nombre total de lignes dans la section des enregistrements détaillés. |
TOTAL_AMOUNT | Somme de tous les montants de transaction (les remboursements sont également additionnés au montant total) dans la section des enregistrements détaillés dans la plus petite unité de la devise de la transaction. |
Nom du fichier (.ctsf)
Convention de dénomination: <MERCHANT_ID>#<FILE_CREATION_DATE>#<COUNTER>.ctsf
N° | Élément | Format | Exemple |
---|---|---|---|
1 | MERCHANT_ID | An..20 | ACME01 |
2 | FILE_CREATION_DATE | N8 | 20201014 |
3 | COUNTER | N3 | 001 |
Exemple de nom de fichier : ACME01#20201014#001.ctsf
Table du fichier de réconciliation (version 1.5)
Enregistrement en-tête
N° | Nom de champ | Format | Description | Exemple |
---|---|---|---|---|
1 | RECORD_TYPE | N3 | 100 | |
2 | MERCHANT_ID | An..30 | ACME01 | |
3 | DATE | N8 | 20200424 | |
4 | VERSION | An..4 | 1.5 |
Enregistrement détaillé
N° | Élément | Format | Description | Exemple |
---|---|---|---|---|
1 | RECORD_TYPE | N3 | 510 | |
2 | MERCHANT_ID | An..20 | ACME01 | |
3 | TRANSACTION_ID | An..64 | 890_XUoqyBWuGw | |
4 | TRANSACTION_CURRENCY | A3 | EUR | |
5 | AUTHORIZATION_AMOUNT | N..12 | 789 | |
6 | TRANSACTION_AMOUNT | N..12 | 700 | |
7 | PAYMENT_CREATION_DATE | Tstp | 20.04.2020 14:18:23 | |
8 | STATUS | An.. | OK | |
9 | REFERENCE | An12 | qArxtOE4w3FsSX5 | |
10 | CUSTOMER_INFO | Ans..160 | 4111xxxxxxxx9996#VISA | |
11 | CAPTURE_DATE | Tstp | 24.04.2020 00:00:00 | |
12 | ORDER_DESCRIPTION | Ans..384 | Frais d'abonnement mensuel pour ACME TV | |
13 | EXTENDED_INFO | Ans..20 | 1.875#EUR | |
14 | INTERCHANGE_FEE | Ans..20 | 1.875#13#EUR | |
15 | SCHEME_FEE | Ans..20 | 1.875#13#EUR | |
16 | ACQUIRER_FEE | Ans..20 | 1.875#13#EUR | |
17 | PROCESSING_FEE | Ans..20 | 1.875#13#EUR |
Enregistrement Cumul
N° | Élément | Format | Exemple | |
---|---|---|---|---|
1 | RECORD_TYPE | N3 | 900 | |
2 | RECORD_COUNT | N..5 | 36 | |
3 | TOTAL_AMOUNT | N..12 | 798960 |
Valeurs du champ "Record_Type"
Enregistrement | Moyen de paiement | Type de transaction |
---|---|---|
500 | DIRECT DEBIT | Débit |
501 | Remboursement | |
502 | Chargeback | |
510 | CARTES[1] | Débit |
511 | Remboursement | |
512 | Chargeback | |
513 | Frais | |
514 | Demande de récupération (Retrieval Request) | |
517 | TC40/SAFE | |
520 | PAYPAL | Débit |
521 | Remboursement | |
522 | Chargeback | |
524 | Litige en cours | |
525 | Clôture du litige (résolu) | |
526 | Retrait général du compte PayPal | |
580 | iDEAL | Débit |
581 | Remboursement | |
630 | KLARNA | Débit |
631 | Remboursement | |
710 | PPRO | Débit |
711 | Remboursement | |
712 | Chargeback | |
720 | AMAZON PAY | Débit |
721 | Remboursement | |
722 | Chargeback | |
723 | Autorisation |
Détails des champs avec multiples informations
Champ "Customer_Info"
Mode de paiement | Structure / Commentaire | Exemple |
---|---|---|
AMAZON PAY | [Customer_Name]# | John Doe# john.doe@gmail.com |
CARTE | Numéro de carte masqué ou token de la carte et marque (scheme) de la carte : | 4111xxxxxxxx9996# |
DIRECT DEBIT | [Account_Holder]# ou [Account_Holder]# ou [IBAN]# ' | John Doe# ou John Doe# ou GB58BARC20595010602437# |
iDEAL | [Account_Holder]# | John Doe# |
KLARNA | [OCR_No]# | 1834143680436# |
PAYPAL | [Payer_ID]# | A59XV256BZ# |
PPRO | Remboursement [Acc_Holder]# [Bank_Name]# Chargeback [Acc_Holder]# [BIC]# [IBAN] | John Doe# # John Doe# RABONL2U# |
Champ "Extended_Info"
Mode de paiement | Structure / Commentaire | Exemple |
---|---|---|
AMAZON PAY | [SellerOrderId]# | |
CARTES[1] | DISCOUNT RATE [Merchant_Discount_Rate]# CHARGEBACK [ARN]# REQUÊTE DE RÉCUPÉRATION (RETRIEVAL REQUEST) [ARN]# FRAUDE (TC40/SAFE) [ARN]# | 1.875# 74527646319021051645048# 74527646319021051645048# 74627546887030655470117# |
DIRECT DEBIT | [PmtInfId] ou [Mandate_ID]#[IP address] Chargeback [6] [reasonCode]#[trigger]#[token] reasonCode -
trigger -
token -
| 5e736c2d718843149b71e3439b292dfe reasonCode=MD17#trigger=CHB#token=NSF |
iDEAL | NL# | NL# |
KLARNA PAYMENTS | [Merchant_Discount] | 3.97 |
KLARNA SOFORT | [Customer_ID]# | 9139795844# |
PAYPAL | [Merchant_Discount]# | 203# |
PPRO | Remboursement [Channel]# Channel : Fourni par le système de paiement ou le commerçant. TAG : Dépend du système de paiement fourni par la plateforme de paiement (à convenir avec PPRO). Country : Paramètre AddrCountryCode fourni dans la requête du commerçant. · GiropayPP SellingPoint : Fourni par le commerçant. Chargeback [Chargeback_ID]# | livechannel# 1055329# |
Exemple
Code Block | ||
---|---|---|
| ||
100,MID,20140911,1.0 510,9dc67059361dbe07,EUR,7595,7595,02.09.2020 00:16:44,OK,90459a6a15b281664263,531001xxxxxx3570#MasterCard,02.09.2020 00:19:01,Order Description,1.875#EUR 511,9dc67059361dbe07,EUR,7595,2000,02.09.2020 00:16:44,OK,90459a6a15b281664263,531001xxxxxx3570#MasterCard,02.09.2020 02:02:36,Order Description,1.875#EUR 512,n/a,EUR,,100,10.09.2020 15:20,OK,,,10.09.2020 15:20,, 520,333246c1b46eafeb3,EUR,1490,1490,02.09.2020 11:37:03,OK,b0b4dcd7a263fc4a0327,BXV7N2GVX3TEY#john_doe@web.de,02.09.2020 11:37:33,PAYPAL . . .,53#EUR#DR 521,333246c1b46eafeb3,EUR,1490,620,02.09.2020 11:37:03,OK,b0b4dcd7a263fc4a0327,BXV7N2GVX3TEY#john_doe@web.de,02.09.2020 11:40:50,PAYPAL . . .,22#EUR#CR 522,n/a,EUR,,7090,06.09.2020 13:33,OK,593-151-678,NJW7HRTXBU3P4,06.09.2020 13:33,, 610,P6437554,PLN,18598,18598,19.01.2020 18:06:43,OK,,PayU Customer#payucust@interia.eu,09.02.2020 08:28:37,Transaction placed,P6437554#660545423#1.40 611,P6337819,PLN,4087,11999,24.01.2020 12:46:26,OK,,PayU Customer#payucust@wp.pl,09.02.2020 23:54:44,Refund P6337819,P6337819#649697804#0.00 700,20200130-105459-867,BRL,100,100,02.09.2020 10:55:33,OK,11ID68VS84EFP8NZ,John Doe#john.doe@bol.com.br,02.09.2020 00:00:00,Order Desc,Credit Card#1.0#0.33#09/03/2020 701,20200206-133103-673,BRL,100,100,02.09.2020 13:31:27,OK,XHVHGE6N71KA2BQ3,John Doe#john.doe@bol.com.br,02.09.2020 00:00:00,Order Desc,Banricompras#1.0#09/04/14#09/02/2020 701,20200127-152555-373,BRL,100,100,02.09.2020 15:27:41,OK,SBC55VKFI482ZUR7,John Doe#john.doe@bol.com.br,02.09.2020 00:00:00,Order Desc,Credit Card#1.0#0.68#09/03/2020 700,20200206-104248-837,BRL,100,100,02.09.2020 11:44:21,OK,WNADUW08HRWM4MG8,John Doe#john.doe@bol.com.br,02.09.2020 00:00:00,Order Desc,Banco do Brasil Comércio Eletrônico#1.0#0.32#09/03/2020 702,20200228-162237-848,BRL,100,100,02.09.2020 16:24:28,OK,,,02.09.2020 00:00:00,,Credit Card#0#16/05/14#03/09/2020 700,20200228-162237-849,BRL,100,100,02.09.2020 00:00:00,OK,SHVTLZVTC43KLQET,John Doe#john.doe@bol.com.br,02.09.2020 00:00:00,Order Desc,Debit Card#1.0#0.68#09/03/2020 700,20200130-105459-867,BRL,100,100,04.09.2020 10:55:33,OK,NYLUB2TNYMPDU0WL,John Doe#john.doe@bol.com.br,04.09.2020 00:00:00,Order Desc,Credit Card#1.0#0.33#09/03/2020 700,20200128-170102-000,BRL,100,100,02.09.2020 17:05:20,OK,U8OCHXW2SEQZJRJR,John Doe#john.doe@bol.com.br,02.09.2020 00:00:00,Order Desc,Boleto Bancário#1.0#0.18#09/03/2020 700,20200228-162237-848,BRL,100,100,02.09.2020 16:37:25,OK,PM805LIHFDVOU0MV,John Doe#john.doe@bol.com.br,02.09.2020 00:00:00,Order Desc,Debit Card#1.0#0.68#09/03/2020 701,20200127-152746-365,BRL,100,100,01.09.2020 15:32:36,OK,CDQVHYQHECI7NUGX,John Doe#john.doe@bol.com.br,01.09.2020 00:00:00,Order Desc,Credit Card#1.0#0.5#09/02/2020 700,20200130-135801-194,BRL,100,100,05.09.2020 08:27:00,OK,06H9UGSIC8TTALLG,John Doe#john.doe@bol.com.br,05.09.2020 00:00:00,Order Desc,Boleto Bancário#1.0#0.22#09/07/2020 700,20200205-163338-333,BRL,100,100,02.09.2020 13:07:12,OK,7I62X0RXHDCN8D0N,John Doe#john.doe@bol.com.br,20.08.2020 00:00:00,Order Desc,Bradesco Comércio Eletrônico#1.0#03/09/14#20/08/2020 900,20,50692 |