7-Eleven #CTSF# BNP Settlement File – Spécification |
---|
Guide d'intégration |
Version 6.2.1 |
Date 0701/0604/20182016 |
Table des matières
Table of Contents |
---|
Historique des versions
Date | Nom | Modification |
---|---|---|
0701/0604/20182016 | Peter Posse | Version originale |
7-Eleven
Informations générales sur 7-Eleven
7-Eleven est un mode de paiement comptant. Après avoir sélectionné les marchandises ou services, les acheteurs sont redirigés vers la page de passage à la caisse du commerçant. Il sélectionne 7-Eleven sur cette page. Le site du commerçant génère ensuite les détails de facturation sous forme de document optimisé pour impression. L'acheteur peut payer auprès d'un magasin participant. Une fois le paiement reçu, le commerçant expédie les achats.
Vous trouverez de plus amples informations sur la page web de 7-Eleven (https://www.7-eleven.com/).
Schéma de déroulement du processus
View file | ||||
---|---|---|---|---|
|
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