Moneybookers Gateway Manual

Moneybookers Ltd.

Portail de paiement de Moneybookers

Manuel d'intégration des marchands

Version : <6.6>

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

Portail de paiement de Moneybookers 7 janvier 2009

Non classé ©Moneybookers Ltd, 2009 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




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)




2 Détails sur le portail de paiement

2.1 Application

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

paiement pour y inclure l'option moneybookers.com comme mode de paiement. Ensuite,

lorsque le client choisit l'option moneybookers.com comme mode de paiement, il envoie, en

fait, un formulaire HTML aux serveurs Web sécurisés de Moneybookers. Le formulaire

envoyé contient des informations sur le paiement, telles que le compte du marchand, la

somme à payer et plusieurs autres champs textes cachés.




2.2 Diagramme d'interaction




2.3 Procédure de paiement par étapes

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

Une fois le client arrivé sur la page de commande/paiement du marchand, il doit voir

apparaître un bouton envoyant un formulaire HTML à

https://www.moneybookers.com/app/payment.pl. Le formulaire doit contenir les champs

cachés répertoriés dans le tableau ci-dessous. Pour optimiser la conversion, Moneybookers

conseille vivement au marchand de rediriger le client vers le portail dans la même fenêtre

de navigateur ou d'intégrer le portail dans une IFRAME. Lors de l'utilisation du portail

standard, la largeur minimale de la fenêtre/du cadre doit être de 600 pixels minimum.

Si vous souhaitez d'abord voir la manière dont le portail fonctionne, vous pouvez accéder à

notre formulaire de test sur http://www.moneybookers.com/app/test_payment.pl. Ce

formulaire a été prévu afin de montrer les différents scénarios pour lesquels notre portail

peut être utilisé. Mais, toutes les transactions confirmées au cours des essais effectués pour

tester le portail seront traitées comme de VRAIS paiements. Pour éviter cela, veuillez

contacter [email protected] et nous fixerons des comptes tests et des

données tests à des fins expérimentales.




Paramètres à envoyer au portail de Moneybookers :

Nom du champ Description Obligatoire Exemple de valeur

Informations sur le marchand

pay_to_email Adresse e-mail du compte moneybookers.com du marchand.

Oui [email protected]

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






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





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.

Non [email protected]

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





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





detail4_description Voir ci-dessus Non


detail5_description Voir ci-dessus Non


2.3.2 Autre méthode pour rediriger le client

Le marchand peut parfois vouloir garder les détails du paiement confidentiels. Ce sont les

cas où les paramètres envoyés aux serveurs de Moneybookers contiennent des informations

confidentielles qui ne doivent pas être modifiées par le client. Lorsque vous utilisez la

procédure standard pour rediriger le client, telle qu'elle est décrite dans la partie

précédente, le client peut voir et éventuellement modifier les paramètres du paiement

puisque son navigateur exécute la requête en question pour la transaction. Il existe une

autre manière de rediriger le client vers notre portail, qui n'implique pas l'envoi des

paramètres du paiement au navigateur :

(i) Le serveur du marchand envoie une requête POST standard avec les paramètres du

paiement et le paramètre ‘prepare_only’ à :

https://www.moneybookers.com/app/payment.plhttps://www.moneybookers.com/app/

payment.pl

(ii) Le serveur de Moneybookers prépare une session pour le paiement et renvoie une

réponse HTTP(S) standard.

(iii) Le serveur du marchand prend le cookie SESSION_ID du Set-Cookie HTTP header

correspondant de la réponse.

(iv) À l'aide de cette valeur SESSION_ID, le client peut être redirigé vers

https://www.moneybookers.com/app/payment.pl?sid=<SESSION_ID> où le

déroulement normal des événements se poursuit. Cette redirection doit avoir lieu dans

les 15 minutes suivant la requête initiale, sinon la session prendra fin.




De cette façon, les détails du paiement sont communiqués de manière sécurisée, entre le

serveur du marchand et Moneybookers uniquement.

2.3.3 Confirmation du client sur les serveurs de Moneybookers Étape 2

Lorsque le client envoie le formulaire de redirection, il voit apparaître un écran illustrant

l'étape 2 de la procédure. Cette page est hébergée sur les serveurs de moneybookers.com

et contient tous les détails du paiement soumis par le marchand.

On compte deux principaux scénarios :

(i) Le client est déjà inscrit sur Moneybookers (il a déjà utilisé Moneybookers auparavant).

Dans ce cas, l'utilisateur doit simplement indiquer ses identifiants de connexion (voir ci-

dessous). Si le paramètre ‘pay_from_email’ est fourni et que l'adresse e-mail est inscrite

dans les fichiers de Moneybookers, cette adresse e-mail est pré-remplie dans le

formulaire de connexion et l'utilisateur doit seulement entrer son mot de passe et

confirmer. Si aucun paramètre ‘pay_from_email’ n'est fourni, le client verra apparaître

un formulaire d'inscription, comme il est expliqué plus en détail au point (ii), où figure

un lien permettant aux utilisateurs inscrits sur Moneybookers d'accéder à la page de

