AxeptaBNP Settlement File |
|---|
Integration Guide |
Version 1.0 |
As of 01.09.2019 |
Contents
| Table of Contents |
|---|
Document history
Date | Name | Change |
|---|---|---|
01.09.2019 | Peter Posse | Original version |
Payment platform interface
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
Généralités
General Notes
ObjectifPurpose
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.
The BNP Settlement File aggregates settlement data from various payment schemes as comma separated file in order to accommodate the reconciliation and reporting needs of our clients. Clearing and Settlement information are collected from the respective payment schemes, processors or acquiring organizations and matched with the transaction records on file at BNP.
Please note that BNP Settelement Files are generated in accordance with the frequency of clearing and settlement information made available with the relevant payment scheme(s), processor(s) or acquirer(s).
Supported Payment Schemes, Payment Methods and Acquires
Category | Scheme | Processor / Acquirer / Gateway |
|---|---|---|
Credit cards |
Systèmes de paiement pris en charge, modes de paiement et acquéreurs
Catégorie | Marque | Prestataire / Acquéreur / Passerelle |
|---|---|---|
Cartes | CB, Visa, Mastercard | BNP Paribas |
Solutions alternativesAlternatives | Amazon Pay | Amazon |
PayPal | PayPal | |
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 |
Retrieval
Merchants may collect BNP Settlement Files at their own discretion from a BNP SFTP account. For configuration and account credentials please contact the BNP helpdesk
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.
File strcuture
Each Settlement File is structured into a header record, one or multiple detail records and a total record. The encoding for the line breaks is configurable at merchant level. Some fields may contain values of variable length. Where sizes are not given, a field size limitation does not apply.
Notation of data types
Notation des types de données| Format | Description |
|---|---|
a | Caractères alphabétiques Alphabetic characters A-Z, a-z |
n | Chiffres numériquesNumeric digits, 0-9 |
an | Caractères alphanumériques Alphanumeric characters A-Z, a-z, 0-9 |
ansAlphanumérique avec caractères spéciaux | Alphanumeric and special characters |
nsNumérique avec caractères spéciaux | Numeric and special characters |
3Longueur fixe avec 3 caractères | Fixed length data element of 3 characters |
..17Longueur 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 | Variable length data element up to a maximum of 3 characters. The minimum length is defined by the specific requirements of the data element itself, but shall be at least 1 character. |
tstp | HorodatageTimestamp, format format: <JJ<DD.MM.AAAA YYYY hh:mm:ss> |
Data element directory
All data elements of the BNP Settlement File are listed in alphabetical order in the table below. Some of the elements may contain sub-fields that provide data which are specific to an individual payment method, payment scheme or processor. For further details on these data please refer to the original documentation of the acquirer / processor.
| Field name |
|---|
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éreurCharges for the services of Acquirer. | ||
AUTHORIZATION_AMOUNT | Montant autorisé dans la plus petite unité de la devise de transactionAuthorized amount in smallest unit of transaction currency. | ||
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 The date and time a transaction has been accepted by the acquirer / payment scheme for settlement, <DD.MM.YYYY hh:mm:ss>. Si l'heure n'est pas spécifiée, elle sera fixée à'00:00:00:00'If the time is not given it will be set to ‘00:00:00’ | ||
COUNTER | Enumerator to ensure unique file names (left justified zero filled | 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 « # » Constructed field encompassing specific customer related information depending on the payment method. Sub-fields are divided by ‘#’ (U+0023) (dièseNumber Sign). | ||
EXTENDED_INFO | Champ structuré contenant des informations supplémentaires disponibles en fonction du mode de paiement. Les sous-champs sont séparés par « # » Constructed field encompassing additional information that is available depending on the payment method. Sub-fields are divided by ‘#’ (U+0023) (dièseNumber Sign). | ||
FILE_CREATION_DATE | Date de création du fichier de règlement BNP, <JJMMAAAA>the Computop Settlement File was created, <DDMMYYYY>. | ||
INTERCHANGE_FEE | Frais facturés par l'émetteur de carteFees charged by the card issuer. | ||
MERCHANT_ID | Identification du commerçant BNP .merchant identification | ||
ORDER_DESCRIPTION | Une description de la commande à laquelle le paiement se rapporteA description of the order the payment relates to. | ||
PAYMENT_CREATION_DATE | Date et heure de la création du paiement, <JJand time the payment has been created, <DD.MM.AAAA YYYY hh:mm:ss>. | ||
PROCESSING_FEE | Frais pour les services des prestataires de services de paiement Charges for the services of Processors (PSP, PasserelleGateway, OpérateurNetwork Operator). | ||
RECORD_COUNT | Nombre total de lignes dans la section des enregistrements détaillésTotal number of rows in detailed records section. | ||
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.). |
Header record Identifies the respective entry as header record, value ‘100’. Detail record Identifier that specifies the payment method and type of account ledger entry (e.g. debit and credit). Charges to customers are indicated as debits and payments to customers as credits. Totals record Identifies the respective entry as totals record, value ‘900’. | |
REFERENCE_NUMBER | The Reference Number is a unique string submitted by the merchant in order to identify a payment (e.g. invoice number, ticket number etc.). It usually gets forwarded to the payment scheme and is echoed in the clearing records / reports so that it can be matched with submitted transactions. |
SCHEME_FEE | Fee charged by the card organization. |
STATUS | The status of the payment, currently always ‘OK’. |
TOTAL_AMOUNT | Sum of all transaction amounts (credits are also summed up to the total amount) in the detailed record section in the smallest unit of transaction currency. |
TRANSACTION_AMOUNT | The amount that has been processed by the payment scheme in smallest unit of the transaction currency. |
TRANSACTION_CURRENCY | Refers to the three-letter ISO 4217 currency code of the currency in which the transaction was processed. |
TRANSACTION_ID | Unique reference submitted by the merchant in order to recognize a payment for an order. It might be shared across a sequence of related transactions (requests) that constitute a payment (e.g. authorization, capture, credit, etc). |
File names
Naming vonvention
Nom du fichier
Convention de dénomination: <MERCHANT_ID>#<FILE_CREATION_DATE>#<COUNTER>.ctsf
N°No. | ÉlémentElement | Format | ExempleExample |
|---|---|---|---|
1 | MERCHANT_ID | Anan..20 | ACME01 |
2 | FILE_CREATION_DATE | N8 | 20141014 |
3 | COUNTER | N3 | 001 |
Exemple de nom de fichier File name example: ACME01#20141014#001.ctsf
Records
Header record
| No | Field name |
|---|
Enregistrements
Enregistrement en-tête
| N° | Nom de champ | Format | ExempleExample |
|---|---|---|---|
1 | RECORD_TYPE | N3 | 100 |
2 | MERCHANT_ID | An..30 | ACME01 |
3 | DATE | N8 | 20140424 |
4 | VERSION | An..4 | 1.0 |
Enregistrement détaillé
Detail record
Version 1.0
N°No | ÉlémentElement | Format | ExempleExample |
|---|---|---|---|
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 Monthly subscription fee to ACME TV |
12 | EXTENDED_INFO | Ans.. | 1.875#EUR |
Version 1.1 [1]
N°No | ÉlémentElement | Format | ExempleExample |
|---|---|---|---|
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 Monthly subscription fee to 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 Monthly subscription fee to 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.elements are only available if provided by acquiring bank.
Total record
No | Element | Format | Example |
|---|
Enregistrement Cumul
N° | Élément | Format | Exemple |
|---|---|---|---|
1 | RECORD_TYPE | N3 | 900 |
2 | RECORD_COUNT | N..5 | 36 |
3 | TOTAL_AMOUNT | N..12 | 798960 |
Additional informations
ChampField "Customer_Info"
Mode de paiementPayment method | Structure / CommentaireComment | ExempleExample | ||
|---|---|---|---|---|
CREDIT CARD | Masked card number or card token and card brand | Carte | Numéro de carte masqué ou jeton (token) de carte et réseau bancaire de la carte : | 4111xxxxxxxx9996# |
PAYPAL | [Payer_ID]# | A59XV256BZ# | ||
PPRO | RemboursementCredit [Acc_Holder]# [Bank_Name]# Chargeback [Acc_Holder]# [BIC]# [IBAN] | John Doe# # John Doe# RABONL2U# |
Field "Extended_Info"
Mode de paiementPayment method | Structure / CommentaireComment | ExempleExample |
|---|---|---|
CarteCREDIT CARD[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 | RemboursementCredit [Channel]# Channel : From payment scheme or provided by merchant. TAG : Depends on payment scheme provided by paygate (has to be arranged with PPRO). Country : Paramètre AddrCountryCode fourni dans la requête du commerçant. Parameter AddrCountryCode provided in merchant request. SellingPoint : Fourni par le commerçantProvided by merchant. Chargeback [Chargeback_ID]# | livechannel# 1055329# |
[1] Les éléments IC+++ ne sont disponibles que s'ils sont fournis par la banque acquéreuse. CB, RR and TC40/SAFE elements are only available if provided by acquiring bank.
Field
Champ"Record_Type"
Record | Payment method | Transaction type |
|---|---|---|
| 500 | ||
Enregistrement | Mode de paiement | Type de transaction |
| 500 | Direct Debit | DébitDebit |
| 501501 | RemboursementCredit | |
| 502502 | Chargeback | |
510 | CarteCREDIT CARD[1] | DébitDebit |
511 | RemboursementCredit | |
512 | Chargeback | |
| 513 | FraisCosts | |
514 | Demande de récupération (Retrieval Request) | |
517 | TC40/SAFE | |
520 | PAYPAL | DébitDebit |
521 | RemboursementCredit | |
522 | Chargeback | |
| 524Litige en cours | Litigation in process | |
| 525 | Clôture du litige (résoluClosure of the dispute (resolved) | |
| 526Retrait | général du compte PayPalGeneral withdrawal from PayPal account | |
710 | PPRO | DébitDebit |
711 | RemboursementCredit | |
712 | ChargbackChargeback | |
| 720 | Amazon Pay | DébitDebit |
| 721 | RemboursementCredit | |
| 722 | Chargeback | |
| 723 | AutorisationAuthorisation |
[1] Les éléments IC+++ ne sont disponibles que s'ils sont fournis par la banque acquéreuse CB, RR and TC40/SAFE records are only available if provided by acquiring bank.