Contents

AxeptaBNP Settlement File

Guide d'intégration

Version 1.0

Table des matières

Historique des versions

Date

Nom

Modification

Peter Posse

Version originale

Acronymes et abréviations

Description

The Settlement File aggregates all the data provided from the different payment methods used by the merchant in order to accommodate their reconciliation and reporting needs. Clearing and Settlement information are collected from the respective payment schemes, processors or acquirers.

The file is provided in a CSV format (comma separated file).

It is available :

• via the AXEPTA BNP Paribas backoffice (the file is available until 60 days in the backoffice)
• via an SFTP connection
  • For configuration and account credentials please contact the Axepta Helpdesk.
  • Merchants may collect BNP Settlement Files at their own discretion from a BNP SFTP account.
• via email (not recommended because the size is limited when there are large volumes of transactions)

Please note that the Settlement Files are generated in accordance with the frequency of clearing and settlement information made available by the relevant payment scheme(s), processor(s) or acquirer(s).

File is available everyday around 2:30pm.

File structure

The file is provided in a CSV format (comma separated file).

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.

Data format

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.

PAYOUT elements are available for:

• Amex (EPA)
• PPRO

File name (.ctsf)

Naming convention:         <MERCHANT_ID>#<FILE_CREATION_DATE>#<COUNTER>.ctsf

File name example:            ACME01#20201014#001.ctsf         

Settlement file's table (version 1.5)

Header record

Detail record

Fields 41 to 50 will stay empty until future enhancements.

• For 1 succesful transaction there will be a line on the setllment file with 50 columns
• Empty fields must be ignored

*NB: Please note that these data won't be available for bank account outside France and non euros bank accounts.

**NB: Please note that these data won't be available for bank account outside France

Total record

Values of the field "Record_Type"

*Currenctly not available.

Note : Please ignore "record_type" which are not mentioned in the table.

Details of the fields with multiple information

Field "Customer_Info"

Field "Extended_Info"

*Currently not available 

Example of a settlement file

100,BNP_MERCHANT_ECOM_FR_EUR,20200918,1.5
510,,BNP_MERCHANT_ECOM_FR_EUR,,,,,,,24.05.2020 02:00:30,OK,81654048,22bcbe3b5e6244c981c14e4210493988,6298,,6198,EUR,561258xxxxxx0934#Cartes Bancaires,,,,,,,,,0.16,27.05.2020 00:00:00,0000280700149,20200528,000280,EUR,0.12000,0.00235,0.03765,,,,,,,,,,,,,,,
510,,BNP_MERCHANT_ECOM_FR_EUR,,,,,,,24.05.2020 02:00:30,OK,81654048,22bcbe3b5e6244c981c14e4210493988,176000,,176000,EUR,5312XXXXXXXX0162#Cartes Bancaires,,,,,,,,,4.75,01.11.2017 00:00:00,0799843707306,20171103,799843,EUR,5.28000,2.43442,-2.96442,,,,,,,,,,,,,,,
511,,BNP_MERCHANT_ECOM_FR_EUR,,,,,,,20.07.2020 22:09:42,OK,73854588,dce173aee58a40eb8a34baee469603d4,6617,,599,EUR,4972xxxxxxxx4724#Cartes Bancaires,,,,,,,,,0.00,12.09.2020 00:00:00,0000622700257,20200914,000622,EUR,0.01000,0.00235,0.00000,,,,,,,,,,,,,,,
900,3,182797

Available payment Methods

*Not available currently

Data integration of external payment providers

When you activate the AXEPTA Settlement file service, the payment methods CB/VISA/MASTERCARD will be automatically included.

However, for any additionnal payment method, we invite you to contact our technical Support  (bnpparibas@computop.com) to receive the required instructions for the data activation of these other payment methods.

Below are the instructions of the main alternative payment methods : 

PayPal 

In order for us to get the settlement and clearing files of PayPal, you need to provide us with your PayPal SFTP account information.

To do so, you need to :

1. Contact your PayPal « Account Manager » to activate the SFTP functionnality in your PayPal customer account. Once it is activated, you will be able to directly access it via your PayPal account . 
2. Then, from your PayPal account, create a secure SFTP account in the section "account information - Creating a secure FTP server user ».
3. Once the SFTP is successfully created, please send to us (bnpparibas@computop.com) your SFTP data access : login + password.

