AxeptaBNP Settlement File |
---|
Guide d'intégration |
Version 1.0 |
Date 20/04/2020 |
Table des matières
Historique des versions
Date | Nom | Modification |
---|---|---|
20/04/2020 | Peter Posse | Version originale |
Acronymes et abréviations
Formats des données : a alphabétique as alphabétique avec caractères spéciaux n numérique an alphanumérique ans alphanumérique avec caractères spéciaux ns numérique avec caractères spéciaux bool expression booléenne (true ou false) 3 longueur fixe avec 3 chiffres/caractères ..3 longueur variable avec maximum 3 chiffres/caractères enum énumération de valeurs admissibles dttm Date et heure ISO (AAAA-MM-JJThh:mm:ss) Abréviations : CND condition M obligatoire (mandatory en anglais) O optionnel C conditionnel Remarque : Veuillez noter que les noms des paramètres peuvent être en majuscules ou en minuscules.
Généralités
Objectif
Le BNP Settlement File (fichier de règlement) regroupe les données tirées de différents systèmes de paiement dans un format CSV (Comma Separated Values – valeurs séparées par des virgules), 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 systèmes de paiement, prestataires de services de paiement ou organismes acquéreurs et sont adaptées aux enregistrements de transaction de BNP.
Veuillez noter que les fichiers de règlement BNP 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.
Systèmes de paiement pris en charge, modes de paiement et acquéreurs
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èglement 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 |
Récupération du fichier
Les commerçants peuvent récupérer les fichiers de règlement BNP à leur guise à partir d'un compte BNP sFTP(Secure File Transfert Protocol). Pour la configuration et les informations d'identification de compte, veuillez contacter le service d'assistance.
Structure du fichier
Chaque fichier de règlement 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.
Notation des types 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> |
Eléments du fichier
Tous les éléments de données du fichier de règlement BNP sont énumérés par ordre alphabétique 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 de chanmp | Description |
---|---|
ACQUIRER_FEE | Frais pour les services de l'acquéreur. |
AUTHORIZATION_AMOUNT | Montant autorisé dans la plus petite unité de la devise de transaction. |
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' |
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). |
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). |
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). |
FILE_CREATION_DATE | Date de création du fichier de règlement BNP, <JJMMAAAA>. |
INTERCHANGE_FEE | Frais facturés par l'émetteur de carte. |
MERCHANT_ID | Identification du commerçant BNP. |
ORDER_DESCRIPTION | Une description de la commande à laquelle le paiement se rapporte. |
PAYMENT_CREATION_DATE | Date et heure de la création du paiement, <JJ.MM.AAAA hh:mm:ss>. |
PROCESSING_FEE | Frais pour les services des prestataires de services de paiement (PSP, Passerelle, Opérateur). |
RECORD_COUNT | Nombre total de lignes dans la section des enregistrements détaillés. |
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 ». |
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. |
SCHEME_FEE | Frais facturés par l'organisme émetteur de carte. |
STATUS | L'état du paiement, actuellement toujours « OK ». |
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. |
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. |
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.). |
Nom du fichier
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
Enregistrements
Enregistrement en-tête
N° | Nom de champ | Format | Exemple |
---|---|---|---|
1 | RECORD_TYPE | N3 | 100 |
2 | MERCHANT_ID | An..30 | ACME01 |
3 | DATE | N8 | 20200424 |
4 | VERSION | An..4 | 1.0 |
Enregistrement détaillé
Version 1.0
N° | Élément | Format | Exemple |
---|---|---|---|
1 | RECORD_TYPE | N3 | 510 |
2 | TRANSACTION_ID | An..64 | 890_XUoqyBWuGw |
3 | TRANSACTION_CURRENCY | A3 | EUR |
4 | AUTHORIZATION_AMOUNT | N..12 | 789 |
5 | TRANSACTION_AMOUNT | N..12 | 700 |
6 | PAYMENT_CREATION_DATE | Tstp | 20.04.2020 14:18:23 |
7 | STATUS | An.. | OK |
8 | REFERENCE | An..30 | qArxtOE4w3FsSX5 |
9 | CUSTOMER_INFO | Ans..160 | 4111xxxxxxxx9996#VISA |
10 | CAPTURE_DATE | Tstp | 24.04.2020 00:00:00 |
11 | ORDER_DESCRIPTION | Ans..384 | Frais d'abonnement mensuel pour ACME TV |
12 | EXTENDED_INFO | Ans.. | 1.875#EUR |
Version 1.1 [1]
N° | Élément | Format | Exemple |
---|---|---|---|
1 | RECORD_TYPE | N3 | 510 |
2 | TRANSACTION_ID | An..64 | 890_XUoqyBWuGw |
3 | TRANSACTION_CURRENCY | A3 | EUR |
4 | AUTHORIZATION_AMOUNT | N..12 | 789 |
5 | TRANSACTION_AMOUNT | N..12 | 700 |
6 | PAYMENT_CREATION_DATE | Tstp | 20.04.2020 14:18:23 |
7 | STATUS | An.. | OK |
8 | REFERENCE | An..30 | qArxtOE4w3FsSX5 |
9 | CUSTOMER_INFO | Ans..160 | 4111xxxxxxxx9996#VISA |
10 | CAPTURE_DATE | Tstp | 24.04.2020 00:00:00 |
11 | ORDER_DESCRIPTION | Ans..384 | Frais d'abonnement mensuel pour ACME TV |
12 | EXTENDED_INFO | Ans..20 | 1.875#EUR |
13 | INTERCHANGE_FEE | Ans..20 | 1.875#13#EUR |
14 | SCHEME_FEE | Ans..20 | 1.875#13#EUR |
15 | ACQUIRER_FEE | Ans..20 | 1.875#13#EUR |
16 | PROCESSING_FEE | Ans..20 | 1.875#13#EUR |
Version 1.2 [1]
N° | Élément | Format | 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 | An..30 | 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 |
[1] Les éléments IC+++ ne sont disponibles que s'ils sont fournis par la banque acquéreuse.
Enregistrement Cumul
N° | Élément | Format | Exemple |
---|---|---|---|
1 | RECORD_TYPE | N3 | 900 |
2 | RECORD_COUNT | N..5 | 36 |
3 | TOTAL_AMOUNT | N..12 | 798960 |
Informations supplémentaires
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# |
[1] Les éléments IC+++ ne sont disponibles que s'ils sont fournis par la banque acquéreuse.
Champ "Record_Type"
Enregistrement | Mode 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 |
[1] Les éléments IC+++ ne sont disponibles que s'ils sont fournis par la banque acquéreuse.
Exemple
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