Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


#CTSF# BNP Settlement File – Spécification

Guide d'intégration

Version 6.2.1

Date 01/04/2016


Table des matières

Table of Contents


Historique des versions

Date

Nom

Modification

01/04/2016

Peter Posse

Version originale

 


Interface Payment platform

Définitions

Formats des données :

Format

Description

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 :

Abréviation

Description

CND

condition

M

obligatoire (mandatory en anglais)

O

optionnel

C

conditionnel


Remarque : Veuillez noter que les noms des paramètres peuvent être retournés en majuscules ou en minuscules.

 


Généralités

Objectif

Le BNP Settlement File (fichier de règlement) rassemble 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 d'aider nos clients dans le cadre du rapprochement de comptes et de répondre à leurs exigences en termes d'établissement des rapports. Les informations de compensation (clearing) et de règlement (settlement) sont récupérées dans les différents systèmes de paiement, prestataires de services de paiement ou organisme acquéreur 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

Système

Prestataire / Acquéreur / Passerelle

Cartes de crédit

American Express

American Express (German & PANEUROP)

VISA / MasterCard

B+S Card Service

ConCardis

Elavon

iCard

JPMorgan Chase

Lufthansa AirPlus

OmniPay (EMS, Global Payments, Paysquare)

SIX Payment Services

Vantiv

Wirecard

Worldline

Virements bancaires


Sofortüberweisung

*

Paydirekt

Paydirekt

Solutions alternatives

PayByBill/AfterPay

AfterPay/arvato

Barzahlen

Cash Payment Solutions

BillPay

BillPay

PayPal

PayPal

Prélèvement SEPA

*

Trustly

Trustly

*Plusieurs

PagBrasil

*Plusieurs

PPRO

Alipay

Alipay

*Plusieurs

PayU

 

Récupération

Les commerçants peuvent récupérer les fichiers de règlement BNP à leur discrétion à partir d'un compte BNP SFTP. Veuillez contacter le service d'assistance de BNP si vous souhaitez obtenir une aide pour la configuration et les informations d'identification.

Structure du fichier

Chaque fichier de règlement est divisé en un enregistrement en-tête, un ou plusieurs enregistrement(s) détaillé(s) et un enregistrement total. Le codage des sauts de ligne peut être configuré chez le commerçant. Certains champs peuvent contenir des valeurs de longueur variable. Si aucune taille n'est spécifiée, aucune limite de taille de champ ne s'applique.

Notation des types 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 3 caractères. La longueur minimale est déterminée par les exigences spécifiques de l'élément de données, mais doit être d'au moins 1 caractère.

tstp

Horodatage, format : <JJ.MM.AAAA hh:mm:ss>

 

Répertoire des éléments de données

Tous les éléments de données du fichier de règlement BNP sont présenté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 chanmpDescription

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 auxquelles une transaction a été acceptée par l'acquéreur / le système de paiement pour règlement, <JJ.MM.AAAA hh:mm:ss>. Si l'heure n'est pas spécifiée, elle est réglée sur « 00:00:00 »

COUNTER

Énumérateur pour garantir des noms de fichiers uniques (justifiés à gauche, remplis de zéros).

CUSTOMER_INFO

Champ construit 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).


Pour plus de détails, consulter la section « 4. Informations sur le client ».

EXTENDED_INFO

Champ construit contenant des informations supplémentaires disponibles en fonction du mode de paiement. Les sous-champs sont séparés par « # » (U+0023) (dièse).


Pour plus de détails, consulter la section « 5. Informations détaillées ».

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 BNP du commerçant.

ORDER_DESCRIPTION

Une description de la commande à laquelle le paiement se rapporte.

PAYMENT_CREATION_DATE

Date et heure de 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 de réseau).

RECORD_COUNT

Nombre total de lignes dans la section des enregistrements détaillés.

RECORD_TYPE

Enregistrement en-tête

Identifie l'entrée en question comme enregistrement en-tête, valeur « 100 ».


Enregistrement détaillé

Identificateur qui précise le mode de paiement et le type d'entrée dans le livre de comptes (par ex. note de débit et de crédit). Les frais facturés aux clients sont présentés comme des notes de débit et les paiements aux clients comme des notes de crédit.


Pour plus de détails, consulter la section « 6. Types d'enregistrement ».


Enregistrement total

Identifie l'entrée en question comme enregistrement total, valeur « 900 ».

REFERENCE_NUMBER

