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.

Tableau des devises

La solution de paiement prend en charge les devises suivantes (gérées de bout en bout). Ces devises sont transférées sous la forme de codes à trois lettres conformément à la norme ISO 4217. Veuillez noter que des devises comme le Yen japonais (JPY) sont transférées sans décimales. Si vous avez besoin d'une devise qui ne serait pas reprise dans la liste ci-dessous, veuillez vous adresser au Support.

*Disponible prochainement

Paiement avec AstroPay via l'interface de formulaire Payment platform

Pour procéder à un paiement AstroPay via PPRO à l'aide d'un formulaire Payment platform, appelez l'adresse URL ci-dessous :

https://paymentpage.epayment.bnpparibas/astropay.aspx  

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. Seuls AUD, BRL, CAD, CHF, CZK, DKK, EUR, GBP, HUF, LTL, LVL, MXN, NOK, NZD, PLN, RON, RUB, SEK, USD, ZAR sont autorisés.

MAC

an64

M

Code d'authentification de message haché (HMAC) avec algorithme SHA-256

OrderDesc2

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

AddCountryCode

a2

M

Code de pays à deux caractères conformément à ISO 3166.

CustomerID

ans..50

M

Numéro de l'acheteur

ProductName

a..14

O

Nom du produit à utiliser :

<astropaydirect> ou <astropaycard>

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 AstroPay

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

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

ID 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