Moneybookers Gateway Manual

Moneybookers Ltd.
Portail de paiement de Moneybookers

Manuel d'intégration des marchands
Version : <6.6>
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
1 INTRODUCTION .............................................................................................. 3
2 DÉTAILS SUR LE PORTAIL DE PAIEMENT ........................................................ 4

2.1 APPLICATION .............................................................................................................. 4
2.2 DIAGRAMME D'INTERACTION ........................................................................................ 5
2.3 PROCÉDURE DE PAIEMENT PAR ÉTAPES ......................................................................... 6
3 CARACTÉRISTIQUES SUPPLÉMENTAIRES DU PORTAIL ................................. 23

3.1 INSCRIPTION RAPIDE AU PORTAIL ............................................................................... 23
3.2 QUICK CHECKOUT ..................................................................................................... 24
3.3 PORTAIL PARTAGÉ ..................................................................................................... 26
3.4 FACTURATION RÉCURRENTE ....................................................................................... 28
3.5 PAY-ON-DEMAND ....................................................................................................... 30
3.6 PARAMÈTRE RETURN_URL SÉCURISÉ ........................................................................... 32
3.7 REMBOURSEMENTS DE LA PART DU MARCHAND ............................................................ 33
3.8 AVIS D’OPPOSITION................................................................................................... 34
3.9 DESCRIPTEUR DYNAMIQUE ......................................................................................... 34
3.10 PORTAIL RÉDUIT ..................................................................................................... 35
3.11 CIBLE IFRAME ........................................................................................................ 36
4 ANNEXE I – DEVISES ISO 4217 ................................................................... 37
5 ANNEXE II – CODES ISO DES PAYS À 3 LETTRES .......................................... 38
6 ANNEXE III – SIGNATURE MD5 .................................................................... 41

6.1 FORMULAIRE HTML SIMPLE ......................................................................................... 42
6.2 FORMULAIRE HTML PLUS ÉVOLUÉ ................................................................................ 43
7 ANNEXE V – CODES DES PAIEMENTS SUR LE PORTAIL PARTAGÉ .................. 44
Non classé ©Moneybookers Ltd, 2009 Page 2 sur 44

1 Introduction
Le portail de paiement de Moneybookers permet aux marchands de recevoir de l'argent de

leurs clients en les redirigeant temporairement vers www.moneybookers.com. Le portail
utilise des formulaires HTML standard pour permettre une intégration facile au site Internet
du marchand.
Une fois le paiement effectué, le client est redirigé vers le site du marchand et, quelques
secondes plus tard, le marchand reçoit un avis de paiement avec les détails de la
transaction.
Ce document est destiné à être utilisé par le personnel technique s'occupant du site Internet
en ligne du marchand. Une bonne connaissance du langage HTML est requise. Vous aurez
probablement besoin de comptes tests ; pour cela, vous devez ouvrir des comptes en ligne
par l'intermédiaire de notre site Internet, puis nous communiquer les adresses e-mail
utilisées. Les comptes seront alors transformés en comptes tests et des fonds y seront
ajoutés. Les comptes tests fonctionnent dans l'environnement de production, mais on ne
peut pas envoyer des fonds depuis un compte test vers un compte normal.
Pour toute assistance supplémentaire destinée aux marchands, veuillez contacter notre
Service d'assistance aux marchands :
E-mail : merchantservices@moneybookers.com
Téléphone : +44 870 383 0762 (Lundi - Dimanche, 9:00 - 17:00 GMT)

2 Détails sur le portail de paiement
2.1 Application
Le portail de paiement de Moneybookers requiert que le marchand modifie sa page de

paiement pour y inclure l'option moneybookers.com comme mode de paiement. Ensuite,
lorsque le client choisit l'option moneybookers.com comme mode de paiement, il envoie, en
fait, un formulaire HTML aux serveurs Web sécurisés de Moneybookers. Le formulaire
envoyé contient des informations sur le paiement, telles que le compte du marchand, la
somme à payer et plusieurs autres champs textes cachés.

2.2 Diagramme d'interaction

2.3 Procédure de paiement par étapes
2.3.1 Redirection du client vers le portail de Moneybookers Étape 1
Une fois le client arrivé sur la page de commande/paiement du marchand, il doit voir
apparaître un bouton envoyant un formulaire HTML à
https://www.moneybookers.com/app/payment.pl. Le formulaire doit contenir les champs
cachés répertoriés dans le tableau ci-dessous. Pour optimiser la conversion, Moneybookers
conseille vivement au marchand de rediriger le client vers le portail dans la même fenêtre
de navigateur ou d'intégrer le portail dans une IFRAME. Lors de l'utilisation du portail
standard, la largeur minimale de la fenêtre/du cadre doit être de 600 pixels minimum.
Si vous souhaitez d'abord voir la manière dont le portail fonctionne, vous pouvez accéder à
notre formulaire de test sur http://www.moneybookers.com/app/test_payment.pl. Ce
formulaire a été prévu afin de montrer les différents scénarios pour lesquels notre portail
peut être utilisé. Mais, toutes les transactions confirmées au cours des essais effectués pour
tester le portail seront traitées comme de VRAIS paiements. Pour éviter cela, veuillez
contacter merchantservices@moneybookers.com et nous fixerons des comptes tests et des
données tests à des fins expérimentales.

Paramètres à envoyer au portail de Moneybookers :
Nom du champ Description Obligatoire Exemple de valeur
Informations sur le marchand

pay_to_email Adresse e-mail du compte moneybookers.com Oui merchant@merchant.com
du marchand.
recipient_description Une description du marchand, qui apparaîtra

sur le portail. Si aucune valeur n'est indiquée,
la valeur pay_to_email apparaîtra comme Non CompanyName
bénéficiaire du paiement. (30 caractères
maxi)
transaction_id Numéro de référence ou d'identification fourni

par le marchand. DOIT être unique pour Non A205220
chaque paiement (32 caractères maxi)
return_url URL vers lequel le client sera redirigé une fois
le paiement effectué. Si ce champ n'est pas
renseigné, la fenêtre du portail sera
simplement fermée automatiquement à la fin
de la transaction, de sorte à ce que le client http://www.merchant.com/paymen
Non
retourne à la dernière page du site Internet du t_made.htm
marchand sur laquelle il se trouvait
antérieurement. Une fonction return_url
sécurisée est disponible. Veuillez voir la
section 3.5.
return_url_text Le texte figurant sur le bouton lorsque Non Return to Sample Merchant
l'utilisateur a terminé son paiement.
Précise une cible dans laquelle la valeur
return_url sera nommée suite à la validation
du paiement effectué par le client. La valeur
par défaut est 1.
return_url_target Non 1
1 = '_top'
2 = '_parent'
3 = '_self'
4= '_blank'
cancel_url URL vers lequel le client sera redirigé si la
procédure de paiement est annulée. Si ce
champ n'est pas renseigné, la fenêtre du
portail sera simplement fermée
http://www.merchant.com/paymen
automatiquement après avoir cliqué sur le Non
t_cancelled.htm
bouton annulation, de sorte à ce que le client
retourne à la dernière page du site Internet
du marchand sur laquelle il se trouvait
antérieurement.

cancel_url sera nommée suite à l'annulation
cancel_url_target du paiement du client. La valeur par défaut Non 1
est 1.


1 = '_top'
2 = '_parent'
3 = '_self'
4= '_blank'
status_url URL auquel les détails de la transaction seront

envoyés une fois la procédure de paiement
https://www.merchant.com/proces
terminée. Sinon, vous pouvez préciser
s_payment.cqi
l'adresse e-mail à laquelle vous souhaitez
recevoir les résultats. Non
OU
Si le status_url n'est pas renseigné, aucun
mailto: merchant@merchant.com
détail de transaction ne sera envoyé au
marchand.
status_url2 Second URL auquel les détails de la https://www.merchant.com/proces

transaction seront envoyés une fois la s_payment.cgi
procédure de paiement terminée. Sinon, vous
pouvez préciser l'adresse e-mail à laquelle Non
OU
vous souhaitez recevoir les résultats.
mailto: merchant2@merchant.com
language Code de 2 lettres de la langue dans laquelle

