Upload
darkdoudou
View
280
Download
3
Embed Size (px)
Citation preview
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
Non classé ©Moneybookers Ltd, 2009 Page 2 sur 44
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
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 3 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 : [email protected]
Téléphone : +44 870 383 0762 (Lundi - Dimanche, 9:00 - 17:00 GMT)
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 4 sur 44
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.
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 5 sur 44
2.2 Diagramme d'interaction
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 6 sur 44
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 [email protected] et nous fixerons des comptes tests et des
données tests à des fins expérimentales.
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 7 sur 44
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 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 bénéficiaire du paiement. (30 caractères maxi)
Non CompanyName
transaction_id Numéro de référence ou d'identification fourni par le marchand. DOIT être unique pour chaque paiement (32 caractères maxi)
Non A205220
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 retourne à la dernière page du site Internet du marchand sur laquelle il se trouvait antérieurement. Une fonction return_url sécurisée est disponible. Veuillez voir la section 3.5.
Non http://www.merchant.com/payment_made.htm
return_url_text Le texte figurant sur le bouton lorsque l'utilisateur a terminé son paiement.
Non Return to Sample Merchant
return_url_target
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.
1 = '_top' 2 = '_parent' 3 = '_self' 4= '_blank'
Non 1
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 automatiquement après avoir cliqué sur le 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.
Non http://www.merchant.com/payment_cancelled.htm
cancel_url_target
Précise une cible dans laquelle la valeur cancel_url sera nommée suite à l'annulation du paiement du client. La valeur par défaut est 1.
Non 1
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 8 sur 44
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 terminée. Sinon, vous pouvez préciser l'adresse e-mail à laquelle vous souhaitez recevoir les résultats.
Si le status_url n'est pas renseigné, aucun détail de transaction ne sera envoyé au marchand.
Non
https://www.merchant.com/process_payment.cqi
OU
mailto: [email protected]
status_url2 Second URL auquel les détails de la transaction seront envoyés une fois la procédure de paiement terminée. Sinon, vous pouvez préciser l'adresse e-mail à laquelle vous souhaitez recevoir les résultats.
Non
https://www.merchant.com/process_payment.cgi
OU
mailto: [email protected]
language Code de 2 lettres de la langue dans laquelle s'affichent les pages de Moneybookers. Peut être EN, DE, ES, FR, IT, PL, GR, RO, RU, TR, CN, CZ, NL, DA, SV ou FI.
Oui EN
hide_login Les marchands peuvent faire apparaître à leurs clients la page du portail sans la partie importante de connexion. Voir le point 3.10 pour une explication plus détaillée.
Non 1
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 confirmation, un PIN ou tout autre message. Des sauts de ligne <br> peuvent être utilisés pour les longs messages.
Non Nom du marchand espère que vous apprécierez votre nouveau livre !
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 s'affichera pas. Pour une meilleure intégration, nous conseillons aux marchands d'utiliser des logos de dimensions allant jusqu'à 200px de large et 50px de haut.
Non https://www.merchant.com/logo.jpeg
prepare_only Force seulement à renvoyer le SID sans la page en question. Utile lorsque que vous 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 1
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 9 sur 44
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é sur moneybookers.com (5 champs maximum).
Non Champ1, Champ2
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 doit indiquer son adresse e-mail lui-même.
title Titre de civilité du client. Valeurs acceptées : M., Mme ou Mlle
Non M.
firstname Prénom du client Non John
lastname Nom de famille du client Non Payeur
date_of_birth Date de naissance du client. Le format est mmjjaaaa. Seules des valeurs numériques sont acceptées
Non 01121980
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 valeurs numériques sont acceptées
Non 0207123456
postal_code Code postal/ZIP du client. Seules des valeurs alphanumériques sont acceptées (pas de signes de ponctuation, etc.)
Non EC45MQ
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 liste des codes autorisés en Annexe II).
Non GBR
Détails relatifs au paiement
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 10 sur 44
Nom du champ Description Obligatoire Exemple de valeur
amount Le montant total à payer. Veuillez noter que vous devez supprimer les zéros à droite si le montant est un nombre naturel Oui
39.68 OU 39.6 OU 39
currency Code de 3 lettres de la devise dans laquelle le montant est exprimé, conformément à ISO 4217 (voir les devises acceptées en Annexe I)
Oui EUR
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 données ; elles apparaissent uniquement dans la section "Plus d'informations" dans l'en-tête du portail.
Non Prix du produit :
amount2 Ce montant, exprimé dans la devise définie dans le champ 'currency', apparaîtra près de amount2_description.
Non 29.90
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 section "Plus d'informations" dans l'en-tête du portail.
Oui ID du produit :
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 historique sur le site Internet de Moneybookers.
Oui 4509334
detail2_description Voir ci-dessus Non Description :
detail2_text Voir ci-dessus Non
Roméo et Juliette
(W. Shakespeare)
detail3_description Voir ci-dessus Non Conditions spéciales :
detail3_text Voir ci-dessus Non Livraison sous 5 à 6 jours
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 11 sur 44
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.
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 12 sur 44
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.
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 13 sur 44
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.
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 14 sur 44
Étape 1 – Choix du mode de paiement et entrée des coordonnées personnelles :
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 15 sur 44
Étape 2 – Création du mot de passe et acceptation des Conditions générales d'utilisation et
de la Politique de confidentialité
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 16 sur 44
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 paiement
Comment ça marche Accord spécial requis
Délai
Pay from e-
wallet balance
Si le client a suffisamment de fonds dans son porte-monnaie
électronique Moneybookers, le montant est déduit
directement du solde disponible. Ceci est la manière la plus
rapide de payer et le client est directement envoyé à l'étape
de confirmation (Étape 3).
Non ; activé pour
tous les marchands Instantané
Pending bank
transfer
Avec ce mode de paiement, une transaction en attente est
créée sur le compte du client et de plus amples instructions
lui sont données sur la manière d'effectuer un paiement par
virement bancaire hors ligne à Moneybookers. Dès
réception du virement sur le compte en banque de
Moneybookers, l'argent est transféré sur le compte du
marchand et la transaction apparaît ‘Status’ 2 – exécutée.
De plus, un e-mail est envoyé au marchand l'avisant du
paiement exécuté.
Non ; activé pour
tous les
marchands. Si
vous voulez cesser
d'accepter ce mode
de paiement,
veuillez contacter
merchantservices@
moneybookers.com
.
2-3 jours
Moneybookers
Direct
Moneybookers Direct permet aux clients d'effectuer des
paiements directement au marchand sans devoir
approvisionner au préalable leur porte-monnaie
électronique. Parmi les options de paiement actuelles, on
compte les cartes de crédit/paiement (internationales et
locales), les prélèvements automatiques et les virements
bancaires instantanés, tels que Giropay, Sofortüberweisung
(Allemagne), Przelewy24 (Pologne), POLi (Australie) et
iDEAL (Pays-Bas). Voir la liste de tous les modes de
paiement Moneybookers Direct disponibles en Annexe V.
Oui - Veuillez
contacter
merchantservices@
moneybookers.com
pour commencer à
accepter
Moneybookers
Direct
Instantané*
* 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.
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 17 sur 44
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).
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 18 sur 44
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 :
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 19 sur 44
*Pour recevoir la valeur customer_id, veuillez contacter le gestionnaire de votre compte ou [email protected].
Nom du champ Description Obligatoire Exemple de valeur
pay_to_email Adresse e-mail du marchand. Oui [email protected]
pay_from_email Adresse e-mail du client qui effectue le paiement, c'est-à-dire qui envoie l'argent.
merchant_id
ID unique pour le compte moneybookers.com du marchand. UNIQUEMENT nécessaire pour le calcul de la signature MD5 (voir Annexe III)
Oui 100005
customer_id ID unique pour le compte moneybookers.com du client.
Non* 200005
transaction_id Numéro de référence ou d'identification fourni par le marchand.
Non** A205220
mb_transaction_id ID de transaction unique de Moneybookers pour le virement.
Oui 200234
mb_amount Le montant total du paiement exprimé dans la devise du marchand.
Oui 25.46 / 25.4 / 25
mb_currency
Devise de mb_amount. Sera toujours identique à la devise dans laquelle le compte du bénéficiaire est exprimé sur Moneybookers.
Oui GBP
status
Statut de la transaction : -2 échouée / 2 exécutée / 0 en attente / -1 annulée (voir l'explication détaillée ci-dessous)
Oui 2
md5sig Signature MD5 (voir Annexe III) Oui 327638C253A4637199CEBA6642371F20
amount Le montant du paiement tel qu'il est envoyé par le marchand dans le formulaire d'entrée.
Oui 39.60 / 39.6 / 39
currency La devise dans laquelle est exprimé le paiement tel qu'il est envoyé par le marchand dans le formulaire d'entrée
Oui EUR
payment_type
Avec le payment_type, le marchand peut différencier les paiements ordinaires "porte-monnaie" (WLT), les paiements par virements bancaires (PBT) et les paiements Moneybookers Direct (MBD).
Non*** WLT
merchant_fields
Si le marchand a envoyé une liste de valeurs dans le paramètre merchant_fields, elles seront renvoyées avec le rapport de statut.
Non field1=value1
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 20 sur 44
**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 [email protected]
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.
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 21 sur 44
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
[email protected] pour plus d'informations.
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 22 sur 44
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.
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 23 sur 44
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 à
[email protected] 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
country Pays du client - Code ISO de 3 lettres (voir la liste des codes autorisés en Annexe II).
GBR
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
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 24 sur 44
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 à
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
country Pays du client - Code ISO de 3 lettres (voir la liste des codes autorisés en Annexe II).
GBR
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 :
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 25 sur 44
Nom du champ Description Exemple de valeur
firstname Prénom du client. Cette valeur sera pré-remplie si le marchand l'envoie par l'intermédiaire du paramètre `firstname’
John
lastname
Nom de famille du client. Cette valeur sera pré-remplie si le marchand l'envoie par l'intermédiaire du paramètre `lastname’
Payeur
date_of_birth
Date de naissance du client. Cette valeur sera pré-remplie si le marchand l'envoie par l'intermédiaire du paramètre `date_of_birth’
01121980
pay_from_email
E-mail du client. Cette valeur sera pré-remplie si le marchand l'envoie par 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
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 26 sur 44
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
payment_methods
Une liste de codes de modes de paiement séparés par une virgule à présenter au client. Vous pourrez trouver une liste complète des codes en Annexe V de ce manuel.
DID
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 :
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 27 sur 44
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.
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 28 sur 44
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 :
Nom du champ Description Obligatoire
Exemple de valeur
rec_amount Le montant du paiement qui aura lieu pendant la période donnée
Oui/Non 19.90
rec_start_date Date de début de la période pendant laquelle le paiement récurrent sera exécuté, au format JJ/MM/AAAA
Non* 21/12/2007
rec_end_date Date de fin de la période au format JJ/MM/AAAA
Non 31/08/2008
rec_period Durée entre les paiements Oui 14
rec_cycle
Unité de temps requise par le marchand : jour/mois/an. Si ce paramètre n'est pas envoyé, nous supposerons que le rec_cycle est en jours
Non jour
rec_grace_period
Le marchand peut fixer une période en jours pendant laquelle le client peut encore exécuter la transaction si elle a échoué initialement. La valeur soumise sera toujours en jours
Non 7
rec_status_url URL auquel nous informons le marchand de l'annulation du paiement récurrent
Non http://www.moneybookers.com/rec_payment_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.
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 29 sur 44
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 :
Nom du champ Description Obligatoir
e Exemple de valeur
merchant_id
ID unique pour le compte moneybookers.com du marchand. UNIQUEMENT nécessaire pour le calcul de la signature MD5 (voir Annexe III)
Oui 100005
transaction_id Numéro de référence ou d'identification fourni par le marchand.
Oui A205220
status Statut du paiement récurrent : 2 exécuté/ -2 échoué
Oui 2
rec_payment_id ID du paiement récurrent Oui 200005
rec_payment_type Type de paiement : ‘recurring’ ou ‘ondemand’ Oui récurrent
md5sig Signature MD5 (voir Annexe III) Oui 327638C253A4637199CEBA6642371F20
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é sur moneybookers.com (5 champs maximum).
Non Champ1, Champ2
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 30 sur 44
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 [email protected] 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:
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 31 sur 44
Nom du champ Description Obligatoire Exemple de valeur
ondemand_max_amount
Montant maximal pour les prochains paiements qui seront débités du compte du client
Oui 11.50
ondemand_max_currency
Code de 3 lettres de la devise dans laquelle le montant maximal est exprimé, conformément à ISO 4217 (voir les devises acceptées en Annexe I)
Oui/Non EUR
ondemand_note Texte qui apparaîtra au client sur la page de confirmation comme motif pour le paiement Pay-on-demand
Oui
Nom du marchand débitera votre compte pour que vous puissiez continuer à utiliser 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
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 32 sur 44
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 à
[email protected]. 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
id Il s'agit de la transaction_id envoyé par le marchand
A205220
msid
Il s'agit du MD5 des valeurs suivantes :
- merchant_id ex. 123456
- transaction_id ex. A205220
- valeur MD5 en majuscules du mot secret
ex. F76538E261E8009140AF89E001341F17
730743ed4ef7ec631155f5e15d2f4fa0
Nous allons voir maintenant 2 exemples pratiques de return_url sécurisé en utilisant les
valeurs ci-dessus :
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 33 sur 44
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 à
[email protected] 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.
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 34 sur 44
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 à
[email protected]. 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 champ Description Exemple de valeur
dynamic_descriptor
Nom du marchand à faire apparaître sur le relevé de compte en banque du client. La valeur ne peut être composée que de caractères alphanumériques. Sa longueur maximale est de 100 caractères.
Nom du marchand
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 35 sur 44
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 champ Description Valeur
hide_login Les marchands peuvent faire apparaître à leurs clients la page du portail sans la partie importante de connexion.
1
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 36 sur 44
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 :
Nom du champ
Description Valeurs Valeur par
défaut Exemple
return_url_target Précise une cible dans laquelle la valeur return_url apparaîtra suite à la validation du paiement effectué par le client.
1 = '_top' 2 = '_parent' 3 = '_self' 4= '_blank'
1 1
cancel_url_target Précise une cible dans laquelle la valeur cancel_url apparaîtra suite à l'annulation du paiement du client.
1 = '_top' 2 = '_parent' 3 = '_self' 4= '_blank'
1 1
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.
2 '_parent'
"_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 de l'ensemble de cadres interne qui utilise "_parent" chargera le nouveau document à l'endroit de l'ensemble de cadres interne.
3 '_self' Charge le nouveau document dans la même fenêtre et le même cadre que le 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
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 37 sur 44
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
NOK Couronne norvégienne KRW Won de Corée du Sud
ILS Shekel israélien ZAR Rand d'Afrique du Sud
MYR Ringgit malais RON Nouveau leu roumain NZD Dollar néo-zélandais HRK Kuna croate TRY Nouvelle livre turque LTL Litas lituanien
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 38 sur 44
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
Albanie ALB Brunéi Darussalam BRN Dominicaine, 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
Argentine ARG Caïmanes, Îles CYM Falkland, Îles (Malvinas) FLK
Arménie ARM Centrafricaine, 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
Bahreïn BHR Colombie COL Terres australes françaises ATF
Bangladesh BGD Comores COM Gabon GAB
Barbade BRB Congo, République du COG Gambie GMB
Bélarus BLR Congo, La République 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
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 39 sur 44
Botswana BWA Danemark DNK Guam GUM
Guatemala GTM Mayotte MYT Sénégal SEN
Guernesey GGY Mexique MEX Serbie SRB
Guinée GIN Micronésie, États 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
Hongrie HUN Myanmar MMR Géorgie du Sud et les Î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
Iraq IRQ Nouvelle-Calédonie NCL Svalbard et Île Jan 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
Italie ITA Nigeria NGA Syrienne, République arabe SYR
Jamaïque JAM Niué NIU Taïwan, Province de Chine TWN
Japon JPN Norfolk, Île NFK Tadjikistan TJK
Jersey JEY Mariannes du Nord, Îles MNP
Tanzanie, République-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 démocratique de PRK
Palestinien occupé, Territoire PSE Tonga TON
Corée, République de KOR Panama PAN Trinité-et-Tobago TTO
Koweït KWT Papouasie-Nouvelle-Guinée PNG Tunisie TUN
Kirghizistan KGZ Paraguay PRY Turquie TUR Lao, République démocratique populaire LAO Pérou PER Turkménistan TKM
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 40 sur 44
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
Luxembourg LUX Roumanie ROU
Îles mineures éloignées des États-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
Maldives MDV Saint-Martin (partie française) MAF
Îles Vierges britanniques VGB
Mali MLI Saint-Pierre-et-Miquelon SPM
Îles Vierges des États-Unis VIR
Malte MLT Saint-Vincent-et-les 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
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 41 sur 44
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 [email protected]
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 42 sur 44
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 [email protected] 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="[email protected]">
<input type="hidden" name="status_url" value="[email protected]">
<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>
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 43 sur 44
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="[email protected]">
<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="[email protected]">
<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>
Manuel d'intégration des marchands Version <6.6>
Portail de paiement de Moneybookers 7 janvier 2009
Non classé ©Moneybookers Ltd, 2009 Page 44 sur 44
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