connexion.




En cliquant sur le bouton "CONNEXION", le client est redirigé vers la prochaine étape où

il doit choisir un mode de paiement parmi ceux acceptés par le marchand.

(ii) Le client n'est pas encore inscrit sur Moneybookers. C'est le cas si l'adresse e-mail

envoyée n'est pas encore connue de Moneybookers et ce peut être le cas si aucun

paramètre ‘pay_from_email’ n'est fourni. Le client voit apparaître un formulaire

d'inscription (voir ci-dessous), divisé en deux étapes, et enregistre instantanément ses

coordonnées sur Moneybookers. Les marchands peuvent fournir des informations

supplémentaires qui seront utilisées pour pré-remplir le formulaire d'inscription pour

accélérer le paiement : ‘address’, ‘firstname’, ‘lastname’, ‘postal_code’, ‘city’, ‘country’

comme il est expliqué dans la liste de champs ci-dessus. Si le paramètre

‘pay_from_email’ est fourni, il sera utilisé comme adresse e-mail primaire pour le

nouveau compte Moneybookers.




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




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

de la Politique de confidentialité




Vous trouverez ci-dessous une liste des modes de paiement disponibles parmi lesquels le

client peut faire son choix en suivant les instructions données dans la procédure d'achat du

portail :

Type de 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.




2.3.4 Page de confirmation sur les serveurs de Moneybookers Étape 3

À tout moment, avant de cliquer sur le dernier bouton 'confirm', le client peut annuler la

procédure de paiement et retourner sur le site Internet du marchand (à l'adresse URL

indiquée dans le champ 'cancel_url' du formulaire de redirection).




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

Dernière étape

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

le client est redirigé automatiquement vers le site Internet du marchand.

2.3.6 Rapport de statut de Moneybookers au marchand

Une fois la procédure de paiement terminée, le serveur de paiement de Moneybookers

enverra les détails de la transaction à l'adresse URL ‘status_url’ fournie par le marchand.

Ceci est effectué à l'aide d'une requête HTTP POST standard. Le serveur de Moneybookers

continuera à envoyer des rapports de statut jusqu'à ce qu'il reçoive une réponse de type

HTTP OK (200) de la part du serveur du marchand ou jusqu'à ce que le nombre d'envois

dépasse la limite de 10. Le tableau suivant présente les paramètres devant être reçus à

l'adresse status_url sur le serveur Web du marchand :




*Pour recevoir la valeur customer_id, veuillez contacter le gestionnaire de votre compte ou [email protected].


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.

Oui [email protected]

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




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




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.




2.3.7 Description détaillée du statut

‘2’ Exécutée – Ce statut est envoyé lorsque la transaction est exécutée et que les fonds

ont été reçus sur votre compte Moneybookers.

‘0’ En attente – Ce statut est envoyé lorsque le client paye par l'intermédiaire d'un

virement bancaire en attente. De telles transactions seront exécutées automatiquement SI

le virement bancaire est reçu par Moneybookers. Nous vous conseillons vivement de ne PAS

exécuter la commande/transaction dans votre système après réception d'un statut en

attente de Moneybookers.

‘-1’ Annulée – Les transactions en attente peuvent être annulées manuellement par

l'envoyeur dans l'historique de son compte en ligne ou bien seront automatiquement

annulées au bout de 14 jours si elles sont toujours en attente.

‘-2’ Échouée – Ce statut est envoyé lorsque le client essaye de payer par carte de crédit ou

par prélèvement automatique mais que notre fournisseur refuse la transaction. Si vous

n'acceptez pas les paiements par carte de crédit ou par prélèvement automatique par

l'intermédiaire de Moneybookers (voir page 16), alors vous ne recevrez jamais le statut

échoué.

‘-3’ Opposition – Vous pouvez recevoir ce statut uniquement si votre compte est configuré

pour recevoir des oppositions. Si c'est le cas, chaque fois qu'une opposition est reçue par

Moneybookers, un statut -3 sera envoyé à status_url pour la transaction opposée.




3 Caractéristiques supplémentaires du portail

3.1 Inscription rapide au portail

Cette fonction a pour but de minimiser les efforts demandés au client pour effectuer son

premier paiement aux marchands, tout en maintenant de bons niveaux d'inscription à

Moneybookers. Si vous voulez rendre le paiement plus facile et plus rapide pour vos clients,

veuillez contacter votre gestionnaire de compte ou écrire à