s'affichent les pages de Moneybookers. Peut
Oui EN
être EN, DE, ES, FR, IT, PL, GR, RO, RU, TR,
CN, CZ, NL, DA, SV ou FI.
hide_login Les marchands peuvent faire apparaître à

leurs clients la page du portail sans la partie
Non 1
importante de connexion. Voir le point 3.10
pour une explication plus détaillée.
confirmation_note Le marchand peut faire apparaître au client,

sur l'écran de confirmation (la dernière étape
de la procédure), une note, un numéro de Nom du marchand espère que vous
Non
confirmation, un PIN ou tout autre message. apprécierez votre nouveau livre !
Des sauts de ligne <br> peuvent être utilisés
pour les longs messages.
logo_url L'URL du logo que vous souhaitez faire

apparaître dans le haut du portail. Le logo doit
être accessible par HTTPS, sinon il ne
https://www.merchant.com/logo.jp
s'affichera pas. Pour une meilleure Non
eg
intégration, nous conseillons aux marchands
d'utiliser des logos de dimensions allant
jusqu'à 200px de large et 50px de haut.
prepare_only Force seulement à renvoyer le SID sans la

page en question. Utile lorsque que vous
Non 1
utilisez d'autres méthodes pour rediriger le
client vers le portail. Voir le point 2.3.2 pour
une explication plus détaillée. Les valeurs


acceptées sont 1 et 0.
merchant_fields Une liste de noms de champs séparés par une

virgule qui doit être renvoyée au serveur du
marchand lorsque le paiement est confirmé Non Champ1, Champ2
sur moneybookers.com (5 champs maximum).
field 1 Un exemple de champ du marchand Non Valeur 1
field 2 Un exemple de champ du marchand Non Valeur 2
Informations sur le client

pay_from_email Adresse e-mail du client qui effectue le
paiement. Si ce champ est vierge, le client Non payer@moneybookers.com
doit indiquer son adresse e-mail lui-même.
title Titre de civilité du client. Valeurs acceptées :

Non M.
M., Mme ou Mlle
firstname Prénom du client Non John
lastname Nom de famille du client Non Payeur
Date de naissance du client. Le format est

date_of_birth mmjjaaaa. Seules des valeurs numériques Non 01121980
sont acceptées
address Adresse du client (ex. rue) Non Ruedupayeur
address2 Adresse du client (ex. ville) Non Villedupayeur
phone_number Numéro de téléphone du client. Seules des

Non 0207123456
valeurs numériques sont acceptées
postal_code Code postal/ZIP du client. Seules des valeurs

alphanumériques sont acceptées Non EC45MQ
(pas de signes de ponctuation, etc.)
city Ville du client Non Londres
state État ou région du client. Non Centre de Londres
country Pays du client - Code ISO de 3 lettres (voir la

Non GBR
liste des codes autorisés en Annexe II).
Détails relatifs au paiement


amount Le montant total à payer. Veuillez noter que 39.68
vous devez supprimer les zéros à droite si le OU
montant est un nombre naturel Oui 39.6
OU
39
currency Code de 3 lettres de la devise dans laquelle le

montant est exprimé, conformément à ISO Oui EUR
4217 (voir les devises acceptées en Annexe I)
amount2_description Le marchand peut indiquer un calcul détaillé

du montant total à payer. Veuillez noter que
Moneybookers ne vérifie pas la validité de ces
Non Prix du produit :
données ; elles apparaissent uniquement dans
la section "Plus d'informations" dans l'en-tête
du portail.
amount2 Ce montant, exprimé dans la devise définie

dans le champ 'currency', apparaîtra près de Non 29.90
amount2_description.
amount3_description Voir ci-dessus Non Frais de port :
amount3 Voir ci-dessus Non 3.10
amount4_description Voir ci-dessus Non TVA (20%) :
amount4 Voir ci-dessus Non 6.60
detail1_description Le marchand peut montrer jusqu'à 5 détails

relatifs au produit ou les transférer dans la
Oui ID du produit :
section "Plus d'informations" dans l'en-tête du
portail.
detail1_text La valeur detailX_text apparaît près de la

valeur detailX_description. La valeur
detail1_text apparaît au client dans son Oui 4509334
historique sur le site Internet de
Moneybookers.
detail2_description Voir ci-dessus Non Description :
detail2_text Voir ci-dessus Roméo et Juliette

Non
(W. Shakespeare)
detail3_description Voir ci-dessus Non Conditions spéciales :
detail3_text Voir ci-dessus Non Livraison sous 5 à 6 jours


detail4_description Voir ci-dessus Non
detail4_text Voir ci-dessus Non
detail5_description Voir ci-dessus Non
detail5_text Voir ci-dessus Non
2.3.2 Autre méthode pour rediriger le client
Le marchand peut parfois vouloir garder les détails du paiement confidentiels. Ce sont les
cas où les paramètres envoyés aux serveurs de Moneybookers contiennent des informations
confidentielles qui ne doivent pas être modifiées par le client. Lorsque vous utilisez la
procédure standard pour rediriger le client, telle qu'elle est décrite dans la partie
précédente, le client peut voir et éventuellement modifier les paramètres du paiement
puisque son navigateur exécute la requête en question pour la transaction. Il existe une
autre manière de rediriger le client vers notre portail, qui n'implique pas l'envoi des
paramètres du paiement au navigateur :
(i) Le serveur du marchand envoie une requête POST standard avec les paramètres du
paiement et le paramètre ‘prepare_only’ à :
https://www.moneybookers.com/app/payment.plhttps://www.moneybookers.com/app/
payment.pl
(ii) Le serveur de Moneybookers prépare une session pour le paiement et renvoie une
réponse HTTP(S) standard.
(iii) Le serveur du marchand prend le cookie SESSION_ID du Set-Cookie HTTP header

correspondant de la réponse.
(iv) À l'aide de cette valeur SESSION_ID, le client peut être redirigé vers
https://www.moneybookers.com/app/payment.pl?sid=<SESSION_ID> où le
déroulement normal des événements se poursuit. Cette redirection doit avoir lieu dans
les 15 minutes suivant la requête initiale, sinon la session prendra fin.

De cette façon, les détails du paiement sont communiqués de manière sécurisée, entre le
serveur du marchand et Moneybookers uniquement.
2.3.3 Confirmation du client sur les serveurs de Moneybookers Étape 2
Lorsque le client envoie le formulaire de redirection, il voit apparaître un écran illustrant

l'étape 2 de la procédure. Cette page est hébergée sur les serveurs de moneybookers.com
et contient tous les détails du paiement soumis par le marchand.
On compte deux principaux scénarios :
(i) Le client est déjà inscrit sur Moneybookers (il a déjà utilisé Moneybookers auparavant).
Dans ce cas, l'utilisateur doit simplement indiquer ses identifiants de connexion (voir ci-
dessous). Si le paramètre ‘pay_from_email’ est fourni et que l'adresse e-mail est inscrite
dans les fichiers de Moneybookers, cette adresse e-mail est pré-remplie dans le
formulaire de connexion et l'utilisateur doit seulement entrer son mot de passe et
confirmer. Si aucun paramètre ‘pay_from_email’ n'est fourni, le client verra apparaître
un formulaire d'inscription, comme il est expliqué plus en détail au point (ii), où figure
un lien permettant aux utilisateurs inscrits sur Moneybookers d'accéder à la page de
connexion.

En cliquant sur le bouton "CONNEXION", le client est redirigé vers la prochaine étape où
il doit choisir un mode de paiement parmi ceux acceptés par le marchand.
(ii) Le client n'est pas encore inscrit sur Moneybookers. C'est le cas si l'adresse e-mail
envoyée n'est pas encore connue de Moneybookers et ce peut être le cas si aucun
paramètre ‘pay_from_email’ n'est fourni. Le client voit apparaître un formulaire
d'inscription (voir ci-dessous), divisé en deux étapes, et enregistre instantanément ses
coordonnées sur Moneybookers. Les marchands peuvent fournir des informations
supplémentaires qui seront utilisées pour pré-remplir le formulaire d'inscription pour
accélérer le paiement : ‘address’, ‘firstname’, ‘lastname’, ‘postal_code’, ‘city’, ‘country’
comme il est expliqué dans la liste de champs ci-dessus. Si le paramètre
‘pay_from_email’ est fourni, il sera utilisé comme adresse e-mail primaire pour le
nouveau compte Moneybookers.

