AxeptaBNP Settlement File |
---|
Guide d'intégration |
Version 1.0 |
Table des matières
Table of Contents |
---|
Historique des versions
Date | Nom | Modification |
---|---|---|
| Peter Posse | Version originale |
Acronymes et abréviations
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
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 de crédit | CB, Visa, Mastercard, Google Pay, Apple PayMastercar | BNP Paribas |
Solutions alternatives | Amazon Pay | Amazon |
PayPal | PayPal | |
Cetelem full CB / Presto | Cetelem | |
Alipay Union Pay International (UPI) Paysafecard SEPA Direct Debit (SDD) MyBank Giropay Sofort TrustPay Bancontact iDeal EPS Przelewy24 (P24) Multibanco Finnish ebanking Zimpler FPX MyClear RHB Bank eNets POLi Payments AstroPay direct Boleto Bancario Klarna | PPRO |
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: bnpparibas@computop.com.
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 | 20141014 |
3 | COUNTER | N3 | 001 |
Exemple de nom de fichier : ACME01#20141014#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 | 20140424 |
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.2014 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.2014 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.2014 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.2014 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.2014 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.2014 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 |
Version 1.3
[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.. |
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.2014 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.2014 00:00:00
12
ORDER_DESCRIPTION
Ans..384
Frais d'abonnement mensuel pour ACME TV
13
EXTENDED_INFO
Ans..
1.875#EUR
14
PAYOUT_ID
Ans..
1586789310000001
15
PAYOUT_DATE
N8
YYYYMMDD
Version 1.4
Cette version est identique à la version 1.0 mais contient plus d’informations dans le champ EXTENDED_INFO, notamment des informations sur le Settlement et le DCC. (Sans DCC, seulement les informations sur le settlement sont fournies)
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.2014 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.2014 00:00:00
11
ORDER_DESCRIPTION
Ans..384
Frais d'abonnement mensuel pour ACME TV
12
EXTENDED_INFO
Ans..
<EXTENDED_INFO>#settlementamount=<SETTLEMENT_AMOUNT>#
settlementcurrency=<SETTLEMENT_CURRENCY>#
dccRate=<DCC_RATE>#
dccMargin=<DCC_MARGIN>
[1] Les éléments IC+++ ne sont disponibles que s'ils sont fournis par la banque acquéreuse.
5 | 36 |
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 |
---|---|---|
Carte | Numéro de carte masqué ou jeton (token) de carte et réseau bancaire de la carte : | 4111xxxxxxxx9996# |
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 |
---|---|---|
Carte[1] | [Merchant_Discount_Rate]# CHARGEBACK [ARN]# REQUÊTE DE RÉCUPÉRATION (RETRIEVAL REQUEST) [ARN]# TC40/SAFE [ARN]# | 1.875# 74527646319021051645048# 74527646319021051645048# 74627546887030655470117# |
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 Débit | Débit |
501 | Remboursement | |
502 | Chargeback | |
510 | Carte[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 |
590 | Alipay | Débit |
591 | Remboursement | |
630 | Klarna | Débit |
631 | Remboursement | |
710 | PPRO | Débit |
711 | Remboursement | |
712 | Chargback | |
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.