Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Multiexcerpt include
SpaceWithExcerptDOCBNP
MultiExcerptNameLogo BNP
PageWithExcerptEnglish documentation


Axepta BNP Settlement File

Guide d'intégration

Version 1.0

Date 20/04/2020



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
SpaceWithExcerptDOCBNP
MultiExcerptNameDefinition FR
PageWithExcerptAcronymes et abréviations

 


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

Wechat

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 PaymentsKlarna
iDEALBNP 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

FormatDescription

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 champDescription 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_IDIdentifiant du Settlement file (Settlement file ID)
PAYOUT_DATEDate de réglement (clearing date)
PAYOUT_REFERENCENuméro de remise (settlement file reference)
PAYOUT_CURRENCYDevise 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

É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

Nom de champFormatDescriptionExemple

1

RECORD_TYPE

N3


100

2

MERCHANT_ID

An..30


ACME01

3

DATE

N8


20200424

4

VERSION

An..4


1.5

 

Enregistrement détaillé

É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

Élément

Format


Exemple

1

RECORD_TYPE

N3


900

2

RECORD_COUNT

N..5


36

3

TOTAL_AMOUNT

N..12


798960


Valeurs

possibles

du champ "Record_Type"


Enregistrement

Moyen de paiement

Type de transaction

500DIRECT DEBITDébit
501Remboursement
502Chargeback

510

CARTES[1]

Débit

511

Remboursement

512

Chargeback

513Frais

514

Demande de récupération (Retrieval Request)

517

TC40/SAFE

520

PAYPAL



Débit

521

Remboursement

522

Chargeback

524Litige en cours
525Clôture du litige (résolu)
526Retrait général du compte PayPal

580

iDEAL

Débit

581Remboursement

630

KLARNA

Débit

631Remboursement

710

PPRO



Débit

711

Remboursement

712

Chargeback

720AMAZON PAYDébit
721Remboursement
722Chargeback
723Autorisation



Détails des champs avec multiples informations

Champ "Customer_Info"

Mode de paiement

Structure / Commentaire

Exemple

AMAZON PAY

[Customer_Name]#
[Customer_E-Mail]

John Doe#
john.doe@gmail.com

CARTE

Numéro de carte masqué ou token de la carte et marque (scheme) de la carte :
[0000xxxxxxxx0000]#
[Brand]

4111xxxxxxxx9996#
Visa

DIRECT DEBIT

[Account_Holder]#
[Account_Number]#
[Bank_ Code]#
[Bank]

ou

[Account_Holder]#
[IBAN]#
[BIC]#
[Bank]

ou

[IBAN]# '
[BIC]

John Doe#
10602437#
205950#
Barclays

ou

John Doe#
GB58BARC20595010602437#
BARCGB22#
Barclays

ou

GB58BARC20595010602437#
BARCGB22

iDEAL

[Account_Holder]#
[IBAN]#
[BIC]#
[Bank]

John Doe#
NL12RABO0388375809#
RABONL2U#
Rabobank

KLARNA

[OCR_No]#
[Invoice_No]

1834143680436#
519072450221831988

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

AMAZON PAY

[SellerOrderId]#
[SellerReferenceId]#
[AmazonOrderReferenceId]#
[AmazonTransactionId]#
[TotalTransactionFee]


CARTES[1]

DISCOUNT RATE

[Merchant_Discount_Rate]#
[Merchant_Discount]
[Currency]


CHARGEBACK

[ARN]#
[Reason_Code]#
[Status]


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

[ARN]#
[Reason_Code]#
[Status]


FRAUDE (TC40/SAFE)

[ARN]#
[Code]#


1.875#
1.95#
EUR



74527646319021051645048#
0350#
MI1



74527646319021051645048#
0350#
MI1



74627546887030655470117#
6

DIRECT DEBIT

[PmtInfId]

ou

[Mandate_ID]#[IP address]

Chargeback [6]

[reasonCode]#[trigger]#[token]

reasonCode -

  • 4 digit SEPA reason code

trigger -

  • “CHB” = Chargeback
  • “B1”..”B3” = CB after 1st, 2nd or 3rd retry

token -

  • ACT - CB was initiated by the customer
  • RFND - CB was initiated by the merchant
  • FRM - format error
  • NSF - no sufficient

5e736c2d718843149b71e3439b292dfe




reasonCode=MD17#trigger=CHB#token=NSF

iDEAL

NL#
[IP address]

NL#
82.151.44.149

KLARNA PAYMENTS[Merchant_Discount]3.97
KLARNA SOFORT

[Customer_ID]#
[Country]#
[Mandate_ID]#
[IP address]

9139795844#
DE#
9135762874-203185592#
78.49.133.9

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




Exemple

Code Block
languagexml
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