#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 de la plateforme de paiement
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 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 d'aider nos clients dans le cadre du rapprochement de comptes et de répondre à leurs exigences en termes d'établissement des rapportsde 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 dans les auprès des différents systèmes de paiement, prestataires de services de paiement ou organisme acquéreur 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 | 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 Pour la configuration et les informations d'identification .de compte, veuillez contacter le service d'assistance
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 est configurable au niveau du commerçant. Certains champs peuvent contenir des valeurs de longueur variable. Si aucune taille n'est spécifiée, aucune Lorsque les tailles ne sont pas indiquées, il n'y a pas de limite de taille de champ ne s'applique.
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 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 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 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 concernée comme enregistrementd'en-tête, 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 entrée concernée 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 Référence unique utilisée utilisée par le commerçant pour identifier un paiement de pour une commande. Il Elle peut être appliqué partagée à 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
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 |
1.1 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[2]
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 l'acquéreur
[2] Les éléments IC+++ ne sont disponibles que s'ils sont fournis par l'acquéreur
Enregistrement total
N° | É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] | |
BARZAHLEN | [Customer_E-Mail]# | |
BILLPAY | [Merchant_Customer_ID]# | 184614# |
CREDIT CARD | Numéro de carte masqué ou jeton de carte et marque de carte : | 4111xxxxxxxx9996# |
DIRECT DEBIT | [Account_Holder]# ou [Account_Holder]# | John Doe# ou John Doe# |
PAGBRASIL | [Customer_Name]# | John Doe# |
PAYDIREKT | [Customer_BankID] | eba960e5-dd37-4d82-b479-ae3d28205994 |
PAYPAL | [Payer_ID]# | A59XV256BZ# |
PAYU | [Customer_Name]# | MAGDALENA WITKOWSKA# |
PPRO | Credit [Acc_Holder]# [Bank_Name]# Chargeback [Acc_Holder]# [BIC]# [IBAN] | John Doe# # John Doe# RABONL2U# |
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]# | 2.469# |
BILLPAY | [Portal_ID]# [Merchant_Discount] | 4151# |
CREDIT CARD[1] | [Merchant_Discount_Rate]# [Merchant_Discount] CHARGEBACK [ARN]# [Reason_Code]# [Status] RETRIEVAL REQUEST [ARN]# [Reason_Code]# [Status] TC40/SAFE [ARN]# [Code]# | 1.875# 1.95# 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]# ou -- Chargeback -- [Pymt_Mthd]# [Settled_Amount]# [CB_Date]# [Pymt_Date] | Boleto bancário# Credit card# 0# 16/05/14# 09/03/2014 |
PAYDIREKT | [correlationId]# [endToEndReferenceNumber]# [paymentInformationId] | 113811779-00000001# PD29AC32139C0F40F4B2541287900138D6# GIMBPROVDR20161201000000021579 |
PAYPAL | [Merchant_Discount]# [Transaction_Type (credit / debit)] | 203# 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. TAG Dépend du système de paiement fourni par Payment platform (à convenir avec PPRO). · 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