Étape 1 – Choix du mode de paiement et entrée des coordonnées personnelles :

Étape 2 – Création du mot de passe et acceptation des Conditions générales d'utilisation et

de la Politique de confidentialité

Vous trouverez ci-dessous une liste des modes de paiement disponibles parmi lesquels le
client peut faire son choix en suivant les instructions données dans la procédure d'achat du
portail :
Type de Accord spécial

Comment ça marche Délai
paiement requis
Si le client a suffisamment de fonds dans son porte-monnaie

électronique Moneybookers, le montant est déduit
Pay from e- Non ; activé pour
directement du solde disponible. Ceci est la manière la plus Instantané
wallet balance tous les marchands
rapide de payer et le client est directement envoyé à l'étape
de confirmation (Étape 3).
Non ; activé pour

Avec ce mode de paiement, une transaction en attente est
tous les
créée sur le compte du client et de plus amples instructions
marchands. Si
lui sont données sur la manière d'effectuer un paiement par
vous voulez cesser
virement bancaire hors ligne à Moneybookers. Dès
Pending bank d'accepter ce mode
réception du virement sur le compte en banque de 2-3 jours
transfer de paiement,
Moneybookers, l'argent est transféré sur le compte du
veuillez contacter
marchand et la transaction apparaît ‘Status’ 2 – exécutée.
merchantservices@
De plus, un e-mail est envoyé au marchand l'avisant du
moneybookers.com
paiement exécuté.
.
Moneybookers Direct permet aux clients d'effectuer des

paiements directement au marchand sans devoir Oui - Veuillez
approvisionner au préalable leur porte-monnaie contacter
électronique. Parmi les options de paiement actuelles, on merchantservices@
Moneybookers compte les cartes de crédit/paiement (internationales et moneybookers.com
Instantané*
Direct locales), les prélèvements automatiques et les virements pour commencer à
bancaires instantanés, tels que Giropay, Sofortüberweisung accepter
(Allemagne), Przelewy24 (Pologne), POLi (Australie) et Moneybookers
iDEAL (Pays-Bas). Voir la liste de tous les modes de Direct
paiement Moneybookers Direct disponibles en Annexe V.
* Veuillez noter que certains paiements reçus par virement bancaire peuvent être différés ;
le marchand doit donc préparer son système dans ce sens.

2.3.4 Page de confirmation sur les serveurs de Moneybookers Étape 3
À tout moment, avant de cliquer sur le dernier bouton 'confirm', le client peut annuler la
procédure de paiement et retourner sur le site Internet du marchand (à l'adresse URL
indiquée dans le champ 'cancel_url' du formulaire de redirection).

2.3.5 Page du statut de la transaction sur les serveurs de Moneybookers

Dernière étape
Une fois la procédure de paiement terminée, le message ‘Transaction successful’ apparaît et

le client est redirigé automatiquement vers le site Internet du marchand.
2.3.6 Rapport de statut de Moneybookers au marchand
Une fois la procédure de paiement terminée, le serveur de paiement de Moneybookers

enverra les détails de la transaction à l'adresse URL ‘status_url’ fournie par le marchand.
Ceci est effectué à l'aide d'une requête HTTP POST standard. Le serveur de Moneybookers
continuera à envoyer des rapports de statut jusqu'à ce qu'il reçoive une réponse de type
HTTP OK (200) de la part du serveur du marchand ou jusqu'à ce que le nombre d'envois
dépasse la limite de 10. Le tableau suivant présente les paramètres devant être reçus à
l'adresse status_url sur le serveur Web du marchand :

pay_to_email Adresse e-mail du marchand. Oui merchant@merchant.com
Adresse e-mail du client qui effectue

pay_from_email le paiement, c'est-à-dire qui envoie Oui payer@moneybookers.com
l'argent.
ID unique pour le compte
moneybookers.com du marchand.
merchant_id UNIQUEMENT nécessaire pour le Oui 100005
calcul de la signature MD5 (voir
Annexe III)
ID unique pour le compte
customer_id Non* 200005
moneybookers.com du client.
Numéro de référence ou
transaction_id d'identification fourni par le Non** A205220
marchand.
ID de transaction unique de
mb_transaction_id Oui 200234
Moneybookers pour le virement.
Le montant total du paiement
mb_amount Oui 25.46 / 25.4 / 25
exprimé dans la devise du marchand.
Devise de mb_amount. Sera toujours
identique à la devise dans laquelle le
mb_currency Oui GBP
compte du bénéficiaire est exprimé
sur Moneybookers.
Statut de la transaction : -2 échouée
/ 2 exécutée / 0 en attente / -1
status Oui 2
annulée (voir l'explication détaillée ci-
dessous)
327638C253A4637199CEBA6642
md5sig Signature MD5 (voir Annexe III) Oui
371F20
Le montant du paiement tel qu'il est
amount envoyé par le marchand dans le Oui 39.60 / 39.6 / 39
formulaire d'entrée.
La devise dans laquelle est exprimé le
currency paiement tel qu'il est envoyé par le Oui EUR
marchand dans le formulaire d'entrée
Avec le payment_type, le marchand
peut différencier les paiements
ordinaires "porte-monnaie" (WLT), les
payment_type Non*** WLT
paiements par virements bancaires
(PBT) et les paiements Moneybookers
Direct (MBD).
Si le marchand a envoyé une liste de
valeurs dans le paramètre
merchant_fields Non field1=value1
merchant_fields, elles seront renvoyées
avec le rapport de statut.
*Pour recevoir la valeur customer_id, veuillez contacter le gestionnaire de votre compte ou

merchantservices@moneybookers.com.

**Si aucun transaction_id n'est envoyé, la valeur mb_transaction_id sera envoyée dans le
rapport
***Pour recevoir la valeur payment_type, veuillez contacter le gestionnaire de votre compte

ou merchantservices@moneybookers.com
Pour renvoyer un rapport de statut ou vérifier automatiquement le statut d'une transaction

particulière, le marchand peut utiliser l'Interface de requêtes des marchands décrite dans
notre Manuel d'interface de paiements automatisés.
En plus des champs précédents, tous les champs indiqués dans le champ 'merchant_fields'
du formulaire de redirection envoyé initialement aux serveurs de Moneybookers seront
renvoyés au marchand à cette étape.
Nous conseillons également au marchand de valider les détails de la transaction dans le

rapport de statut en procédant aux étapes suivantes :
(i) Le marchand crée une transaction ou une commande en attente d'un montant X dans son
système.
(ii) Le marchand redirige le client vers le portail de paiement de Moneybookers où le client

termine la transaction.
(iii) Moneybookers envoie la confirmation d'une transaction à l'adresse ‘status_url’, en

incluant le paramètre 'mb_amount'.
(iv) La demande du marchand à 'status_url' valide d'abord les paramètres en calculant le

md5sig (voir Annexe III – Signature MD5) et, si tout va bien, la valeur de confirmation
envoyée (paramètre mb_amount) doit être comparable à celle de la
transaction/commande en attente dans son système. Les marchands peuvent également
vouloir comparer d'autres paramètres, tels que ‘transaction id’ et ‘pay_from_email’. Une
fois que tout est correct, le marchand peut traiter la transaction dans son système, en
créditant l'argent sur le compte de son client ou en expédiant les marchandises
commandées.

N.B. Si les marchands souhaitent restreindre la réception des rapports de statut

par l'adresse IP d'envoi, ils doivent le faire par l'intermédiaire de notre adresse IP
COMPLÈTE. Moneybookers peut changer de temps en temps l'adresse IP à partir
de laquelle nous envoyons le rapport de statut. Veuillez contacter
merchantservices@moneybookers.com pour plus d'informations.

