Table des matières
Table of Contents |
---|
Description
Le fichier de réconciliation ( Settlement File ) regroupe l'ensemble des données des différents moyens de paiement utilisés par le commerçant afin de répondre à ses besoins 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 prestataires de services de paiement et acquéreurs.
Le fichier se présente dans un format CSV (Comma Separated Values – valeurs séparées par des virgules).
Il est disponible :
- depuis le backoffice AXEPTA BNP Paribas (le fichier est disponible jusqu’à 60 jours sur le Backoffice).
- via une connexion SFTP en mode pull (pour la configuration et les informations d'identification de compte, veuillez contacter le service d'assistance BNP Paribas).
- via email (non recommandée car la taille est souvent limitée en cas de large volume de transaction).
Veuillez noter que les fichiers de réconciliation 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.
Info | ||
---|---|---|
| ||
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. |
Structure du fichier
Chaque fichier de réconciliation 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.
Format 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> |
Nom du fichier (.ctsf)
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 | 20201014 |
3 | COUNTER | N3 | 001 |
Exemple de nom de fichier : ACME01#20201014#001.ctsf
Table du fichier de réconciliation (Settlement file version 1.5)
Enregistrement en-tête
N° | Nom de champ | Format | Description | Exemple |
---|---|---|---|---|
1 | RECORD_TYPE | N3 | Enregistrement en-tête: Identifie l'entrée correspondante comme enregistrement d'en-tête, valeur « 100 ». | 100 |
2 | MERCHANT_ID | An..30 | Donnée d'identification de la boutique du commerçant avec la solution AXEPTA BNP Paribas (MID donné lors de la souscription à l'offre, 1 MID = 1 boutique) | BNP_MERCHANT_ECOM_FR_EUR |
3 | DATE | N8 | Date de création du fichier de règlement BNP, <JJMMAAAA>. | 20200424 |
4 | VERSION | An..4 | Version du fichier (actuellement 1.5) | 1.5 |
Enregistrement détaillé
Les champs 41 à 50 restent vides et disponibles pour de futures évolutions (si nécessaire).
- Il faut donc ignorer les champs vides.
- Pour 1 transaction réalisée et réussie il y aura 1 ligne sur le fichier avec 50 champs.
N° | Élément | Format | Description | Exemple |
---|---|---|---|---|
1 | RECORD_TYPE | N3 | 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. Lien : Table RECORD TYPE | 510 |
2 | SALE_CHANNEL | An..32 | Canal de la transaction ECOM, MOTO, POS | |
3 | MERCHANT_ID | An..30 | Donnée d'identification de la boutique du commerçant avec la solution AXEPTA BNP Paribas (MID donné lors de la souscription à l'offre, 1 MID = 1 boutique) | BNP_MERCHANT_ECOM_FR_EUR |
4 | ACQUIRING_CONTRACT_ID | An..50 | Donnée d'identification du contrat "Acquéreur" commerçant pour la transaction réalisée (BNP Paribas, AMEX, PPRO, PayPal, etc) | 4970600 (pour BNP Paribas) EXAMPLELIVECONTRACT (pour PPRO) |
5 | BUSINESS_REGISTRATION_NUMBER | An..50 | Numéro d'enregistrement de l'entreprise --> SIRET pour une entreprise Française | 34979735700010 |
6 | STORE ID | Ans..120 | Donnée de la boutique physique du commerçant → uniquement remplie pour une transaction "in store" (POS), si vous utilisez notre solution omnicanale | BOUTIQUE PARIS15 CONVENTION |
7 | TERMINAL ID | Ans..32 | Donnée du terminal (POS) utilisé → uniquement remplie pour une transaction "in store" (POS), si vous utilisez notre solution omnicanale | 0431775016 |
8 | MERCHANT_ACCOUNT_NUMBER | An..34 | Numéro de compte indiqué dans le fichier de réconciliation BNPP - Uniquement pour les paiements par carte | |
9 | PAY_TYPE | An..32 | Méthode de paiement ou POS pour les transactions de proximité | Card / Paypal / POS |
10 | PAYMENT_CREATION_DATE | Tstp | Date et heure de la création du paiement, <JJ.MM.AAAA hh:mm:ss>. | 20.04.2020 14:18:23 |
11 | PAYMENT STATUS | A2 | L'état est toujours « OK » car il s'agit des paiements réussis et compensés | OK |
12 | ARCHIVE REFERENCE NUMBER | An..12 | Numéro de référence envoyé 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. | 00200Y2049Z8 |
13 | TRANSACTION_ID | Ans..64 | 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.). | 890_XUoqyBWuGw |
14 | AUTHORIZATION_AMOUNT | N..12 | Montant autorisé dans la plus petite unité de la devise de transaction. | 789 |
15 | AUTHORISATION_NUMBER | N..6 | Numéro d'autorisation - uniquement pour les paiements par cartes (ecom & proximité) | |
16 | TRANSACTION_AMOUNT | N..12 | Montant de la transaction dans la plus petite unité de la devise de la transaction. | 700 |
17 | TRANSACTION_CURRENCY | A3 | Code pour la devise de la transaction, trois caractères ISO 4217. | EUR |
18 | CUSTOMER_INFO | Ans..160 | 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). Voici le lien où trouver le détail de l'information que contient ce champ: DETAIL CHAMP CUSTOMER INFO | 4111xxxxxxxx9996#VISA |
19 | CARD_SCHEME | Ans..32 | Réseau du paiement par carte CB, VISA, MASTERCARD | CB |
20 | CARD_TYPE | A1 | Disponible pour les paiements par carte (BNPP acquiring) et les paiements de proximité Card type : C - Carte de crédit D - Carte de débit P - Carte prépayé U - Carte universel b - Inconnu | |
21 | CARD_NATURE | A1 | Disponible pour les paiements par carte (BNPP acquiring) et les paiements de proximité Card Nature P - Carte particulier E - Carte commercial b - Inconnu | |
22 | ISSUING_BANK_BIN | N..6 | Disponible pour les paiements par carte (BNPP acquiring) et les paiements de proximité BIN de la banque émettrice | |
23 | ISSUING_BANK_ID | N..5 | Disponible pour les paiements par carte (BNPP acquiring) et les paiements de proximité Identifiant de la banque émettrice | |
24 | TX_REGION | N..3 | Disponible pour les paiements par carte (BNPP acquiring) et les paiements de proximité Pays de la transaction | |
25 | CH_COUNTRY_CODE | N..6 | Disponible pour les paiements par carte (BNPP acquiring) et les paiements de proximité Code pays du porteur de carte | |
26 | ORDER_DESCRIPTION | Ans..768 | Description de la commande à laquelle le paiement se rapporte. (e: Frais d'abonnement mensuel pour une box TV) | |
27 | EXTENDED_INFO | Ans..200 | 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). | Voici le lien où trouver le détail de l'information que contient ce champ: DETAIL CHAMP EXTENDED INFO |
28 | CAPTURE_DATE | Tstp | 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' | 24.04.2020 00:00:00 |
29 | PAYOUT_ID | Ans..32 | Numéro du fichier de remise du prestataire de service (numéro du fichier de règlement pour BNP Paribas et "invoice number" pour PPRO) | 869843 |
30 | PAYOUT_DATE | N8 | Date de règlement | 20200528 |
31 | PAYOUT_REFERENCE | Ans..32 | Référence du fichier de remise (information non essentielle pour le commerçant, uniquement pour BNP Paribas en cas de problème) | 0000341501170 |
32 | PAYOUT_CURRENCY | A3 | Devise du compte de réglement (currency of account) | EUR |
33 | INTERCHANGE_FEE* | Ans..20 | Frais facturés par l'émetteur de carte. | 1.875 |
34 | SCHEME_FEE* | Ans..20 | Frais facturés par l'organisme émetteur de carte. | 1.875 |
35 | ACQUIRER_FEE* | Ans..20 | Frais facturés pour les services de l'acquéreur. | 1.875 |
36 | PROCESSING_FEE | Ans..20 | Frais facturés pour les services des prestataires de services de paiement (PSP, Passerelle, Opérateur). | 1.875 |
37 | CHARGEBACK FILE NUMBER** | Ans..20 | Numéro de dossier de l'impayé qui permet un suivi de la part du commerçant | 110034150116 |
38 | CHARGEBACK CODE AND REASON** | Ans..400 | Code de l'impayé et sa raison | 1261#duplicateprocessing |
39 | CHARGEBACK AMOUNT** | N..12 | Montant de l'impayé (débité ou crédité) | 600 |
40 | CHARGEBACK DATE** | N8 | Date de l'impayé | 20200421 |
41 | PAY ID | Ans..32 | Identifiant de paiement généré par la plate-forme de paiement | |
42 | RESERVED 2 | - | Champ réservé pour des évolutions futures | |
43 | RESERVED 3 | - | Champ réservé pour des évolutions futures | |
44 | RESERVED 4 | - | Champ réservé pour des évolutions futures | |
45 | RESERVED 5 | - | Champ réservé pour des évolutions futures | |
46 | RESERVED 6 | - | Champ réservé pour des évolutions futures | |
47 | RESERVED 7 | - | Champ réservé pour des évolutions futures | |
48 | RESERVED 8 | - | Champ réservé pour des évolutions futures | |
49 | RESERVED 9 | - | Champ réservé pour des évolutions futures | |
50 | RESERVED 10 | - | Champ réservé pour des évolutions futures |
*NB: Veuillez noter que ces données ne sont pas disponibles pour les comptes bancaires hors France et non €.
**NB: Veuillez noter que ces données ne sont pas disponibles pour les comptes bancaires hors France.
Enregistrement Cumul
N° | Élément | Format | Description | Exemple |
---|---|---|---|---|
1 | RECORD_TYPE | N3 | Enregistrement des cumuls: Identifie l'entrée correspondante en tant qu'enregistrement de totaux, valeur « 900 ». | 900 |
2 | RECORD_COUNT | N..5 | Nombre total de lignes dans la section des enregistrements détaillés. 1 ligne = 1 transaction | 36 |
3 | TOTAL_AMOUNT | N..12 | 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. | 798960 |
Valeurs du champ "Record_Type"
Enregistrement | Moyen de paiement | Type de transaction |
---|---|---|
500 | SEPA DIRECT DEBIT* | Débit |
501 | Remboursement | |
502 | Chargeback | |
510 | CARTES (CB/ VISA/ MC) | Débit |
511 | Remboursement | |
512 | Chargeback*
| |
510 | AMEX | Débit |
511 | Remboursement | |
512 | Chargeback | |
513 | Frais | |
514 | Demande de récupération (Retrieval Request) | |
517 | Fraude (TC40/SAFE) | |
520 | PAYPAL | Débit |
521 | Remboursement | |
522 | Chargeback | |
524 | Litige en cours | |
525 | Clôture du litige (résolu) | |
526 | Retrait général du compte PayPal | |
580 | iDEAL* | Débit |
581 | Remboursement | |
630 | KLARNA* | Débit |
631 | Remboursement | |
710 | PPRO | Débit |
711 | Remboursement | |
712 | Chargeback | |
720 | AMAZON PAY* | Débit |
721 | Remboursement | |
722 | Chargeback | |
723 | Autorisation |
*Non disponible actuellement.
NB. Veuillez ignorer les "Record_type" qui ne sont pas mentionnés dans le tableau ci-dessus.
Détails des champs avec multiples informations
Champ "Customer_Info"
Mode de paiement | Structure / Commentaire | Exemple |
---|---|---|
AMAZON PAY* | [Customer_Name]# | John Doe# john.doe@gmail.com |
CARTE (CB/VISA/MC/ AMEX) | Numéro de carte masqué ou token de la carte et marque (scheme) de la carte : | 4111xxxxxxxx9996# |
SEPA DIRECT DEBIT* | [Account_Holder]# ou [Account_Holder]# ou [IBAN]# ' | John Doe# ou John Doe# ou GB58BARC20595010602437# |
iDEAL* | [Account_Holder]# | John Doe# |
KLARNA* | [OCR_No]# | 1834143680436# |
PAYPAL | [Payer_ID]# | A59XV256BZ# |
PPRO | Remboursement [Acc_Holder]# [Bank_Name]# Chargeback [Acc_Holder]# [BIC]# [IBAN] | John Doe# # John Doe# RABONL2U# |
*Non disponible actuellement.
--
Champ "Extended_Info"
Mode de paiement | Structure / Commentaire | Exemple |
---|---|---|
AMAZON PAY* | [SellerOrderId]# | |
CARTES (CB/VISA/MC/ AMEX) | DISCOUNT RATE [Merchant_Discount_Rate]# CHARGEBACK INFO [Doc Request Reason]# RETRIEVAL REQUEST [ARN]# FRAUD ELEMENTS [ARN]# | 1.875# 74527646319021051645048# 74627546887030655470117# |
SEPA DIRECT DEBIT* | [PmtInfId] ou [Mandate_ID]#[IP address] Chargeback [6] [reasonCode]#[trigger]#[token] reasonCode -
trigger -
token -
| 5e736c2d718843149b71e3439b292dfe reasonCode=MD17#trigger=CHB#token=NSF |
iDEAL* | NL# | NL# |
KLARNA PAYMENTS* | [Merchant_Discount] | 3.97 |
KLARNA SOFORT* | [Customer_ID]# | 9139795844# |
PAYPAL | [Merchant_Discount]# | 203# |
PPRO | Remboursement [Channel]#
· GiropayPP
Impayés (chargeback) [Chargeback_ID]# | livechannel# 1055329# |
*Non disponible actuellement.
Exemple d'un fichier de réconciliation
Code Block |
---|
100,BNP_MERCHANT_ECOM_FR_EUR,20200918,1.5
510,,BNP_MERCHANT_ECOM_FR_EUR,,,,,,,24.05.2020 02:00:30,OK,81654048,22bcbe3b5e6244c981c14e4210493988,6298,,6198,EUR,561258xxxxxx0934#Cartes Bancaires,,,,,,,,,0.16,27.05.2020 00:00:00,0000280700149,20200528,000280,EUR,0.12000,0.00235,0.03765,,,,,,,,,,,,,,,
510,,BNP_MERCHANT_ECOM_FR_EUR,,,,,,,24.05.2020 02:00:30,OK,81654048,22bcbe3b5e6244c981c14e4210493988,176000,,176000,EUR,5312XXXXXXXX0162#Cartes Bancaires,,,,,,,,,4.75,01.11.2017 00:00:00,0799843707306,20171103,799843,EUR,5.28000,2.43442,-2.96442,,,,,,,,,,,,,,,
511,,BNP_MERCHANT_ECOM_FR_EUR,,,,,,,20.07.2020 22:09:42,OK,73854588,dce173aee58a40eb8a34baee469603d4,6617,,599,EUR,4972xxxxxxxx4724#Cartes Bancaires,,,,,,,,,0.00,12.09.2020 00:00:00,0000622700257,20200914,000622,EUR,0.01000,0.00235,0.00000,,,,,,,,,,,,,,,
900,3,182797 |
Moyens de paiement disponibles
Catégorie | Marque | Prestataire / Acquéreur / Passerelle |
---|---|---|
Cartes | CB, Visa, Mastercard | BNP Paribas |
Diners | BNP Paribas | |
AMEX | AMEX | |
Solutions alternatives | Amazon Pay* | Amazon |
PayPal | PayPal | |
Alipay Union Pay International (UPI) Paysafecard SEPA Direct Debit (SDD) MyBank Giropay Klarna Sofort (Pay now) TrustPay Bancontact iDeal EPS Przelewy24 (P24) Multibanco FPX MyClear RHB Bank eNets POLi Payments Boleto Bancario | PPRO Remarque : En cas de Bancontact via PPRO, les échecs de paiement seront également signalés dans le fichier de réconciliation pour que le commerçant puisse justifier les frais de transaction = 0,22 €. Les caractéristiques suivantes permettent au commerçant de reconnaître un échec de paiement : Les transactions erronées sont toujours renvoyées avec la date de la transaction (Transaction Date) = 01.01.1970 01:00:00 et une « saisie de montant » (Amount Capture) supplémentaire avec la valeur « 0 ». Seul le commerçant peut alors comptabiliser les frais de transaction (fixed_fee=0,22). | |
Klarna Payments (Klarna Pay Later)* | Klarna | |
iDEAL* | BNP Paribas |
*Non disponible pour le moment.
Intégration des données des différents prestataires de paiement
Lorsque vous activez le fichier de réconciliation (Settlement file) AXEPTA, les moyens de paiement CB/VISA/MASTERCARD seront automatiquement inclus. Cependant, pour tous les autres moyens de paiement additionnels, nous vous invitons à contacter le support BNP Paribas (bnpparibas@computop.com) pour recevoir les instructions nécessaires à l'activation de ces moyens de paiement additionnels.
Veuillez trouver ci-dessous les instructions nécessaires à l'activation des moyens de paiement alternatifs principaux :
PayPal
Pour que nous puissions récupérer les fichiers de règlement de PayPal, nous avons besoin des données de votre compte SFTP PayPal.
Pour cela vous devez :
- Contacter votre « Account Manager » PayPal (si vous en avez un) ou le support client standard de PayPal pour qu’il active cette fonction SFTP dans votre compte client PayPal et que vous puissiez y accéder directement.
- Vous devrez ensuite, depuis votre compte PayPal, créer un compte SFTP sécurisé dans la section « information sur le compte - Creating a secure FTP server user ».
- Après avoir créé le serveur SFTP avec succès, veuillez nous envoyer les données d'accès SFTP : nom d'utilisateur et mot de passe.
Veuillez trouver la documentation PayPal pour vous aider : https://developer.paypal.com/docs/reports/sftp-reports/settlement-report/#know-before-you-begin
A noter :
- Nous ne demanderons jamais le mot de passe de votre compte PayPal (ces données sont strictement confidentielles), nous avons besoin uniquement des accès à votre compte SFTP de PayPal.
- Ne pas confondre l’activation du moyen de paiement PayPal dans Axepta (activation réalisée lors de votre inscription avec la solution Axepta) et l’intégration des fichiers de reporting PayPal dans Axepta (procédure décrite ci-dessus).
AMEX
Pour AMEX vous devrez fournir votre numéro de contrat AMEX et remplir un formulaire "AMEX EPA Application form" qui nous autorise à récupérer les fichiers de reporting d'AMEX. Le formulaire vous sera transmis par le support BNP Paribas (bnpparibas@computop.com) que nous vous invitons à contacter directement.
#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 Payment platform
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.
Paiement avec 7-Eleven via l'interface de formulaire Payment platform
Pour procéder à un paiement 7-Eleven via PPRO à l'aide d'un formulaire Payment platform, appelez l'adresse URL ci-dessous :
Remarque : Pour des raisons de sécurité, Payment platform rejette toutes les demandes de paiement contenant des erreurs de formatage. Veuillez par conséquent utiliser le type de données correct pour chaque paramètre.
Le tableau ci-dessous décrit les paramètres de demande de paiement chiffrés :
Paramètre
Format
CND
Description
MerchantID
ans..30
M
ID du commerçant
TransID
ans..64
M
Numéro de transaction du commerçant, ce numéro doit être univoque
RefNr
ans..30
O
Numéro de référence univoque
Amount
n..12
M
Montant indiqué dans la plus petite unité de la devise (par ex. les centimes pour l'euro)
Veuillez contacter notre service d'assistance si vous souhaitez capturer des montants < 100 (plus petite unité de la devise).
Currency
a3
M
Devise, trois caractères DIN / ISO 4217. Seul MY est autorisé.
MAC
an64
M
Code d'authentification de message haché (HMAC) avec algorithme SHA-256
OrderDesc
ans..768
M
Description des produits, services etc. livrés.
URLSuccess
ans..256
M
Adresse URL complète qui appelle Payment platform en cas de réussite du paiement. L'URL ne peut être appelée que par le port 443. Cette URL ne peut contenir aucun paramètre : pour échanger des valeurs de paramètre entre Payment platform et la boutique, veuillez utiliser le paramètre UserData.
URLFailure
ans..256
M
Adresse URL complète qui appelle Payment platform en cas d'échec du paiement. L'URL ne peut être appelée que par le port 443. Cette URL ne peut contenir aucun paramètre : pour échanger des valeurs de paramètre entre Payment platform et la boutique, veuillez utiliser le paramètre UserData.
Response
a7
O
État de la réponse envoyée par Payment platform à URLSuccess et URLFailure, doit être chiffré. À cette fin, transmettez le paramètre Response=encrypt.
URLNotify
ans..256
M
Adresse URL complète appelée par Payment platform pour notifier le résultat de paiement à la boutique. L'URL ne peut être appelée que par le port 443. Elle ne peut contenir aucun paramètre : utilisez le paramètre UserData pour ce faire.
UserData
ans..1024
O
Si indiqué sur la demande, Payment platform transmet le paramètre à la boutique avec le résultat du paiement
ReqID
ans..32
O
Pour exclure tout paiement en double, entrez une valeur alphanumérique qui identifie votre transaction et ne peut être attribuée qu'une seule et unique fois. Si la transaction est à nouveau introduite avec la même ReqID, Payment platform n'exécute pas le paiement mais retourne simplement l'état de la transaction originale.
SellingPoint
ans..50
O
Point de vente
Service
ans..50
O
Produits ou services vendus
Channel
ans..64
O
Canal de configuration du contrat PPRO (Account et ContractID sont enregistrés au sein du système). Si ce paramètre est disponible, il remplace le cas échéant les canaux enregistrés au sein du système
AccOwner
ans..50
M
Nom du titulaire de compte
ans..100
M
Adresse e-mail de l'acheteur
Phone
ans..100
M
Numéro de téléphone de l'acheteur
AddrCountryCode
a2
O
Code de pays pour l'adresse de facturation du titulaire de compte, 2 caractères conformément à ISO 3166. Seul MY est autorisé, défini au sein du code.
Plain
ans..50
O
Valeur à définir par le commerçant pour retourner des informations non chiffrées, par ex. la MID
Custom
ans..1024
O
Le commerçant peut introduire plusieurs valeurs séparées par un | qui sont ensuite retournées non chiffrées et séparées par un &.
Custom=session=123|id=456 devient dans la réponse Session=123&id=456
Paramètres pour les paiements avec 7-Eleven
Le tableau suivant décrit les paramètres de réponse que Payment platform transmet à URLSuccess ou URLFailure et URLNotify. Si vous avez spécifié le paramètre Response=encrypt, les paramètres suivants sont transmis à votre système avec chiffrement Blowfish :
Paramètre
Format
CND
Description
MID
ans..30
M
ID du commerçant
PayID
an32
M
ID attribuée au paiement par Payment platform, par ex. pour le référencement au sein des fichiers batch.
XID
an32
M
ID attribuée par Payment platform pour toutes les différentes transactions pour un paiement
TransID
ans..64
M
Numéro de transaction du commerçant
RefNr
ans..30
O
Numéro de référence univoque du commerçant
Status
a..30
M
OK si URLSuccess et AUTHORIZE_REQUEST, ou FAILED si URLFailure
Description
ans..1024
M
Détails supplémentaires en cas d'échec du paiement. Veuillez ne pas utiliser le paramètre Description mais bien le paramètre Code pour une analyse de l'état de la transaction !
Code
n8
M
Code d'erreur conformément au fichier Excel des codes de réponse Payment platform (partie du logiciel Client)
MAC
an64
M
Code d'authentification de message haché (HMAC) avec algorithme SHA-256
UserData
ans..1024
O
Si indiqué sur la demande, Payment platform transmet le paramètre à la boutique avec le résultat du paiement
PaymentPurpose
ans..26
M
Motif du paiement
PaymentGuarantee
a..12
C
NONE = pas de garantie de paiement,
VALIDATED = compte client valide mais pas de garantie de paiement,
FULL = garantie de paiement
Remarque : ce paramètre n'est retourné que si l'état est = OK.
ErrorText
ans..256
C
Message d'erreur PPRO détaillé.
Remarque : n'est retourné que si l'état = FAILED. Utilisation possible uniquement après concertation avec le Support.
TransactionID
an..20
O
Numéro de transaction univoque pour PPRO
Plain
ans..50
O
Valeur à définir par le commerçant pour retourner des informations non chiffrées, par ex. la MID
Custom
ans..1024
O
Le commerçant peut introduire plusieurs valeurs séparées par un | qui sont ensuite retournées non chiffrées et séparées par un &.
Custom=session=123|id=456 devient dans la réponse Session=123&id=456
Paramètres de retour pour URLSuccess, URLFailure et URLNotify avec 7-Eleven