Table des matières

  

MyBank

Informations générales sur MyBank

 

MyBank est un système de virement en ligne et en temps réel qui est actuellement proposé en la Grèce, en Italie et en l'Espagne. Au sein de ce système MyBank, l'acheteur choisit sa propre banque en ligne et y procède au virement. Une fois le paiement autorisé, le commerçant reçoit une confirmation du paiement ainsi qu'une garantie de paiement par MyBank.

  

Schéma de déroulement du processus


Déroulement du processus MyBank


Interface plateforme de paiement

Formats des données :

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 :

CND

condition

M

obligatoire (mandatory en anglais)

O

optionnel

C

conditionnel


Remarque : Veuillez noter que les noms des paramètres peuvent être en majuscules ou en minuscules.

 

Paiement avec MyBank via l'interface de formulaire de la plateforme de paiement

Pour procéder à un paiement MyBank à l'aide d'un formulaire de la plateforme de paiement, appelez l'adresse URL ci-dessous :

 

Remarque : Pour des raisons de sécurité, plateforme de paiement 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. Ce paramètre doit également être transféré non chiffré.

TransID

ans..64

M

Numéro de transaction du commerçant, ce numéro doit être univoque

RefNr

ans..40

O

Numéro de référence univoque du commerçant. Seuls les caractères a-zA-Z0-9,-_ sont autorisés.

Amount

n..10

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 EUR est autorisé.

AddrCountryCode

a2

M

Code de pays à deux caractères conformément à ISO 3166. Seuls ES, GR, IT sont autorisés.

MAC

an64

M

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

URLSuccess

ans..256

M

Adresse URL complète qui appelle plateforme de paiement 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 plateforme de paiement et la boutique, veuillez utiliser le paramètre UserData.

URLFailure

ans..256

M

Adresse URL complète qui appelle plateforme de paiement 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 plateforme de paiement et la boutique, veuillez utiliser le paramètre UserData.

Response

a7

O

État de la réponse envoyée par plateforme de paiement à 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 plateforme de paiement 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, plateforme de paiement transmet le paramètre à la boutique avec le résultat du paiement

ReqID

ans..32

O

Pour éviter les paiements en double, saisissez une valeur alphanumérique qui identifie votre transaction et ne peut être attribuée qu’une seule fois. Si la transaction est à nouveau soumise avec le paramètre ReqID identique, la plateforme de paiement n’exécute pas le paiement et se contente de retourner le statut de la transaction d’origine. Attention : Plateforme de paiement doit afficher un statut de transaction finalisée pour la première action initiale. Les introductions avec un ReqID identique pour un statut ouvert sont traitées à intervalles réguliers.

OrderDesc

ans..768

M

Description des marchandises et des prix. Destination prévue sur le relevé de compte.

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

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 MyBank

 

Le tableau suivant décrit les paramètres de réponse que plateforme de paiement 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 plateforme de paiement, par ex. pour le référencement au sein des fichiers batch.

XID

an32

M

ID attribuée par plateforme de paiement pour toutes les différentes transactions pour un paiement

TransID

ans..64

M

Numéro de transaction du commerçant

RefNr

ans..40

O

Numéro de référence univoque du commerçant. Seuls les caractères a-zA-Z0-9,-_ sont autorisés.

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 plateforme de paiement (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, plateforme de paiement 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

AccOwner

ans..50

O

Nom du titulaire de compte

IBAN

ans..34

O

IBAN du titulaire de compte

BIC

ans..11

O

BIC du titulaire de compte

AccBank

ans..20

O

Nom de la banque du titulaire de compte

Paramètres de retour pour URLSuccess, URLFailure et URLNotify avec MyBank

 

Note de crédit avec référence

Les notes de crédit (remboursements) sont possibles via une connexion de serveur à serveur. Pour une note de crédit avec référence à une capture, le montant de ladite note de crédit est limité au montant de la capture précédente.

Pour exécuter une note de crédit avec une transaction de référence, veuillez utiliser l'adresse URL suivante :

 

Remarque : Pour des raisons de sécurité, plateforme de paiement 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. Ce paramètre doit également être transféré non chiffré.

PayID

an32

M

ID attribuée par plateforme de paiement pour le paiement à créditer

TransID

ans..64

M

ID de la transaction qui doit être univoque pour chaque paiement

Amount

n..10

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

a..3

M

Code pour la devise, trois caractères DIN / ISO 4217

MAC

an64

M

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

ReqIDans..32OPour éviter les paiements en double, saisissez une valeur alphanumérique qui identifie votre transaction et ne peut être attribuée qu’une seule fois. Si la transaction est à nouveau soumise avec le paramètre ReqID identique, la plateforme de paiement n’exécute pas le paiement et se contente de retourner le statut de la transaction d’origine. Attention : Plateforme de paiement doit afficher un statut de transaction finalisée pour la première action initiale. Les introductions avec un ReqID identique pour un statut ouvert sont traitées à intervalles réguliers.

Paramètres pour paiement de notes de crédit avec MyBank via connexion Socket


Le tableau ci-dessous décrit les paramètres de réponse de plateforme de paiement :

Paramètre

Format

CND

Description

MID

ans..30

M

ID du commerçant

PayID

an32

M

ID attribuée au paiement par plateforme de paiement, par ex. pour le référencement au sein des fichiers batch.

XID

an32

M

ID attribuée par plateforme de paiement pour toutes les différentes transactions (autorisation, capture, note de crédit) pour un paiement

TransID

ans..64

M

Numéro de transaction du commerçant

Status

a..30

M

OK ou FAILED

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 plateforme de paiement (partie du logiciel Client)

RefNr

ans..40

O

Numéro de référence univoque du commerçant. Seuls les caractères a-zA-Z0-9,-_ sont autorisés.

ErrorText

ans..256

O

Message d'erreur PPRO détaillé.

Paramètres de réponse pour paiement de notes de crédit avec MyBank via connexion Socket

  • No labels