#CTSF# BNP Settlement File – Spécification |
---|
Guide d'intégration |
Version 1.0 |
Table des matières
Table of Contents |
---|
Historique des versions
Date | Nom | Modification |
---|---|---|
| Peter Posse | Version originale |
Généralités Interface de la plateforme de paiement
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Généralités
Objectif
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.
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 | *Plusieurs | BNP Paribas |
Solutions alternatives | Amazon Pay | Amazon |
PayPal | PayPal | |
*Plusieurs | PPRO |
Récupération
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
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 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> |
Répertoire des éléments de données
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é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). Pour plus de détails, veuillez vous référer à la section « 4. Informations sur le client ». |
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). Pour plus de détails, veuillez vous référer à 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 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. Pour plus de détails, veuillez vous référer à la section « 6. Types d'enregistrement ». 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.). |
Noms de 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
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 |
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 sur le client
Mode de paiement | Structure / Commentaire | Exemple |
---|---|---|
CREDIT CARD | Numéro de carte masqué ou jeton (token) de carte et réseau bancaire de la carte : | 4111xxxxxxxx9996# |
PAYPAL | [Payer_ID]# | A59XV256BZ# |
PPRO | Remboursement [Acc_Holder]# [Bank_Name]# Chargeback [Acc_Holder]# [BIC]# [IBAN] | John Doe# # John Doe# RABONL2U# |
Informations détaillées
Mode de paiement | Structure / Commentaire | Exemple |
---|---|---|
CREDIT CARD[1] | [Merchant_Discount_Rate]# [Merchant_Discount] 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# 74527646319021051645048# 0350# MI1 74527646319021051645048# 0350# MI1 74627546887030655470117# 6 |
PAYPAL | [Merchant_Discount]# [Transaction_Type (credit / debit)] | 203# 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. TAG Dépend du système de paiement fourni par la plateforme de paiement (à convenir avec PPRO). · GiropayPP · iDEALPP · SEPAPP · SofortPP · ... Country Paramètre AddrCountryCode fourni dans la requête du commerçant. SellingPoint Fourni par le commerçant. Chargeback [Chargeback_ID]# [Chargeback_Reason_Code]# [Chargeback_RefNumber] | 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.
Types d'enregistrement
Enregistrement | Mode de paiement | Type de transaction |
---|---|---|
510 | CREDIT CARD[1] | Prélèvement |
511 | Remboursement | |
512 | Autorisation | |
514 | Demande de récupération | |
517 | TC40/SAFE | |
520 | PAYPAL | Prélèvement |
521 | Remboursement | |
522 | Autorisation | |
710 | PPRO | Prélèvement |
711 | Remboursement | |
712 | Autorisation |
[1] Les éléments IC+++ ne sont disponibles que s'ils sont fournis par la banque acquéreuse.