Paiement Paybox™

Page 'Paiement Sécurisé' Table

Pour tout rapport de bug ou suggestion, envoyez un mèl au Support ExperLog

Présentation

ExperShop supporte PayBox™ à partir de la version 2.0 beta 2, (aucun test n'a été effectué avec les versions plus anciennes).

Les scripts CGI PayBox™ ne sont pas inclus dans la livraison ExperShop: vous les obtiendrez sur le site web de PayBox™, ainsi que l'ouverture de votre compte PayBox™.

Pour plus d'information, consultez le site web PayBox™

Plateformes

Poure l'instant, nous n'avons testé que sous Linux (intel)...
Contactez-nous pour d'autres plateformes possibles, mais rien n'indique que sur d'autres plateformes, le paiement ne marche pas.

Comment fonctionne PayBox™ ?

PayBox™ est un service de paiement sécurisé PAYBOX SERVICE™.
1 Lorsqu'un acheteur a sélectionné des produits sur une galerie, le serveur du commerce redirige l'acheteur vers le serveur PAYBOX. Ce dernier établit alors une connexion cryptée avec l'acheteur (en SSL), pour que la saisie du numéro de carte bancaire soit effectuée en toute sécurité.

PAYBOX vérifie la validité de la carte auprès de la banque du commerçant, et enregistre le paiement si la carte est authentifiée. Un ticket de paiement est ensuite affiché sur l'écran de l'acheteur. Ce même ticket lui sera renvoyé par courrier électronique (e-mail), comme preuve du paiement. L'acheteur a alors la possibilité de revenir sur la galerie marchande pour effectuer d'autres achats.

PAYBOX envoie également par courrier électronique un double du ticket de paiement au commerce. C'est ce ticket qui constitue la preuve du paiement par l'acheteur.

Le système PAYBOX s'intègre très facilement dans tout système de galerie marchande. Il suffit d'installer sur le serveur, un module CGI fourni par 'PAYBOX SERVICES', et d'ajouter un bouton sur une des pages HTML (ou templates .tmpl) de la galerie.

L'utilisation de PAYBOX nécessite la signature préalable d'un contrat VAD/VPC avec l'établissement bancaire du commerçant, et l'abonnement au serveur PAYBOX auprès de la société "PAYBOX SERVICES".

Une fois remplies ces formalités, vous pourrez facilement configurer votre boutique ExperShop pour utiliser PayBox™.

Configurer ExperShop pour PayBox™

Les propriétés suivantes doivent être précisées dans le fichier de configuration de la boutique:

pay.paybox.Url: L'URL du module CGI (ex: http://mon_host/cgi-bin/module.cgi). Défaut : http://localhost/cgi-bin/module.cgi
pay.paybox.Ibs_Mode: Mode de récupération des données (par défaut: 1)
pay.paybox.Ibs_Site: Numéro de site (TPE) donné par la banque (ex: 1999888)
pay.paybox.Ibs_Rang: Numéro de rang ('machine') donné par la banque (ex: 99)
pay.paybox.Ibs_Devise: Devise pour l'achat. 250 = Franc, 978 = Euro (par défaut: 250)
pay.paybox.Ibs_Langue: Langue utilisé par PAYBOX pour l'affichage: "FRA", "GBR", "DEU" (par défaut: FRA)
pay.paybox.Ibs_Effectue: URL de retour de PAYBOX vers votre site après paiement EFFECTUE (par défaut: http://mon_host/servlet/com.expershop.pay.paybox.ESShopReturnServlet
pay.paybox.Ibs_Annule: URL de retour de PAYBOX vers votre site après paiement ANNULE
pay.paybox.Ibs_Refuse: URL de retour de PAYBOX vers votre site après paiement REFUSE
pay.paybox.NormalReturnPage: Page affichée en retour de paiement (par défaut: Thanks.tmpl)

Installer PayBox™ sur votre système

Ici, nous décrivons uniquement la procédure d'installation sous Linux, pour d'autres plateformes, nous contacter, à priori, toutes les plateformes supportées par PayBox™ fonctionnent.

Installation sous Linux (intel)

Vous devez tout d'abord télécharger sur le site de PayBox le module CGI pour Linux, copiez ce fichier dans le répertoire cgi-bin de votre serveur http, et donnez les droits d'exécution à ce fichier.

      chmod 555 module.cgi

Appeler PayBox™ depuis les templates ExperShop

Appeler PayBox™, cela veut dire afficher une form HTTP, généré par le module CGI de PayBox™. L'appel peut être le suivant:

...
<form method="post" action="com.expershop.lite.ExperSHOP">
$Cookie
<INPUT type="hidden" name="Page" value="PayBox/ESRedirect.tmpl">
<INPUT TYPE="hidden" name="Mandatory"
 value="ShipName,ShipAddress,ShipCity,ShipZipCode,ShipCountry,Email">
...
...
...
<input type="submit" value="Order Now!">
</form>
Le template PayBox/ESRedirect.tmpl ne contient que les informations suivantes, et ne doit en aucun cas contenir des informations html.

$Action com.expershop.pay.paybox.ESOrderAct 

$PayBoxFORM$
Cette action ExperSHOP appelle le module CGI PayBox, et retourne le résultat de l'appel dans un paramètre de sortie appelé PayBoxFORM.

Tous les champs de l'input Mandatory sont obligatoires, ainsi que le mail de la personne.

La page générée par le module CGI contient un bouton, inutile d'appuyer sur celui-ci, le client sera redirigé vers le serveur PayBox pour le paiement sécurisé. Une fois le paiement effectué, le client aura la possibilité de revenir sur la boutique avec un lien.

Note: l'action ESOrderAct "pré-commande" le contenu du panier d'achat: lorsque PayBox™ confirmera à ExperShop le succès du paiement, la "pré-commande" deviendra une commande à part entière.