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

FormatDescription

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/
Transaction

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 Daten6Date d'expiration de la carte de crédit au format aaaaMM, par ex. 202005

19

Approval Codean6Code d'autorisation de la transaction

20

Cardholder Nameans..60Nom du titulaire de la carte

21

CardTypeans..64Type de carte, par ex. crédit, débit, prépayée, ...

22

Category (Card)ans..64Catégorie de carte de crédit, par ex. standard, business,...

23

SubBranda..22CardBrand2 ou sous-marque

24

BINn6..11Numéro d'identification bancaire

25

TerminalIDan8ID des Terminaux

26

CardAcceptorIDn5..12Numéro de partenaire contractuel

27

Acquirer Namean3Shortcode 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..30ID de transaction supplémentaire du marchand au niveau de l'action

36

Information du titulaire de carte 1 (transaction)ans..64Texte 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..64Texte 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

  • No labels