Please find the PayPal documentation that may help you :  https://developer.paypal.com/docs/reports/sftp-reports/settlement-report/#know-before-you-begin

Note :

1. We will never ask for your PayPal account password (this data is confidential), we only need your PayPal SFTP account data information.
2. Do not mix up the activation of PayPal as a payment method in AXEPTA (activation done during your subscription) with the integration of PayPal reporting files in Axepta (process just described above).

AMEX 

For AMEX you will need to provide your AMEX contract number and fill in the "AMEX EPA Application form" which allows us to retrieve the AMEX reporting files. The form will be provided by BNP Paribas support (bnpparibas@computop.com) that you will need to contact directly.

Trustly

No action required for the merchant

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

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.

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

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

[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

Carte

Numéro de carte masqué ou jeton (token) de carte et réseau bancaire de la carte :
[0000xxxxxxxx0000]#
[Brand]

4111xxxxxxxx9996#
Visa

PAYPAL

[Payer_ID]#
[Payer]

A59XV256BZ#
john.doe@gmx.de

PPRO

Remboursement

[Acc_Holder]#
[Acc_Number]#
[Bank_Code]#

[Bank_Name]#
[BIC]#
[IBAN]

Chargeback

[Acc_Holder]#

[BIC]#

[IBAN]

John Doe#

#
RABONL2U#
Rabobank#
RABONL2U#
NL30RABO0205970948

John Doe#

RABONL2U#
NL30RABO0205970948

Champ "Extended_Info"

Mode de paiement

Structure / Commentaire

Exemple

Carte[1]

[Merchant_Discount_Rate]#
[Merchant_Discount]
[Currency]

CHARGEBACK

[ARN]#
[Reason_Code]#
[Status]

REQUÊTE DE RÉCUPÉRATION (RETRIEVAL REQUEST)

[ARN]#
[Reason_Code]#
[Status]

TC40/SAFE

[ARN]#
[Code]#

1.875#
1.95#
EUR

74527646319021051645048#
0350#
MI1

74527646319021051645048#
0350#
MI1

74627546887030655470117#
6

PAYPAL

[Merchant_Discount]#
[Currency]#
[Transaction_Type (credit / debit)]

203#
EUR#
CR

PPRO

Remboursement

[Channel]#
[TAG]#
[Country]#
[Selling_Point]#
fixed_fee=[FIXED_FEE_AMOUNT]#
fixed_fee_currency=[FIXED_FEE_CURRENCY]#
external_fee=[EXTERNAL_FEE_AMOUNT]#
external_fee_currency=[EXTERNAL_FEE_CURRENCY]#
minimum_discount_fee=[MINIMUM_DISCOUNT_FEE_AMOUNT]#
discount_rate=[DISCOUNT_RATE]

Channel   :     Fourni par le système de paiement ou le commerçant.
Cela est traité individuellement, mais nous utilisons généralement la valeur « testchannel » pour les comptes test et « livechannel » pour les comptes live.

TAG     :        Dépend du système de paiement fourni par la plateforme de paiement (à convenir avec PPRO).
Cela est traité individuellement. La liste la plus récente sera distribuée lors du processus d'intégration.

Country  :    Paramètre AddrCountryCode fourni dans la requête du commerçant. ·         GiropayPP
·         iDEALPP
·         SEPAPP
·         SofortPP

SellingPoint : Fourni par le commerçant.

Chargeback

[Chargeback_ID]#
[Chargeback_Reason_Code]#
[Chargeback_RefNu

livechannel#
iDEALPP#
NL#
T63542
fixed_fee=0.45#
fixed_fee_currency=EUR#
external_fee=0.00#
external_fee_currency=EUR#
minimum_discount_fee=0.00#
discount_rate=0

1055329#
MD06#
15072617000095/OCMT/EUR26,49/CHGS/EUR4,20

[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

510

Carte[1]

Débit

511

Remboursement

512

Chargeback

514

Demande de récupération (Retrieval Request)

517

TC40/SAFE

520

PAYPAL

Débit

521

Remboursement

522

Chargeback

710

PPRO

Débit

711

Remboursement

712

Chargback

[1] Les éléments IC+++ ne sont disponibles que s'ils sont fournis par la banque acquéreuse.