2.3.7 Description détaillée du statut
‘2’ Exécutée – Ce statut est envoyé lorsque la transaction est exécutée et que les fonds
ont été reçus sur votre compte Moneybookers.
‘0’ En attente – Ce statut est envoyé lorsque le client paye par l'intermédiaire d'un
virement bancaire en attente. De telles transactions seront exécutées automatiquement SI
le virement bancaire est reçu par Moneybookers. Nous vous conseillons vivement de ne PAS
exécuter la commande/transaction dans votre système après réception d'un statut en
attente de Moneybookers.
‘-1’ Annulée – Les transactions en attente peuvent être annulées manuellement par
l'envoyeur dans l'historique de son compte en ligne ou bien seront automatiquement
annulées au bout de 14 jours si elles sont toujours en attente.
‘-2’ Échouée – Ce statut est envoyé lorsque le client essaye de payer par carte de crédit ou
par prélèvement automatique mais que notre fournisseur refuse la transaction. Si vous
n'acceptez pas les paiements par carte de crédit ou par prélèvement automatique par
l'intermédiaire de Moneybookers (voir page 16), alors vous ne recevrez jamais le statut
échoué.
‘-3’ Opposition – Vous pouvez recevoir ce statut uniquement si votre compte est configuré
pour recevoir des oppositions. Si c'est le cas, chaque fois qu'une opposition est reçue par
Moneybookers, un statut -3 sera envoyé à status_url pour la transaction opposée.

3 Caractéristiques supplémentaires du portail
3.1 Inscription rapide au portail
Cette fonction a pour but de minimiser les efforts demandés au client pour effectuer son
premier paiement aux marchands, tout en maintenant de bons niveaux d'inscription à
Moneybookers. Si vous voulez rendre le paiement plus facile et plus rapide pour vos clients,
veuillez contacter votre gestionnaire de compte ou écrire à
merchantservices@moneybookers.com pour faire apparaître cette fonction.
De plus, pour chaque transaction, vous DEVEZ inclure les paramètres suivants dans le
formulaire de redirection décrit au point 2.3.1 afin de permettre au client d'effectuer une
inscription rapide au portail :
Nom du champ Description Exemple de valeur
address Adresse du client (ex. rue) Ruedupayeur
postal_code Code postal/ZIP du client EC45MQ
city Ville du client Londres
Pays du client - Code ISO de 3 lettres

country (voir la liste des codes autorisés en GBR
Annexe II).
Si l'un ou plusieurs des paramètres ci-dessus n'est pas envoyé ou a une valeur incorrecte,
nous montrerons ces champs au client qui devra modifier les valeurs manquantes/erronées
pour terminer son inscription. Si tous les paramètres nécessaires sont fournis avec des
valeurs correctes, nous montrerons uniquement les champs suivants au client après l'avoir
redirigé vers le formulaire d'inscription de Moneybookers :
• Prénom : sera pré-rempli si la valeur ‘firstname’ est fournie

• Nom de famille : sera pré-rempli si la valeur ‘lastname’ est fournie
• Date de naissance : sera pré-rempli si la valeur ‘date_of_birth’ est fournie
• E-mail : sera pré-rempli si la valeur ‘pay_from_email’ est fournie
• Mot de passe et confirmation de mot de passe

Après avoir bien rempli tous les champs ci-dessus, la procédure de paiement se poursuivra
normalement.
3.2 Quick Checkout
Quick Checkout de Moneybookers est une fonction qui s'inscrit dans le prolongement de la
fonction Gateway Fast Registration (GWFR) d'inscription rapide existante pour rendre
l'expérience du client encore plus rapide et donc accélérer la conversion du paiement. Quick
Checkout permet aux clients effectuant leur première transaction par l'intermédiaire de
Moneybookers de terminer la procédure sans devoir s'inscrire à un compte classique, ni
fournir de mot de passe.
Par définition, cette fonction reflète GWFR et garantit le même niveau de sécurité, mais elle
est beaucoup plus attrayante pour le client puisque aucune inscription/mot de passe n'est
requise. Afin d'utiliser cette fonction, le marchand doit en faire la demande par e-mail à
merchantservices@moneybookers.com.
Les mêmes règles que pour l'inscription rapide au portail s'appliquent pour Quick Checkout.
Le marchand doit fournir les paramètres suivants pour chaque transaction :

address Adresse du client (ex. rue) Ruedupayeur
postal_code Code postal/ZIP du client EC45MQ
city Ville du client Londres
Pays du client - Code ISO de 3 lettres

country (voir la liste des codes autorisés en GBR
Annexe II).
Si l'un ou plusieurs des paramètres ci-dessus n'est pas envoyé ou a une valeur incorrecte,
ces champs apparaîtront au client qui devra modifier les valeurs manquantes/erronées pour
terminer le paiement.
Le marchand peut fournir des paramètres supplémentaires pour rendre la procédure de

paiement encore plus rapide :

Prénom du client. Cette valeur sera pré-

