Accéder au contenu principal

Le plugin de paiement de Paybox pour VirtueMart 2 sur le site des extensions de VirtueMart

Installation du module CGI de Paybox

  1. Télécharger le module correspondant au système exploitation de votre serveur Web: il est disponible sur http://www.paybox.com dans la rubrique téléchargement.
  2. Renommer ce module par exemple modulev2.cgi
  3. Installer ce module dans le répertoire cgi-bin de votre serveur Web. Transférez votre fichier CGI en mode binaire.
    Le fichier doit être transféré en mode binaire car c'est un fichier exécutable. La modification du mode de transfert se fait au niveau de votre logiciel FTP.
  4. Vérifier votre transfert: le module doit pouvoir s’exécuter directement, en appelant l’URL du fichier dans le navigateur. http://www.maboutique.com/cgi-bin/modulev2.cgi

A l'exécution, vous devriez avoir un message du type:

  • paybox input error code (-7) ou
  • paybox input error code (-3).

Cela signifie que le module s‟est bien exécuté. L'erreur est du  seulement dû à l‟absence des variables à référencer. Si vous avez une autre erreur que -7 ou -3, l'execution de votre fichier n'est pas correcte. Verifiez que vous avez téléchargé le bon module cgi en fonction de votre installation Linux ou Windows.

Sur hébergement OVH:
- Utilisez le module modulev3_debian_noyau2-4-20_libc2-3-2.cgi
- Concernant l''accès au cgi-bin via un multidomaine, vous devez créer un répertoire cgi-bin dans le dossier cible du multidomaine puis créé un lien symbolique avec le dossier cgi-bin originel.

Cette étape est importante. Il est indispensable d''avoir trouvé le bon module CGI correspondant à votre hébergement. Vous n'y arrivez pas? N'hésitez pas à appeler la hot line de Paybox, ou de votre hébergement pour qu'ils vous guident.
Paybox propose ainsi 3 types d’interfaçage du service Paybox System :
  • Version avec signature HMAC (nouvelle version sans module cgi)
  • Version avec module cgi compilé
  • Version avec module cgi compilé + signature HMAC
Pour l'instant, seule la version avec module cgi compilé a été testée.

Installation du plugin de paiement Paybox pour VirtueMart 2 sur votre site

  1. Télécharger le plugin de paiement de Paybox pour VirtueMart 2
  2. Installer le plugin de paiement via l'installateur de Joomla
  3. Aller dans le gestionnaire de plugin de Joomla, et publier le plugin.

Configuration de la méthode de paiement dans VirtueMart

1. Dans l'administration de VirtueMart, allez dans Boutique > Boutique > Mode de paiement, puis cliquez sur Nouveau.

2. Compléter :

  1. Nom du mode de paiement : (Choisissez un nom)
  2. Publié: Oui
  3. Description du mode de paiement: ajouter une description si vous le souhaitez
  4. Mode de paiement: Sélectionner Paybox

3. Enregistrer. Cet enregistrement permet le chargement des paramètres de configuration spécifique à ce plugin.

4. Cliquer sur l'onglet Configuration :

  1. Le champ Logos permet d’ajouter une ou plusieurs images au nom de mode de paiement et à sa description lors de sa sélection durant le processus de commande. Sélectionnez les images souhaitées.
  2. Numéro du site: il s’agit de l’identifiant à 7 chiffres fourni par Paybox. Pour la phase de tests, vous pouvez utiliser la valeur par défaut 1999888.
  3. Numéro du rang : il s’agit du numéro de rang  à 2 chiffres attribué par Paybox. Pour la phase de tests, vous pouvez utiliser la valeur par défaut 99.
  4. Identifiant : il s’agit de l’identifiant Paybox composé de 1 à 9 chiffres. Pour la phase de tests, vous pouvez utiliser la valeur par défaut 110647233.
  5. CGI Paybox : il s’agit de l’URL pointant sur le module CGI de Paybox que vous avez installé. Par exemple :http://www.boutique-virtuemart.com/cgi-bin/modulev2.cgi).
    A partir de la version 2.0 du plugin, il s'agit du chemin absolu du CGI modulev2.cgi
  6. Autorisation : vous avez le choix entre Autorisation seule ou Autorisation + capture.
    • Autorisation seule indique que la transaction ne sera pas envoyée à votre banque au moment de la télécollecte.
    • La valeur par défaut est Autorisation + capture qui indique une télécollecte de la transaction.
  7. Nombre de jours de différé : permet de préciser le nombre de jours avant l’envoi de la transaction. Pour indiquer un différé de 4 jours, saisissez la valeur 4.  
  8. Méthode URL Directe: mode de transmission des paramètres seront renvoyés à la boutique. 
  9. Dans le champ Pays , sélectionnez le ou les pays pour lesquels vous autorisez ce mode de paiement.
  10. Renseigner le champ Montant maximum si vous souhaitez plafonner le montant des commandes pour lesquelles vous proposez ce mode de paiement. Le montant doit être indiqué dans la devise de la boutique.
  11. Le champ Devise permet de préciser les devises pour lesquelles vous acceptez ce mode de paiement.
  12. Vous pouvez renseigner les champs Frais par transaction, Frais % montant total et Taxe.
  13. Le paramètre Gestion de la page intermédiaire permet de gérer la dernière page qui s’affiche sur la boutique avant d’être dirigé vers la page de paiement. Gardez la valeur par défaut, soit Page intermédiaire Paybox par défaut et Appel automatique.
  14. URL serveur primaire: https://preprod-tpeweb.paybox.com/cgi/MYchoix_pagepaiement.cgi lors de la phase de test
  15. Cliquez sur Enregistrer & Fermer
Il faut IMPERATIVEMENT renseigner ce champ avec la valeur https://preprod-tpeweb.paybox.com/cgi/MYchoix_pagepaiement.cgi. Quand vous désirerez basculer sur l’environnement de production, il faudra alors retirer ces 3 variables.

Tests de Paybox

Les paramètres de la boutique de test de Paybox sont:

  • site : 1999888,
  • rang 99 et
  • identifiant:110647233

Les identifiants de tests changent parfois. Merci de vous référer à la documentation de Paybox et de vérifier vos paramètres

Le numéro de la carte de crédit de test est:

  • Carte de crédit de test : 1111222233334444

L'URL HTTP

L'URL HTTP est l'url qui permet a validation automatique  la validation des  bons de commandes suivant le résultat de la transaction.