You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »



#CTSF# BNP Settlement File – Spécification

Guide d'intégration

Version 6.2.1

Date 01/04/2016


Table des matières


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

Email

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

  • No labels