Paiement VirtueMart 2.0

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

Principe de l'option Gestion des Abonnements dans le cas de Paybox

L'option Gstion des Abonnements est disponible pour le produit "Paybox System", il faut en faire la demande auprès du service commercial et technique de Paybox

La gestion des paiements par abonnement permet au commerçant de gérer des prélèvements périodiques ou des paiements en plusieurs fois pour ses clients. Ainsi, une fois le paiement initial effectué, le client sera prélevé de façon cyclique suivant une fréquence choisie préalablement par le commerçant.

  • La gestion de l’abonnement sur Paybox System est une gestion de base : elle ne prévoit que des cas simples d’abonnements, basés sur la reconduction périodique de paiement d’une même somme, sur une période souhaitée initialement par le commerçant. Ces paramètres ne peuvent pas, par la suite, être modifiés.
  • Malgré sa simplicité, le système offre une souplesse de paramétrage permettant notamment, avec la gestion des différés, un large éventail de déclenchement de la première reconduction de l’abonnement.
  • Il est à noter qu’en cas d’échec (refus d’autorisation) sur une échéance, Paybox n’assure pas de représentation et stoppe les futures échéances.
  • Le commerçant peut suivre ses abonnements via son accès au Back Office Commerçant

Installation du CGI de Paybox

Suivez les instructions du tutoriel Paybox pour Joomla 2.5 et Virtuemart 2.0

Installation des plugins de paiement Paybox pour VirtueMart 2

Le plugin Paybox Abonnement contient 2 plugins: celui de Paybox paiement en une fois, et celui de Paybox Abonnement.

  1. Télécharger l'archive plgvm_alatak_paybox_subs_vm2.x.y_vz pour VirtueMart 2
  2. Installer l'archive via l'installateur de Joomla
  3. Aller dans le gestionnaire de plugin de Joomla, et publier les 2 plugins de Paybox.

Publier les 2 plugins de paiement Paybox

Création du Champ Personnalisé pour les produits

Le mode de paiement Paybox Abonnement a besoin de la réference d'un champ personnalisé qui sera utilisé par les produits de type Abonnement. Créer ces champs avant de configurer votre méthode de paiement.

Aller dans Produits > Champs personnalisés, puis créer 3 champs:

  • PAYBOX recurring Payments de type parent
  • PBX_FREQ qui indiquera Fréquence des prélèvements en mois.
  • PBX_NBPAIE qui indiquera Nombre de prélèvements

champs personnalises pour Paybox Abonnement

 Création du champ PAYBOX recurring Payments

  1. Cliquer sur Nouveau
  2. Type de champ personnalisé: sélectionner Parent
  3. Titre: PAYBOX recurring Payments
  4. Enregistrer et fermer

paybox-parent

Création du champ PBX_FREQ

  1. Cliquer sur Nouveau
  2. Type de champ personnalisé: sélectionner Entier
  3. Titre: PBX_FREQ
  4. Parent: Sélectionner PAYBOX recurring Payments
  5. Attribut Panier: Non
  6. Caché: Oui
  7. Enregistrer et fermer

PBX FREQ

Création du champ PBX_NBPAIE

  1. Cliquer sur Nouveau
  2. Type de champ personnalisé: sélectionner Entier
  3. Titre: PBX_NBPAIE
  4. Parent: Sélectionner PAYBOX recurring Payments
  5. Attribut Panier: Non
  6. Caché: Oui
  7. Enregistrer et fermer

PBX NBPAIE

Lors de la création des champs personnalisés, il est imperatif que les titres soient

  • PAYBOX recurring Payments
  • PBX_FREQ
  • PBX_NBPAIE

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 System Recurring

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

4. Cliquer sur l'onglet Configuration 

Les paramètres sont les mêmes que ceux du mode de paiment Paybox. Consulter le tutoriel de configuration de Paybox.
Les paramètres suivants sont spécifiques au mode de paiement Paybox Abonnement:

  • Champ personnalisé: sélectionner le champ de type parent que vous avez créer précedemment PAYBOX recurring Payments. Il devrait se touver dans la liste.
  • Jour du mois prélèvé: indiquer le Jour du mois auquel le prélèvement sera effectué (0 = le même jour que le paiement initial).
  • Nombre de jours d’attente: Indiquer le Nombre de jours d’attente avant le déclenchement du début de l’abonnement. 

Créer vos produits de type Abonnement

Lors de la création de vos produits de type Abonnement, cliquer sur l'onglet Champ Personnalisé, et sélectionner PAYBOX recurring Payments. Indiquer pour chacun de vos produits:

  • PBX_FREQ: indiquer Fréquence des prélèvements en mois. La valeur 1 indiquera un prélévement une fois par mois. La valeur 3 indiquera un prelevement tous les 3 mois.
  • PBX_NBPAIE: indiquer le Nombre de prélèvements (0 = toujours). Le valeur 6 indiquera 6 prélévements, la valeur 12 indiquera 12 prélévements

abonnement-produit

Fin des abonnements

L’abonnement peut se terminer de 3 façons différentes :

  • Fin normale: Lorsque toutes les échéances d’un abonnement ont été traitées avec succès, l’abonnement se termine de lui-même.
  • Fin en échec Lorsque l’une des échéances échoue, il n’y a pas de représentation de l’échéance ultérieurement. L’abonnement est clôturé et le commerçant est informé de ce résultat par un mail.
  • Résiliation par le commerçant Le commerçant peut choisir à tout moment d’arrêter l’abonnement en cours. Pour cela, il peut se rendre sur le Back-Office de Paybox. Lorsque le commerçant résilie un abonnement, le client en est informé par mail.

Tester votre paiement Paybox

Tester avec un produit de type non Abonnement

Le panier indique le montant qui sera débité une fois.

produit-seul

Tester avec un produit Abonnement

Le panier indique le montant initial de 6,05 €. Le mode de paiement indique le montant des prélevements de 6,05 €..

abonnement-seul

Tester avec un produit Abonnement et non Abonnement

Le panier indique le montant initial de 29,55 €. Le mode de paiement indique le montant des prélevements de 6,05 €.

produit-et-abonnement

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.