Le numéro de référence est une chaîne de caractères unique utilisée par le commerçant pour identifier un paiement (par ex. numéro de facture, numéro de ticket, etc.). En règle générale, il est transmis au système de paiement et est reproduit dans les données de facturation / rapports, afin qu'il puisse être associé aux transactions soumises.

SCHEME_FEE

Frais facturés par l'organisme émetteur de carte.

STATUS

L'état du paiement, actuellement toujours « OK ».

TOTAL_AMOUNT

Total de tous les montants de transaction (les notes de crédit sont également totalisées pour le montant total) dans la section des enregistrements détaillés dans la plus petite unité de la devise de transaction.

TRANSACTION_AMOUNT

Le montant est traité par le système de paiement dans la plus petite unité de la devise de transaction.

TRANSACTION_CURRENCY

Code pour la devise de transaction, trois caractères ISO 4217.

TRANSACTION_ID

Chaîne de caractères unique utilisée par le commerçant pour identifier un paiement de commande. Il peut être appliqué à une séquence de transactions connexes (demandes) qui constituent un paiement (par ex. autorisation, capture, note de crédit, etc.).

 

Noms de fichier

Règle d'affectation des noms :         <MERCHANT_ID>#<FILE_CREATION_DATE>#<COUNTER>.ctsf

É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

Nom de champFormatExemple

1

RECORD_TYPE

N3

100

2

MERCHANT_ID

An..30

ACME01

3

DATE

N8

20140424

4

VERSION

An..4

1.0

 


1.1           Enregistrement détaillé

Version 1.0

É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]

É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[2]

É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 l'acquéreur

[2] Les éléments IC+++ ne sont disponibles que s'ils sont fournis par l'acquéreur


Enregistrement total

Élément

Format

Exemple

1

RECORD_TYPE

N3

900

2

RECORD_COUNT

N..5

36

3

TOTAL_AMOUNT

N..12

798960


Informations sur le client

Mode de paiement

Structure / Commentaire

Exemple

AFTERPAY

[Customer_ID]

8902265613

ALIPAY cross-border

-


ALIPAY domestic

[Customer_ID]

John.doe@gmail.com

BARZAHLEN

[Customer_E-Mail]#
[Shop_URL]

john.doe@gmx.de

BILLPAY

[Merchant_Customer_ID]#
[Billpay_Customer_ID]#
[Claim_ID]#
[Activation_Date]#
[Due_Date]#
[Customer_Country]

184614#
836758#
1092900#
08.09.2014 00:00:00#
24.09.2014 00:00:00#
DEU

CREDIT CARD

Numéro de carte masqué ou jeton de carte et marque de carte :
[0000xxxxxxxx0000]#
[Brand]

4111xxxxxxxx9996#
Visa

DIRECT DEBIT

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

ou

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

John Doe#
10602437#
205950#
Barclays

ou

John Doe#
GB58BARC20595010602437#
BARCGB22#
Barclays

PAGBRASIL

[Customer_Name]#
[Customer_E-Mail]

John Doe#
john.doe@bol.com.br

PAYDIREKT

[Customer_BankID]

eba960e5-dd37-4d82-b479-ae3d28205994

PAYPAL

[Payer_ID]#
[Payer]

A59XV256BZ#
john.doe@gmx.de

PAYU

[Customer_Name]#
[Customer_E-Mail]

MAGDALENA WITKOWSKA#

magdalena.witkowska@interia.pl

PPRO

Credit

