Vous êtes sur la page 1sur 44

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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)

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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.

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

2.2 Diagramme d'interaction

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


Manuel d'intégration des marchands Version <6.6>

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

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.

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


Manuel d'intégration des marchands Version <6.6>

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


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.

Précise une cible dans laquelle la valeur


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

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

Nom du champ Description Obligatoire Exemple de valeur


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

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

Nom du champ Description Obligatoire Exemple de valeur


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

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

Nom du champ Description Obligatoire Exemple de valeur


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

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

Nom du champ Description Obligatoire Exemple de valeur


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.

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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.

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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.

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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


de la Politique de confidentialité

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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.

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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).

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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 :

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

Nom du champ Description Obligatoire Exemple de valeur

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.

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

**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.

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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.

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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.

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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 :

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,
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 :

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

Nom du champ Description Exemple de valeur

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

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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 :

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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.

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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.

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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
Nom du champ Description Exemple de valeur
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).

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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:

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

Nom du champ Description Obligatoire Exemple de valeur


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
• Prélèvement automatique
• Solde du compte Moneybookers du client

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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 :

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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.

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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
• Prélèvement automatique

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.

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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.

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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'
Précise une cible dans laquelle la valeur
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'
Précise une cible dans laquelle la valeur
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

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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>

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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="amount3" value="3.10">
<input type="hidden" name="amount4_description" value="TVA (20%) :">
<input type="hidden" name="amount4" value="6.60">
<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>

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


Manuel d'intégration des marchands Version <6.6>

Portail de paiement de Moneybookers 7 janvier 2009

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

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