[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


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




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 à

[email protected].

Les mêmes règles que pour l'inscription rapide au portail s'appliquent pour Quick Checkout.

Le marchand doit fournir les paramètres suivants pour chaque transaction :


address Adresse du client (ex. rue) Ruedupayeur

postal_code Code postal/ZIP du client EC45MQ

city Ville du client Londres


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 :





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’

[email protected]

Le client peut uniquement terminer la transaction avec la fonction Quick Checkout s'il paie

par l'intermédiaire d'un des modes suivants :

• Visa

• MasterCard

• Amex

• JCB

• Diners

• Laser

• Solo (UK)

• Maestro (UK)

• Carte Bleue

• German Direct Debit

• Giropay

• Sofortueberweisung




3.3 Portail partagé

Cette fonction permet aux marchands de sélectionner le(s) mode(s) de paiement qu'ils

veulent présenter au client lors de l'utilisation du portail. Un exemple d'utilisation de cette

fonction est lorsque le marchand veut faire apparaître “Payer par prélèvement automatique

(fourni par Moneybookers)” comme option de paiement sur sa page de commande, plutôt que

simplement “Payer par l'intermédiaire de Moneybookers”.

Pour sélectionner des modes de paiement particuliers à présenter au client sur le portail, le

paramètre suivant doit être inclus dans le formulaire d'entrée :

Paramètre Description Exemple de valeur

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 :




3.3.1 Portail partagé fixe

Lorsque le portail partagé fixe est activé et que le marchand envoie un payment_method,

seul ce mode de paiement apparaît au client après inscription ou connexion. Les clients

existants disposant d'un solde suffisant sur leur compte Moneybookers peuvent toujours

payer à partir de celui-ci. L'option du solde peut être désactivée, mais ce n'est pas conseillé.

3.3.2 Portail partagé flexible

Lorsque le portail partagé de type flexible est activé et que le marchand envoie un

payment_method, il est pré-sélectionné pour le client après inscription ou connexion. Tous

les autres modes de paiement activés pour le marchand et pour le pays d'inscription du

client sont disponibles. Si le payment_method n'est pas proposé par le pays d'inscription du

client, alors un message apparaîtra indiquant que ce type de paiement n'est pas proposé et

montrant tous les autres modes de paiement disponibles pour son pays.




3.4 Facturation récurrente

Moneybookers offre déjà un outil pour les paiements récurrents sur le site

moneybookers.com. Cette option est également disponible pour les marchands par

l'intermédiaire du portail. En plus des paramètres standard décrits au point 2.3.1, les

marchands peuvent fournir les paramètres suivants pour établir un paiement récurrent par

l'intermédiaire du portail :

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.




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




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:





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


• Solde du compte Moneybookers du client




3.6 Paramètre return_url sécurisé

Cette fonction permet au marchand d'être sûr que le client est arrivé à l'adresse return_url en

terminant la procédure de paiement, PAS simplement en cherchant la valeur return_url dans

la source de la page et en l'entrant dans leur navigateur. Mais, cette fonction garantit

UNIQUEMENT que le client a terminé la procédure de paiement et PAS que le paiement a été

exécuté.

Afin d'utiliser cette fonction, le marchand doit en faire la demande par e-mail à

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




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.




3.8 Avis d’opposition

Si votre compte Moneybookers a été réglé pour accepter des oppositions, vous recevrez un

avis d’opposition dans le rapport envoyé à status_url. Chaque fois que nous recevrons une

requête d’opposition de notre fournisseur, nous vous enverrons un rapport de statut mis à

jour avec le statut -3 pour la transaction opposée. (Voir le point 2.3.7 pour une description

détaillée des statuts de transaction).

3.9 Descripteur dynamique

La fonction Descripteur dynamique permet au marchand de faire apparaître son nom ou sa

marque sur le relevé bancaire ou de carte de crédit du client. Cette fonction est uniquement

disponible pour les modes de paiement suivants :

• Visa

• MasterCard

• Sofortueberweisung


Afin d'utiliser cette fonction, le marchand doit en faire la demande par e-mail à

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


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




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




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 1

cancel_url_target Précise une cible dans laquelle la valeur cancel_url apparaîtra suite à l'annulation du paiement du client.


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




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




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




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




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




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]




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>




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="amount4_description" value="TVA (20%) :">


<input type="hidden" name="amount" value="39.60">

<input type="hidden" name="currency" value="GBP">

<input type="hidden" name="firstname" value="John">

<input type="hidden" name="lastname" value="Payeur">

<input type="hidden" name="address" value="Ruedupayeur">

<input type="hidden" name="postal_code" value="EC45MQ">

<input type="hidden" name="city" value="Villedupayeur">

<input type="hidden" name="country" value="GBR">

<input type="hidden" name="detail1_description" value="ID du produit :">

<input type="hidden" name="detail1_text" value="4509334">

<input type="hidden" name="detail2_description" value="Description :">

<input type="hidden" name="detail2_text" value="Roméo et Juliette (W. Shakespeare)">

<input type="hidden" name="detail3_description" value="Conditions spéciales :">

<input type="hidden" name="detail3_text" value="Livraison sous 5 à 6 jours">

<input type="hidden" name="confirmation_note" value="Nomdumarchand espère que vous

apprécierez votre nouveau livre !">

<input type="submit" value="Payer !">

</form>




7 Annexe V – Codes des paiements sur le portail partagé

Le tableau suivant détaille les codes requis pour chaque mode de paiement lorsque l'on

utilise le portail partagé :

Mode de paiement Valeur Remarques

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

Moneybookers Gateway Manual

Documents

Transcript of Moneybookers Gateway Manual