[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

SOFORTÜBERWEISUNG

voir DIRECT DEBIT

voir DIRECT DEBIT

TRUSTLY

[Customer_Country]#

[Customer_First_Name]#

[Customer_Last_Name]#

SE#

John#

Doe


Informations détaillées

Mode de paiement

Structure / Commentaire

Exemple

AFTERPAY

[Invoice_No]

61075095

ALIPAY cross-border

[Merchant_Discount]

2.25

ALIPAY domestic

[Merchant_Discount_Rate]#

[Merchant_Discount]

0.014#

9.87

BARZAHLEN

[Merchant_Discount]#
[VAT]

2.469#
0.46911

BILLPAY

[Portal_ID]#
[Merchant_Discount_Type]#
[Merchant_Discount_Rate]#

[Merchant_Discount]

4151#
3#
0.0135#
2.07

CREDIT CARD[1]

[Merchant_Discount_Rate]#

[Merchant_Discount]
[Currency]


CHARGEBACK

[ARN]#

[Reason_Code]#

[Status]


RETRIEVAL REQUEST

[ARN]#

[Reason_Code]#

[Status]


TC40/SAFE

[ARN]#

[Code]#

1.875#

1.95#
EUR



74527646319021051645048#

0350#

MI1



74527646319021051645048#

0350#

MI1



74627546887030655470117#

6

DIRECT DEBIT

[Customer_ID]#

[Country]#

[Mandate_ID]#

[IP address]

9139795844#

DE#

9135762874-203185592#

78.49.133.9

PAGBRASIL

[Pymt_Mthd]#
[Settled_Amount]#
[Merchant_Discount]#
[Pymt_Date]


ou -- Chargeback --


[Pymt_Mthd]#

[Settled_Amount]#

[CB_Date]#

[Pymt_Date]

Boleto bancário#
129.9#
22.9#
15/04/2014




Credit card#

0#

16/05/14#

09/03/2014

PAYDIREKT

[correlationId]#

[endToEndReferenceNumber]#

[paymentInformationId]

113811779-00000001#

PD29AC32139C0F40F4B2541287900138D6#

GIMBPROVDR20161201000000021579

PAYPAL

[Merchant_Discount]#
[Currency]#

[Transaction_Type (credit / debit)]

203#
EUR#

CR

PAYU

[Order_ID]#

[Trans_ID]#

[Merchant_Discount]

[P6061489]#

[608365647]#

[1.25]

PPRO

Credit

[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 actifs.

TAG             Dépend du système de paiement fourni par

paygate

Payment platform (à convenir avec PPRO).
Cela est traité individuellement. La liste la plus récente est distribuée lors du processus d'intégration.


·         AstroPayPP

·         CCPP

·         ELVPP

·         EPSPP

·         FasterPPP

·         GiropayPP

·         iDEALPP

·         IDDPP

·         POLiPP

·         POSTFINPP

·         P24PP

·         PSCPP

·         QIWIPP

·         RaberilPP

·         RaberilPPP

·         SafetyPPP

·         SEPAPP

·         SkrillPP

·         SofortPP

·         TeleingPP

·         TrustPayPP

·         UkashPP



Country        Paramètre AddrCountryCode fourni à la demande du commerçant.

SellingPoint Fourni par le commerçant


Chargeback

[Chargeback_ID]#

[Chargeback_Reason_Code]#

[Chargeback_RefNumber]


livechannel#

iDEALPP#

NL#

T63542



















































1055329#

MD06#

15072617000095/OCMT/EUR26,49/CHGS/EUR4,20

SOFORTÜBERWEISUNG

voir DIRECT DEBIT (Mandate_ID vide)

voir DIRECT DEBIT (Mandate_ID vide)

TRUSTLY

[Merchant_Discount]#

[Currency]#

[Value_Date]#

[Order_ID]#

[Acc_Name]#

[Order_Type]

0.05

SEK

2014-01-30 13:28:45#

3209647863#

SWEDENESSE#

Dépôt par l'utilisateur des fonds du client à SWEDENESSE#



[1] Les éléments CB, RR et TC40/SAFE ne sont disponibles que s'ils sont fournis par l'acquéreur


Types d'enregistrement

Enregistrement

Mode de paiement

Type de transaction

500

DIRECT DEBIT

Note de crédit

501

Note de débit

502

Imputation

510

CREDIT CARD[1]

Note de débit

511

Note de crédit

512

Imputation

514

Demande de récupération

517

TC40/SAFE

520

PAYPAL

Note de débit

521

Note de crédit

522

Imputation

530

BARZAHLEN

Note de débit

531

Note de crédit

530

AFTERPAY

Note de débit

531

Note de crédit

550

SOFORTÜBERWEISUNG

Note de débit

551

Note de crédit

560

BILLPAY

Note de débit

561

Note de crédit

570

TRUSTLY

Note de débit

571

Note de crédit

590

ALIPAY

Note de débit

591

Note de crédit

610

PAYU

Note de débit

611

Note de crédit

620

PAYDIREKT

Note de débit

621

Note de crédit

700

PAGBRASIL

Note de débit

701

Note de crédit

702

Imputation

710

PPRO

Note de débit

711

Note de crédit

712

Imputation

 


[1] Les enregistrements CB, RR et TC40/SAFE ne sont disponibles que s'ils sont fournis par l'acquéreur