Smart Data Reference Guide |
---|
Guide d'intégration |
Version 1.0 |
Date 28/05/2020 |
Table des matières
Historique des versions
Date | Nom | Modification |
---|---|---|
28/05/2020 | Peter Posse | Version originale |
À propos de ce guide
Ce guide sert de référence pour le format et le contenu des rapports générés et fournis via le produit BNP Smart Data.
Public cible
Ce document est destiné au personnel technique qui récupérera et analysera les rapports générés par le système BNP Smart Data.
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 (vrai ou faux) |
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) |
Définitions
Payment/ | Veuillez noter que les termes « paiement » et « transaction » sont utilisés de façon interchangeable dans le présent document. Un paiement – ou une transaction – peut englober un certain nombre d'activités opérationnelles. Dans un cycle de vie de transaction, le statut de la transaction change en fonction de l'action effectuée. Parmi ces actions figurent l'autorisation, la saisie, la vente, l'annulation et le remboursement. Une transaction est ainsi définie comme une séquence d'actions. |
Action | Une action consiste en une opération qui modifie le statut d'un paiement lorsqu'elle est exécutée avec succès. |
Job | Dans le cadre de BNP Smart Data, un job inclut un ensemble d'informations générales sur la présentation du rapport, les options de filtrage et les champs de données. |
Task | Une tâche constitue la représentation réelle d'un job avec un temps d'exécution attribué. |
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 |