Table des matières
About This Guide
This guide serves as a reference for the format and content of reports generated and provided through the Axepta BNP Paribas Smart Data product.
Target Audience
This document is intended for technical personnel who will retrieve and analyze the reports generated by Axepta BNP Paribas Smart Data.
Data Formats
| Format | Description |
|---|---|
a | Alphabetic |
as | Alphabetic with special characters |
n | Numeric |
an | Alphanumeric |
ans | Alphanumeric with special characters |
ns | Numeric with spécial characters |
bool | Boolean expression (true or false) |
3 | Fixed length with 3 digits/characters |
..3 | Variable length with a maximum of 3 digits/characters |
enum | Enumeration of admissible values |
dttm | ISO date and time (YYYY-MM-DDThh:mm:ss) |
Definitions
Payment/ | Please note that the terms "payment" and "transaction" are used interchangeably in this document. A payment—or a transaction—can encompass a number of operational activities. In a transaction lifecycle, the status of the transaction changes based on the action performed. These actions include authorization, capture, sale, cancellation, and refund. A transaction is thus defined as a sequence of actions. |
Action | An action consists of an operation that modifies the status of a payment when executed successfully. |
Job | Within BNP Smart Data, a job includes a set of general information about the report presentation, filtering options, and data fields. |
Task | A task constitutes the actual representation of a job with an assigned execution time. |
Présentation du produit
BNP Smart Data est un service automatisé conçu pour créer un ou plusieurs rapport(s) prédéfini(s) mis à disposition dans le compte FTP d'un commerçant ou via le Backoffice à des fins de récupération. Ce service permet aux commerçants de programmer des rapports périodiques en fonction de leurs besoins individuels.
Les rapports Smart Data sont fournis sous forme de fichiers texte délimités (CSV) avec un ensemble standard de champs de données par défaut. Les commerçants ont néanmoins la possibilité de personnaliser leurs rapports en sélectionnant les champs de l'ensemble standard qu'ils souhaitent inclure. Les enregistrements peuvent englober des données relatives à des transactions effectuées entre un jour et maximum un an avant la date du rapport. À noter que les données en temps réel ne sont pas prises en charge par ce produit.
Pour toute configuration individuelle, veuillez contacter le service d'assistance BNP.
Filtrage des rapports
Les options de filtrage suivantes sont disponibles :
- MerchantID
- Société
- Devise
- Mode de paiement
- Statut du paiement
- Marque de la carte
- Action
- Uniquement les transactions réussies
- Uniquement les transactions non réussies
- Uniquement les transactions avec code(s) spécifique(s)
- Uniquement les transactions sans code(s) spécifique(s)
Veuillez noter que toutes les options de filtrage sont susceptibles de contenir plusieurs valeurs.
Planification des rapports
Les rapports Smart Data peuvent être configurés selon les options suivantes :
Rapport unique
- Période donnée entre deux dates
Rapports périodiques
- Tous les jours
- Toutes les semaines (jour de livraison en semaine à la seule discrétion du commerçant)
- Tous les mois (le 1er, le 2, le 3, ... du mois)
Format de fichiers
Les rapports BNP Smart Data sont créés dans des fichiers CSV sous forme de texte brut. Les virgules, les tabulations et les deux points sont des séparateurs pris en charge pour séparer des valeurs (pour toute configuration individuelle, veuillez contacter le service d'assistance BNP). Sauf indication contraire, les deux points sont utilisés comme séparateur par défaut.
Chaque fichier contiendra une première ligne d'en-tête et zéro ou plusieurs ligne(s) de données. Une ligne d'en-tête sera constituée d'une liste séparée des différents noms de champs, tels que définis dans le présent document, dans la commande spécifiée. Les noms des champs de la ligne d'en-tête sont actuellement disponibles en anglais et en allemand. Les lignes de données consistent en une liste séparée des valeurs des champs de données qui contiennent des caractères codés en UTF-8.
Sécurité
Pour des raisons de sécurité, tous les fichiers sont chiffrés (PGP) et transférés via SFTP ou disponibles dans le Back-Office.
Les fichiers seront automatiquement supprimés du serveur sFTP Axepta après 14 jours.
Le fichier de réconciliation est généré uniquement lorsque des transactions sont effectuées.
Noms de fichier
Les noms de fichiers sont attribués selon la convention suivante : BNPSmartData_[JobID]_[TaskID]_[AAAAMMJJ_hhmmss].CSV.pgp
Les différents éléments du nom sont décrits dans le tableau ci-dessous.
# | Élément | Format | Exemple |
|---|---|---|---|
1 | Préfixe | a12 | BNPSmartData |
2 | JobID | n..10 | Identifiant interne du job |
3 | TaskID | n..10 | Identifiant interne de la tâche |
4 | Horodatage | an15 | AAAAMMJJ_hhmmss |
Exemple de nom de fichier valide : BNPSmartData_12_789_20160320_023609.CSV.pgp
Enregistrements de données et description des champs
Chaque enregistrement représente une opération/action effectuée sur un paiement. En règle générale, un paiement se compose de plusieurs enregistrements d'opérations. Les champs de données disponibles sont répertoriés dans le tableau ci-dessous. Les champs de données individuels peuvent être omis sur demande.
# | Paramètre | Format | Description |
|---|---|---|---|
01 | PaymentID | an..32 | Identifiant de paiement généré par la plate-forme de paiement |
02 | MerchantID | an..20 | Identifiant de commerçant attribué par BNP |
03 | Payment Date | ans19 | Horodatage de l'heure de création du paiement : JJ.MM.AAAA hh:mm:ss |
04 | TransID | ans..64 | Identifiant de transaction attribué par le commerçant au niveau du paiement |
05 | RefNr | ans..12 | Identifiant de transaction supplémentaire attribué par le commerçant au niveau du paiement |
06 | Amount Auth | n..10 | Montant autorisé dans la plus petite unité de la devise de transaction |
07 | Amount Cap | n..10 | Montant saisi dans la plus petite unité de la devise de transaction |
08 | Amount Cred | n..10 | Montant remboursé dans la plus petite unité de la devise de transaction |
09 | Currency | a3 | Code pour la devise, trois caractères ISO 4217 |
10 | Payment Status | a..30 | Statut de la transaction avec l'une des valeurs suivantes : · AUTHORIZED · CANCELED · CAPTURE_REQUEST · CREDIT_REQUEST · FAILED · OK · PENDING · SUCCESS Veuillez noter que les valeurs de statut susmentionnées ne sont pas exhaustives et peuvent varier en fonction du mode de paiement. |
11 | Payment Method | ans..64 | Mode de paiement (par ex. carte, PayPal, etc.) |
12 | Card Brand | a..22 | Système de cartes (par ex. Visa, MasterCard, Maestro, etc.) |
13 | Country of Origin Card A2 | a..2 | Pays d'origine selon BIN/IIN (2 caractères ou n/a, par ex. DE) |
14 | Country of Origin Card A3 | a..3 | Pays d'origine selon BIN/IIN (3 caractères ou n/a, par ex. DEU) |
15 | Country of Origin Card N3 | an..3 | Pays d'origine selon BIN/IIN (3 chiffres ou n/a, par ex. 276) |
16 | Card Number | an..19 | Numéro de carte masqué |
17 | Card Token | n..19 | Token de carte généré par la plate-forme de paiement |
18 | Expiry Date | n6 | Date d'expiration de la carte de crédit au format aaaaMM, par ex. 202005 |
19 | Approval Code | an6 | Code d'autorisation de la transaction |
20 | Cardholder Name | ans..60 | Nom du titulaire de la carte |
21 | CardType | ans..64 | Type de carte, par ex. crédit, débit, prépayée, ... |
22 | Category (Card) | ans..64 | Catégorie de carte de crédit, par ex. standard, business,... |
23 | SubBrand | a..22 | CardBrand2 ou sous-marque |
24 | BIN | n6..11 | Numéro d'identification bancaire |
25 | TerminalID | an8 | ID des Terminaux |
26 | CardAcceptorID | n5..12 | Numéro de partenaire contractuel |
27 | Acquirer Name | an3 | Shortcode de l'acquéreur |
28 | IBAN | an..30 | Numéro de compte bancaire international |
29 | BIC | an..11 | ISO 9362 Code d'identification des banques |
30 | User Data | ans..256 | Données personnalisées du commerçant qui sont incluses dans la réponse et qui pourraient être transmises à l'hôte de traitement suivant en fonction de l'acquéreur et des dispositions spécifiques |
31 | OrderDesc | an..768 | Description de la commande |
32 | ActionID | an..64 | Identifiant d'action univoque attribué par la plate-forme de paiement |
33 | Payment Action | a..30 | Action effectuée pour le paiement |
34 | Action Date | ans19 | Horodatage de l'action : JJ.MM.AAAA hh:mm:ss |
35 | Numéro de référence (transaction) | ans..30 | ID de transaction supplémentaire du marchand au niveau de l'action |
36 | Information du titulaire de carte 1 (transaction) | ans..64 | Texte imprimé sur la facture de carte de crédit du client à côté du bénéficiaire |
37 | Information du titulaire de carte 2 (transaction) | ans..64 | Texte imprimé sur la facture de carte de crédit du client à côté du bénéficiaire |
38 | Response Code | n8 | Code de réponse Paygate |
39 | Action Status | a..50 | Statut reçu pour l'action exécutée |
40 | Action Amount | n..10 | Montant de l’opération dans la plus petite unité de la devise de transaction |
41 | Code Description | an..1024 | Description du code d'erreur |