firstname remplie si le marchand l'envoie par John
l'intermédiaire du paramètre `firstname’
Nom de famille du client. Cette valeur
sera pré-remplie si le marchand l'envoie
lastname Payeur
par l'intermédiaire du paramètre
`lastname’
Date de naissance du client. Cette valeur
sera pré-remplie si le marchand l'envoie
date_of_birth 01121980
par l'intermédiaire du paramètre
`date_of_birth’
E-mail du client. Cette valeur sera pré-
remplie si le marchand l'envoie par
pay_from_email payeur@exemple.com
l'intermédiaire du paramètre
`pay_from_email’
Le client peut uniquement terminer la transaction avec la fonction Quick Checkout s'il paie
par l'intermédiaire d'un des modes suivants :
• Visa
• MasterCard
• Amex
• JCB
• Diners
• Laser
• Solo (UK)
• Maestro (UK)
• Carte Bleue
• German Direct Debit
• Giropay
• Sofortueberweisung

3.3 Portail partagé
Cette fonction permet aux marchands de sélectionner le(s) mode(s) de paiement qu'ils
veulent présenter au client lors de l'utilisation du portail. Un exemple d'utilisation de cette
fonction est lorsque le marchand veut faire apparaître “Payer par prélèvement automatique
(fourni par Moneybookers)” comme option de paiement sur sa page de commande, plutôt que
simplement “Payer par l'intermédiaire de Moneybookers”.
Pour sélectionner des modes de paiement particuliers à présenter au client sur le portail, le
paramètre suivant doit être inclus dans le formulaire d'entrée :
Paramètre Description Exemple de valeur

Une liste de codes de modes de paiement
séparés par une virgule à présenter au client.
payment_methods DID
Vous pourrez trouver une liste complète des
codes en Annexe V de ce manuel.
Si le paramètre ‘payment_methods’ est inclus dans le formulaire de redirection, le client verra

apparaître les options de paiement sélectionnées et leurs logos correspondants. S'il y a une
divergence dans la disponibilité de l'option, par exemple si une option spécifique à un pays
comme Ideal est choisie, alors que le client n'est pas résident néerlandais, la liste complète
des options de paiement disponibles sera présentée au client.
N.B. Avant de créer cette fonction, le marchand doit :
(i) Vérifier les modes de paiement autorisés par Moneybookers
(ii) Demander une liste mise à jour des modes de paiement et de leurs valeurs respectives
Les marchands peuvent fixer la version du portail partagé qu'ils veulent utiliser, fixe ou
flexible :

3.3.1 Portail partagé fixe
Lorsque le portail partagé fixe est activé et que le marchand envoie un payment_method,
seul ce mode de paiement apparaît au client après inscription ou connexion. Les clients
existants disposant d'un solde suffisant sur leur compte Moneybookers peuvent toujours
payer à partir de celui-ci. L'option du solde peut être désactivée, mais ce n'est pas conseillé.
3.3.2 Portail partagé flexible
Lorsque le portail partagé de type flexible est activé et que le marchand envoie un
payment_method, il est pré-sélectionné pour le client après inscription ou connexion. Tous
les autres modes de paiement activés pour le marchand et pour le pays d'inscription du
client sont disponibles. Si le payment_method n'est pas proposé par le pays d'inscription du
client, alors un message apparaîtra indiquant que ce type de paiement n'est pas proposé et
montrant tous les autres modes de paiement disponibles pour son pays.

3.4 Facturation récurrente
Moneybookers offre déjà un outil pour les paiements récurrents sur le site
moneybookers.com. Cette option est également disponible pour les marchands par
l'intermédiaire du portail. En plus des paramètres standard décrits au point 2.3.1, les
marchands peuvent fournir les paramètres suivants pour établir un paiement récurrent par
l'intermédiaire du portail :
Obligatoi Exemple de
Nom du champ Description
re valeur
Le montant du paiement qui aura lieu
rec_amount Oui/Non 19.90
pendant la période donnée
Date de début de la période pendant

rec_start_date laquelle le paiement récurrent sera Non* 21/12/2007
exécuté, au format JJ/MM/AAAA
Date de fin de la période au format

rec_end_date Non 31/08/2008
JJ/MM/AAAA
rec_period Durée entre les paiements Oui 14
Unité de temps requise par le marchand :

jour/mois/an. Si ce paramètre n'est pas
rec_cycle Non jour
envoyé, nous supposerons que le
rec_cycle est en jours
Le marchand peut fixer une période en

jours pendant laquelle le client peut
rec_grace_period encore exécuter la transaction si elle a Non 7
échoué initialement. La valeur soumise
sera toujours en jours
http://www.moneybook
URL auquel nous informons le marchand
rec_status_url Non ers.com/rec_payment_
de l'annulation du paiement récurrent
cancelled.htm
*
Si le paramètre rec_start_date n'est pas envoyé, le cycle de facturation récurrente
commencera immédiatement et le prochain paiement sera dû conformément aux valeurs de
rec_cycle et/ou rec_period.
Si la date rec_start_date est le 31 du mois et que la valeur rec_cycle est ‘month’, ceci est
interprété comme étant le dernier jour du mois, ex. la date suivante pour un paiement
mensuel commençant au 31 mai est le 30 juin.

Typiquement, l'établissement d'un paiement récurrent sera structuré comme l'une des
options suivantes :
• Option 1 : paiement ponctuel de 4,99 EUR, par exemple, et, en plus, des frais
d'inscription mensuels de 19,90 EUR
• Option 2 : paiement mensuel de 19,90 EUR
Le fait d'ajouter les paramètres ci-dessus au formulaire d'entrée permettra aux marchands
d'établir un paiement conformément à l'une des options. Un marchand peut laisser le
paramètre “amount” vierge et remplir uniquement le “rec_amount” afin d'offrir l'option 2,
ou entrer 4,99 EUR comme paramètre “amount” et 19,90 EUR comme “rec_amount” afin
d'offrir l'option 1.
Si une facturation récurrente a été établie et que le marchand a fourni un “status_url” dans
le formulaire d'entrée, le système de Moneybookers enverra les détails de la transaction
pour chaque paiement à l'URL fourni dans le paramètre “status_url”. Le tableau suivant
présente les paramètres devant être reçus à l'adresse status_url sur le serveur Web du
marchand :
Obligatoir
e
ID unique pour le compte moneybookers.com
du marchand. UNIQUEMENT nécessaire pour
merchant_id Oui 100005
le calcul de la signature MD5 (voir Annexe III)
Numéro de référence ou d'identification fourni

transaction_id par le marchand. Oui A205220
Statut du paiement récurrent : 2 exécuté/ -2

status Oui 2
échoué
rec_payment_id ID du paiement récurrent Oui 200005
rec_payment_type Type de paiement : ‘recurring’ ou ‘ondemand’ Oui récurrent
327638C253A4637199CEBA6
md5sig Signature MD5 (voir Annexe III) Oui
642371F20
Une liste de noms de champs séparés par une
virgule qui doit être renvoyée au serveur du
merchant_fields marchand lorsque le paiement est confirmé Non Champ1, Champ2
sur moneybookers.com (5 champs
maximum).

Options de paiement pour la facturation récurrente :

• Carte de crédit/paiement :
o Visa
o MasterCard
o Diners
o JCB
• Prélèvement automatique
• Solde du compte Moneybookers du client
Pour vérifier le statut, annuler ou prolonger la end_date d'un paiement récurrent, le

marchand peut utiliser notre Interface de requêtes des marchands telle qu'elle est décrite
dans notre Manuel d'interface de paiements automatisés.
3.5 Pay-on-demand
Moneybookers propose un service Pay-on-demand permettant aux marchands de débiter les

transactions automatiquement des comptes Moneybookers du client sans que le client doive
autoriser le prélèvement à chaque fois. L'établissement du service Pay-on-demand doit être
fait pendant la procédure normale de paiement. Le client est dûment invité à confirmer qu'il
autorise le marchand à effectuer des requêtes de type pay-on-demand. Si l'autorisation
n'est pas donnée, l'utilisateur peut toujours poursuivre ce paiement.
Vous devez contacter merchantservices@moneybookers.com afin d'être autorisé(e) à

utiliser ce service.
Le service Pay-on-demand est également disponible par l'intermédiaire de l'Interface de

paiements automatisés de Moneybookers (IPA). Pour des informations plus détaillées,
veuillez consulter notre Manuel d'interface de paiements automatisés.
En plus des paramètres standard décrits au point 2.3.1, les marchands peuvent fournir les
paramètres suivants pour établir un paiement pay-on-demand par l'intermédiaire du portail:


Montant maximal pour les prochains
paiements qui seront débités du
ondemand_max_amount Oui 11.50
compte du client
Code de 3 lettres de la devise dans

laquelle le montant maximal est
ondemand_max_currency exprimé, conformément à ISO 4217 Oui/Non EUR
(voir les devises acceptées en
Annexe I)
Nom du marchand débitera
Texte qui apparaîtra au client sur la
votre compte pour que vous
ondemand_note page de confirmation comme motif Oui
puissiez continuer à utiliser
pour le paiement Pay-on-demand
nos services.
#
Si ondemand_max_currency n'est pas fourni, sa valeur sera celle fournie comme currency
au point 2.3.1.
Après l'établissement d'un paiement Pay-on-demand, le marchand doit utiliser notre

Interface Pay-on-demand afin d'effectuer des requêtes particulières pour débiter le compte
Moneybookers du client. Vous pourrez trouver des détails sur la manière d'utiliser cette
interface dans notre Manuel d'interface de paiements automatisés. Si le marchand a fourni
une valeur “status_url” dans le formulaire d'entrée, le système Moneybookers enverra les
détails de la transaction de chaque paiement à cet URL.
Pour exécuter, vérifier le statut ou annuler une autorisation de pay-on-demand, le

marchand peut utiliser notre Interface de requêtes des marchands telle qu'elle est décrite
dans notre Manuel d'interface de paiements automatisés.
Options de paiement pour Pay-on-demand :

• Carte de crédit/paiement :
o Visa
o MasterCard
o Diners
o JCB
• Solde du compte Moneybookers du client

3.6 Paramètre return_url sécurisé
Cette fonction permet au marchand d'être sûr que le client est arrivé à l'adresse return_url en
terminant la procédure de paiement, PAS simplement en cherchant la valeur return_url dans
la source de la page et en l'entrant dans leur navigateur. Mais, cette fonction garantit
UNIQUEMENT que le client a terminé la procédure de paiement et PAS que le paiement a été
exécuté.
Afin d'utiliser cette fonction, le marchand doit en faire la demande par e-mail à
merchantservices@moneybookers.com. Une fois approuvé pour cette fonction, le marchand
doit s'assurer que les éléments suivants sont envoyés pour chaque transaction :
(i) paramètre return_url
(ii) paramètre transaction_id
(iii) mot secret (il sera envoyé automatiquement S'IL est entré dans votre ’Merchant
Tools’).
Une fois la fonction activée par notre Service Marchand et les éléments requis ci-dessus
envoyés, nous ajouterons les paramètres suivants à l'adresse return_url:
Paramètre Description Exemple de valeur

Il s'agit de la transaction_id envoyé par le
id A205220
marchand
Il s'agit du MD5 des valeurs suivantes :
- merchant_id ex. 123456
msid - transaction_id ex. A205220 730743ed4ef7ec631155f5e15d2f4fa0
- valeur MD5 en majuscules du mot secret
ex. F76538E261E8009140AF89E001341F17
Nous allons voir maintenant 2 exemples pratiques de return_url sécurisé en utilisant les
valeurs ci-dessus :

Exemple 1
Le marchand envoie un return_url SANS paramètres supplémentaires :
ex. https://merchant.com/return_url.cgi
Dans ce cas, Moneybookers redirigera le client vers :
https://merchant.com/return_url.cgi?id= A205220&msid=730743ed4ef7ec631155f5e15d2f4fa0
Exemple 2
Le marchand envoie un return_url AVEC des paramètres supplémentaires :
ex. https://merchant.com/return_url.cgi?par1=val1&par2=val2
Dans ce cas, Moneybookers redirigera le client vers :
https://merchant.com/return_url.cgi?par1=val1&par2=val2&id=A205220&msid=730743ed4ef7ec631155
f5e15d2f4fa0
3.7 Remboursements de la part du marchand
Les marchands veulent parfois rembourser un paiement sur le compte Moneybookers, la carte
de crédit/paiement ou le compte en banque du client (selon le mode de paiement utilisé
initialement). Veuillez contacter votre gestionnaire de compte ou écrire à
merchantservices@moneybookers.com si vous voulez rendre cette fonction disponible.
Si votre compte a été configuré pour permettre les remboursements de la part du marchand,
vous disposerez d'un lien d'action supplémentaire dans votre historique de transaction près
de chaque entrée qui entraînera un remboursement du client.
Les marchands peuvent également effectuer des remboursements par l'intermédiaire de

l'Interface de paiements automatisés de Moneybookers (IPA). Pour des informations plus
détaillées, veuillez consulter notre Manuel d'interface de paiements automatisés.

3.8 Avis d’opposition
Si votre compte Moneybookers a été réglé pour accepter des oppositions, vous recevrez un
avis d’opposition dans le rapport envoyé à status_url. Chaque fois que nous recevrons une
requête d’opposition de notre fournisseur, nous vous enverrons un rapport de statut mis à
jour avec le statut -3 pour la transaction opposée. (Voir le point 2.3.7 pour une description
détaillée des statuts de transaction).
3.9 Descripteur dynamique
La fonction Descripteur dynamique permet au marchand de faire apparaître son nom ou sa

marque sur le relevé bancaire ou de carte de crédit du client. Cette fonction est uniquement
disponible pour les modes de paiement suivants :
• Visa
• MasterCard
• Sofortueberweisung
Afin d'utiliser cette fonction, le marchand doit en faire la demande par e-mail à
merchantservices@moneybookers.com. Une fois cette fonction approuvée, Moneybookers
enverra le Descripteur dynamique au nom du marchand pour chaque transaction. Pour
Sofortuberweisung et Direct Debit, le marchand peut également envoyer un paramètre
supplémentaire qui remplacera la valeur par défaut enregistrée par Moneybookers. Les
détails sont :
Nom du
Description Exemple de valeur
champ
Nom du marchand à faire apparaître sur le
relevé de compte en banque du client. La valeur
dynamic_descriptor ne peut être composée que de caractères Nom du marchand
alphanumériques. Sa longueur maximale est de
100 caractères.

3.10 Portail réduit
Pour les marchands souhaitant intégrer le portail dans une iframe, nous conseillons
l'utilisation de notre Portail réduit. Ceci réduit la largeur du portail comme vous pouvez le
voir ci-dessous :
Les marchands peuvent fournir le paramètre suivant pour afficher le portail réduit :
Nom du
Description Valeur
champ
Les marchands peuvent faire apparaître à leurs clients
hide_login la page du portail sans la partie importante de 1
connexion.

3.11 Cible Iframe
Cette fonction permet au marchand d'intégrer plus facilement le portal dans une iframe. Le
marchand peut choisir l'ensemble de cadres dans lequel le return_url/cancel_urls doit être
ouvert après exécution/annulation du paiement par le client.
Cette fonction est établie en envoyant 2 paramètres supplémentaires à chaque requête de

paiement :
Valeur
Nom du
Description Valeurs par Exemple
champ
défaut
1 = '_top'
2 = '_parent'
return_url_target return_url apparaîtra suite à la validation 1 1
3 = '_self'
du paiement effectué par le client.
4= '_blank'
1 = '_top'
2 = '_parent'
cancel_url_target cancel_url apparaîtra suite à l'annulation 1 1
3 = '_self'
du paiement du client.
4= '_blank'
Conformément à W3Cs’ HTML specification, l'envoi de ces valeurs devrait avoir l'effet
suivant :
Valeur Equivalent Description
1 '_top' Charge le lien dans le cadre supérieur ; la nouvelle page remplit toute la fenêtre.
"_parent" est utilisé dans le cas où un fichier d'ensemble de cadres est niché à
l'intérieur d'un autre fichier d'ensemble de cadres. Un lien dans l'un des documents
2 '_parent'
de l'ensemble de cadres interne qui utilise "_parent" chargera le nouveau document
à l'endroit de l'ensemble de cadres interne.
Charge le nouveau document dans la même fenêtre et le même cadre que le
3 '_self' document actuel. Utiliser "_self" a le même effet que de ne pas utiliser la fonction
cible iframe.
4 '_blank' Ouvre le nouveau document dans une nouvelle fenêtre

4 Annexe I – Devises ISO 4217
Devises ISO 4217 acceptées sur Moneybookers

EUR Euro TWD Dollar taïwanais
USD Dollar américain THB Baht thaïlandais
GBP Livre sterling CZK Couronne tchèque
HKD Dollar de Hong-Kong HUF Forint hongrois
SGD Dollar de Singapour SKK Couronne slovaque
JPY Yen japonais EEK Couronne estonienne
CAD Dollar canadien BGN Lev bulgare
AUD Dollar australien PLN Zloty polonais
CHF Franc suisse ISK Couronne islandaise
DKK Couronne danoise INR Roupie indienne
SEK Couronne suédoise LVL Lats letton
Couronne
NOK norvégienne KRW Won de Corée du Sud
Rand d'Afrique du
ILS Shekel israélien ZAR Sud
MYR Ringgit malais RON Nouveau leu roumain
NZD Dollar néo-zélandais HRK Kuna croate
TRY Nouvelle livre turque LTL Litas lituanien

5 Annexe II – Codes ISO des pays à 3 lettres
Moneybookers n'accepte PAS les clients des pays suivants : Afghanistan, Cuba, Myanmar,
Nigeria, Corée du Nord, Soudan
Codes ISO des pays :
Afghanistan AFG Bouvet, Île BVT Djibouti DJI

Åland, Îles ALA Brésil BRA Dominique DMA
Dominicaine,
Albanie ALB Brunéi Darussalam BRN République DOM
Algérie DZA Bulgarie BGR Équateur ECU
Samoa américaine ASM Burkina Faso BFA Égypte EGY
Andorre AND Burundi BDI El Salvador SLV
Angola AGO Cambodge KHM Guinée équatoriale GNQ
Anguilla AIA Cameroun CMR Érythrée ERI
Antarctique ATA Canada CAN Estonie EST
Antigua et Barbuda ATG Cap-Vert CPV Éthiopie ETH
Falkland, Îles
Argentine ARG Caïmanes, Îles CYM (Malvinas) FLK
Centrafricaine,
Arménie ARM République CAF Féroé, Îles FRO
Aruba ABW Tchad TCD Fidji FJI
Australie AUS Chili CHL Finlande FIN
Autriche AUT Chine CHN France FRA
Azerbaïdjan AZE Christmas, Île CXR Guyane française GUF
Bahamas BHS Cocos (Keeling), Îles CCK Polynésie française PYF

Terres australes
Bahreïn BHR Colombie COL françaises ATF
Bangladesh BGD Comores COM Gabon GAB
Barbade BRB Congo, République du COG Gambie GMB
Congo, La République
Bélarus BLR démocratique du COD Géorgie GEO
Belgique BEL Cook, Îles COK Allemagne DEU
Belize BLZ Costa Rica CRI Ghana GHA
Bénin BEN Côte d'Ivoire CIV Gibraltar GIB
Bermudes BMU Croatie HRV Grèce GRC
Bhoutan BTN Cuba CUB Groenland GRL
Bolivie BOL Chypre CYP Grenade GRD
Bosnie-Herzégovine BIH Tchèque, République CZE Guadeloupe GLP

Botswana BWA Danemark DNK Guam GUM

Guatemala GTM Mayotte MYT Sénégal SEN
Guernesey GGY Mexique MEX Serbie SRB
Micronésie, États
Guinée GIN fédérés de FSM Seychelles SYC
Guinée-Bissau GNB Moldova MDA Sierra Leone SLE
Guyana GUY Monaco MCO Singapour SGP
Haïti HTI Mongolie MNG Slovaquie SVK
Heard, Île et
McDonald, Îles HMD Monténégro MNE Slovénie SVN
Saint-Siège (État de la
Cité du Vatican) VAT Montserrat MSR Salomon, Îles SLB
Honduras HND Maroc MAR Somalie SOM
Hong-Kong HKG Mozambique MOZ Afrique du Sud ZAF
Géorgie du Sud et les
Hongrie HUN Myanmar MMR Îles Sandwich du Sud SGS
Islande ISL Namibie NAM Espagne ESP
Inde IND Népal NPL Sri Lanka LKA
Indonésie IDN Pays-Bas NLD Soudan SDN
Iran, République
islamique d' IRN Antilles néerlandaises ANT Suriname SUR
Svalbard et Île Jan
Iraq IRQ Nouvelle-Calédonie NCL Mayen SJM
Irlande IRL Nouvelle-Zélande NZL Swaziland SWZ
Île de Man IMN Nicaragua NIC Suède SWE
Israël ISR Niger NER Suisse CHE
Syrienne, République
Italie ITA Nigeria NGA arabe SYR
Taïwan, Province de
Jamaïque JAM Niué NIU Chine TWN
Japon JPN Norfolk, Île NFK Tadjikistan TJK
Mariannes du Nord, Tanzanie, République-
Jersey JEY Îles MNP Unie de TZA
Jordanie JOR Norvège NOR Thaïlande THA
Kazakhstan KAZ Oman OMN Timor-Leste TLS
Kenya KEN Pakistan PAK Togo TGO
Kiribati KIR Palaos PLW Tokelau TKL
Corée, République
populaire Palestinien occupé,
démocratique de PRK Territoire PSE Tonga TON
Corée, République de KOR Panama PAN Trinité-et-Tobago TTO
Papouasie-Nouvelle-
Koweït KWT Guinée PNG Tunisie TUN
Kirghizistan KGZ Paraguay PRY Turquie TUR
Lao, République
démocratique
populaire LAO Pérou PER Turkménistan TKM

Lettonie LVA Philippines PHL Turks et Caïques, Îles TCA

Liban LBN Pitcairn PCN Tuvalu TUV
Lesotho LSO Pologne POL Ouganda UGA
Libéria LBR Portugal PRT Ukraine UKR
Libyenne, Jamahiriya
arabe LBY Porto Rico PRI Émirats arabes unis ARE
Liechtenstein LIE Qatar QAT Royaume-Uni GBR
Lituanie LTU Réunion REU États-Unis USA
Îles mineures
éloignées des États-
Luxembourg LUX Roumanie ROU Unis UMI
Macao MAC Russie, Fédération de RUS Uruguay URY
Macédoine, l'ex-
République yougoslave
de MKD Rwanda RWA Ouzbékistan UZB
Madagascar MDG Sainte-Hélène SHN Vanuatu VUT
Malawi MWI Saint-Kitts-et-Nevis KNA Venezuela VEN
Malaisie MYS Sainte-Lucie LCA Viet Nam VNM
Saint-Martin (partie Îles Vierges
Maldives MDV française) MAF britanniques VGB
Saint-Pierre-et- Îles Vierges des États-
Mali MLI Miquelon SPM Unis VIR
Saint-Vincent-et-les
Malte MLT Grenadines VCT Wallis et Futuna WLF
Marshall, Îles MHL Samoa WSM Sahara occidental ESH
Martinique MTQ Saint-Marin SMR Yémen YEM
Mauritanie MRT Sao Tomé-et-Principe STP Zambie ZMB
Maurice MUS Arabie saoudite SAU Zimbabwe ZWE

6 Annexe III – Signature MD5
Un champ texte caché appelé md5sig est inclus dans le formulaire envoyé au serveur du
marchand. La valeur de ce champ est une empreinte numérique de 128 bits, exprimée sous
forme de chaîne de trente-deux caractères hexadécimaux en MAJUSCULES. Le md5sig est
établi en effectuant un calcul MD5 sur une chaîne de caractères réalisé en enchaînant les
autres champs renvoyés à l'adresse status_url. Explicitement, la fonction de hachage MD5
est un enchaînement des champs suivants :
• merchant_id
• transaction_id
• la valeur MD5 en majuscules du mot secret envoyé dans la section "Outils
Marchands" du compte Moneybookers en ligne du marchand.
• mb_amount
• mb_currency
• status
Le but du champ md5sig est d'assurer l'intégrité des données renvoyées au serveur du
marchand. Veuillez toujours comparer la valeur du champ md5sig envoyée par les serveurs
de Moneybookers à celle que vous avez calculée vous-même. Afin de la calculer vous-
même, vous devez simplement prendre les valeurs des champs répertoriés ci-dessus
exactement comme si elles vous étaient renvoyées, les enchaîner et effectuer un calcul MD5
sur cette chaîne de caractères.
Remarque : Le mot secret DOIT être envoyé dans la section ‘Merchant Tools’ en minuscules
avant de pouvoir utiliser le md5sig. Si vous insérez des symboles en majuscules, ils seront
automatiquement convertis en minuscules. La seule restriction pour votre mot secret est sa
longueur, qui ne doit pas dépasser les 10 caractères. Des symboles non alphanumériques
peuvent être utilisés. Si la section ’Merchant Tools’ ("Outils Marchands") n'apparaît pas dans
votre compte, veuillez contacter merchantservices@moneybookers.com

Annexe IV – Exemples de formulaires HTML
Vous trouverez ci-dessous deux exemples de formulaires HTML que les marchands peuvent
utiliser sur leur site Internet pour rediriger les clients vers les serveurs Web de
Moneybookers afin d'effectuer un paiement. Le premier est l'exemple pratique le plus simple
qu'un marchand puisse utiliser. Le second exemple utilise plusieurs fonctions actuellement
offertes par le portail de Moneybookers.
Les champs surlignés en jaune doivent être remplacés par des valeurs correspondantes
valables.
Remarque : Vous pouvez utiliser, à des fins expérimentales, notre formulaire de test que
vous trouverez sur https://www.moneybookers.com/app/test_payment.pl. Veuillez d'abord
contacter merchantservices@moneybookers.com pour recevoir des comptes tests et des
données tests.
6.1 Formulaire HTML simple
<form action="https://www.moneybookers.com/app/payment.pl" method="post" target="_blank">

<input type="hidden" name="pay_to_email" value="merchant@moneybookers.com">
<input type="hidden" name="status_url" value="merchant@moneybookers.com">
<input type="hidden" name="language" value="EN">
<input type="hidden" name="amount" value="39.60">
<input type="hidden" name="currency" value="GBP">
<input type="hidden" name="detail1_description" value="Description :">
<input type="hidden" name="detail1_text" value="Roméo et Juliette (W. Shakespeare)">
<input type="hidden" name="confirmation_note" value="Nomdumarchand espère que vous
apprécierez votre nouveau livre !">
<input type="submit" value="Payer !">
</form>

6.2 Formulaire HTML plus évolué
<form action="https://www.moneybookers.com/app/payment.pl" method="post" target="_blank">

<input type="hidden" name="pay_to_email" value="merchant@moneybookers.com">
<input type="hidden" name="transaction_id" value="A10005">
<input type="hidden" name="return_url"
value="http://www.moneybookers.com/payment_made.html">
<input type="hidden" name="cancel_url"
value="http://www.moneybookers.com/payment_cancelled.html">
<input type="hidden" name="status_url"
value="https://www.moneybookers.com/process_payment.cgi">
<input type="hidden" name="language" value="EN">
<input type="hidden" name="merchant_fields" value="customer_number, session_id">
<input type="hidden" name="customer_number" value="C1234">
<input type="hidden" name="session_ID" value="A3DFA2234">
<input type="hidden" name="pay_from_email" value="payeur@moneybookers.com">
<input type="hidden" name="amount2_description" value="Prix du produit :">
<input type="hidden" name="amount2" value="29.90">
<input type="hidden" name="amount3_description" value="Frais de port :">
<input type="hidden" name="amount4_description" value="TVA (20%) :">
<input type="hidden" name="amount" value="39.60">
<input type="hidden" name="currency" value="GBP">
<input type="hidden" name="firstname" value="John">
<input type="hidden" name="lastname" value="Payeur">
<input type="hidden" name="address" value="Ruedupayeur">
<input type="hidden" name="postal_code" value="EC45MQ">
<input type="hidden" name="city" value="Villedupayeur">
<input type="hidden" name="country" value="GBR">
<input type="hidden" name="detail1_description" value="ID du produit :">
<input type="hidden" name="detail1_text" value="4509334">
<input type="hidden" name="detail2_description" value="Description :">
<input type="hidden" name="detail2_text" value="Roméo et Juliette (W. Shakespeare)">
<input type="hidden" name="detail3_description" value="Conditions spéciales :">
<input type="hidden" name="detail3_text" value="Livraison sous 5 à 6 jours">
<input type="hidden" name="confirmation_note" value="Nomdumarchand espère que vous
apprécierez votre nouveau livre !">
<input type="submit" value="Payer !">
</form>

7 Annexe V – Codes des paiements sur le portail partagé
Le tableau suivant détaille les codes requis pour chaque mode de paiement lorsque l'on
utilise le portail partagé :
Mode de paiement Valeur Remarques

Porte-monnaie Moneybookers WLT
Cartes de crédit/paiement
Tous les types de cartes ACC
Visa VSA
MasterCard MSC
Visa Delta/Debit (Royaume-Uni) VSD
Visa Electron VSE
Maestro (Royaume-Uni , Espagne et
Autriche) MAE
Solo (Royaume-Uni) SLO
American Express AMX
Diners DIN
JCB JCB
Laser (Rép. d'Irlande) LSR
Carte Bleue GCB
Cartes de paiement chinoises NET
Dankort DNK
PostePay PSP
CartaSi CSI
Virements bancaires instantanés
Giropay (Allemagne) GIR
Direct Debit (Allemagne) DID
Sofortueberweisung (Allemagne) SFT
eNETS (Singapour) ENT
Nordea Solo (Suède) EBT
Nordea Solo (Finlande) SO2
ideal (Pays-Bas) IDL
EPS (Netpay) Autriche NPY
POLi (Australie) PLI
Toutes les banques polonaises PWY
ING Bank Śląski PWY5
PKO BP (PKO Inteligo) PWY6
Multibank (Multitransfer) PWY7
Lukas Bank PWY14
Bank BPH PWY15
InvestBank PWY17
PeKaO S.A. PWY18
Citibank handlowy PWY19
Bank Zachodni WBK (Przelew24) PWY20
BGŻ PWY21
Millenium PWY22
mBank (mTransfer) PWY25
Płacę z Inteligo PWY26
Bank Ochrony Środowiska PWY28
Nordea PWY32
Fortis Bank PWY33
Deutsche Bank PBC S.A. PWY36

Moneybookers Gateway Manual

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Moneybookers Gateway Manual

Enviado por

Direitos autorais:

Formatos disponíveis

Moneybookers Ltd.

Portail de paiement de Moneybookers

Portail de paiement de Moneybookers 7 janvier 2009

2 DÉTAILS SUR LE PORTAIL DE PAIEMENT ........................................................ 4

3 CARACTÉRISTIQUES SUPPLÉMENTAIRES DU PORTAIL ................................. 23

4 ANNEXE I – DEVISES ISO 4217 ................................................................... 37

5 ANNEXE II – CODES ISO DES PAYS À 3 LETTRES .......................................... 38

6 ANNEXE III – SIGNATURE MD5 .................................................................... 41

7 ANNEXE V – CODES DES PAIEMENTS SUR LE PORTAIL PARTAGÉ .................. 44

Non classé ©Moneybookers Ltd, 2009 Page 2 sur 44

Portail de paiement de Moneybookers 7 janvier 2009

Le portail de paiement de Moneybookers permet aux marchands de recevoir de l'argent de

Non classé ©Moneybookers Ltd, 2009 Page 3 sur 44

Portail de paiement de Moneybookers 7 janvier 2009

2 Détails sur le portail de paiement

Le portail de paiement de Moneybookers requiert que le marchand modifie sa page de

Non classé ©Moneybookers Ltd, 2009 Page 4 sur 44

Portail de paiement de Moneybookers 7 janvier 2009

2.2 Diagramme d'interaction

Non classé ©Moneybookers Ltd, 2009 Page 5 sur 44

Portail de paiement de Moneybookers 7 janvier 2009

2.3 Procédure de paiement par étapes

2.3.1 Redirection du client vers le portail de Moneybookers Étape 1

Non classé ©Moneybookers Ltd, 2009 Page 6 sur 44

Portail de paiement de Moneybookers 7 janvier 2009

Paramètres à envoyer au portail de Moneybookers :

Nom du champ Description Obligatoire Exemple de valeur

Informations sur le marchand

recipient_description Une description du marchand, qui apparaîtra

transaction_id Numéro de référence ou d'identification fourni

Précise une cible dans laquelle la valeur

Non classé ©Moneybookers Ltd, 2009 Page 7 sur 44

Portail de paiement de Moneybookers 7 janvier 2009

Nom du champ Description Obligatoire Exemple de valeur

status_url URL auquel les détails de la transaction seront

status_url2 Second URL auquel les détails de la https://www.merchant.com/proces

language Code de 2 lettres de la langue dans laquelle

hide_login Les marchands peuvent faire apparaître à

confirmation_note Le marchand peut faire apparaître au client,

logo_url L'URL du logo que vous souhaitez faire

prepare_only Force seulement à renvoyer le SID sans la

Non classé ©Moneybookers Ltd, 2009 Page 8 sur 44

Portail de paiement de Moneybookers 7 janvier 2009

Nom du champ Description Obligatoire Exemple de valeur

merchant_fields Une liste de noms de champs séparés par une

field 1 Un exemple de champ du marchand Non Valeur 1

field 2 Un exemple de champ du marchand Non Valeur 2

Informations sur le client

title Titre de civilité du client. Valeurs acceptées :

firstname Prénom du client Non John

lastname Nom de famille du client Non Payeur

Date de naissance du client. Le format est

address Adresse du client (ex. rue) Non Ruedupayeur

address2 Adresse du client (ex. ville) Non Villedupayeur

phone_number Numéro de téléphone du client. Seules des

postal_code Code postal/ZIP du client. Seules des valeurs

city Ville du client Non Londres

state État ou région du client. Non Centre de Londres

country Pays du client - Code ISO de 3 lettres (voir la

Détails relatifs au paiement

Non classé ©Moneybookers Ltd, 2009 Page 9 sur 44

Portail de paiement de Moneybookers 7 janvier 2009

Nom du champ Description Obligatoire Exemple de valeur

currency Code de 3 lettres de la devise dans laquelle le