SPPLUS pour Joomla 1.0 ou Joomla 1.5 et Virtuemart 1.1 - configuration du paiement
Principe de la méthode de paiement de SPPLUS de la Caisse d'epargne
Le principe de la méthode de paiement de SPPLUS est de générer une URL d’appel au serveur de paiement SP PLUS. Il repose sur un ensemble de fonctions de codage (on parle d’une API) utilisées pour générer un sceau numérique (nommé clé « hmac ») à partir des informations du site marchand et des paramètres du paiement.
La méthode utilisée pour générer cette URL d'appel au serveur de paiement SPPLUS dépend de votre type d'hébergement:
- hébergement sur un serveur de type dédié,
- hébergement de type mutualisé, et votre hébergeur est OVH,
- hébergement de type mutualisé, et votre hébergeur n'est pas OVH.
Vous êtes sur un serveur dédié
Le document "API_PDF.PDF" fourni par la Caisse d'Epargne, vous explique comment la démarche à suivre suivant votre type de plateforme: Linux/Unix ou Windows.
Sous PHP4: installer le module php4-spplus avec debian : apt-get install php4-spplus.
Sous php5 et toute autre distribution : compiler son propre module php_spplus.so http://kits.spplus.net/integration/kits/lib_c_PEAR_b64.tgz
Votre hébergeur est OVH
SPPLUS vous fourni une API php_spplus.so qui contient votre clé marchand et que vous devez placer à la racine de votre site.
Votre hébergeur n'est pas OVH
Le kit CGI sera hébergé chez SPPLUS. Ils vous fourniront une adresse permettant d'appeler votre fichier à distance.
Téléchargement du module de paiement SPPLUS pour Virtuemart
Vous pouvez télécharger le module de paiement pour SPPLUS pour Virtuemart à partir du site de Virtuemart ou bien :
Téléchargement de SPPLUS pour Joomla 1.5 et Virtuemart 1.1 (44.79 kB 2008-06-18 15:23:01)
Installation et configuration de SPPLUS pour Virtuemart
Installation des fichiers du module de paiement SPPLUS de VirtueMart
1. Copier les fichiers ps_spplus.php et ps_spplus.cfg.php vers /administrator/components/com_virtuemart/classes/payment/
2. Copier
checkout.spis_cc_form.php, checkout.spplus_response.php, checkout.spplus_spcheck.php vers /administrator/components/com_virtuemart/html
3. Créer le répertoire spplus sous /administrator/components/com_virtuemart/html
4. Créer le répertoire languages sous /administrator/components/com_virtuemart/html/spplus
5. Copier french.php vers /administrator/components/com_virtuemart/html/spplus/languages
6. Copier les fichiers spplus_cgi.php et spplus_notify.php à la racine de votre site
Configuration de la méthode de paiement
1. Aller sous "Boutique/Ajouter une Méthode de Paiement"
2. Compléter :
b. Code: (Choisissez un nom)
c. Payment Class Name: ps_spplus
d. Type de méthode de paiement : "PayPal or related"
3. Sauvegarder
4. Aller sous "Boutique/Lister les Méthodes de Paiement" et choisissez celle que vous venez de créer.
5. Aller sous l'onglet "Configuration" pour la modifier:
- Votre type d'hebergement: spécifier si vous êtes sur serveur dédié, hebergé chez OVH ou non.
- URL CGI: à remplir que si votre CGI est hébergé chez SPPLUS. Adresse fourni par SPPLUS. Exemple: http://kits.spplus.net/cgi-bin/hmac_001.exe.
- Clé: clé marchand du commerçant au format NT
- Siret: Code Siret du site marchand
- Statuts des transactions: préciser les différents statur de la commande qu indiquera le déroulement de la commande.
- Argument privé commerçant: Ces paramètres sont destinés à recevoir des informations spécifiques au commerçant. Ils peuvent être utilisés, entre autres, pour transmettre les coordonnées de l’internaute et la description d’une commande. Ils peuvent figurer dans l’e-mail de confirmation de paiment reçu par le commerçant s’il en fait la demande.
- arg1 : argument privé du commerçant limité à 128 caractères après encodage. Une option dans l’administration commerçant permet de remplacer la référence de la commande par cette valeur.
- arg2 : argument privé du commerçant limité à 128 caractères après encodage.
- arg3 : argument privé du commerçant limité à 256 caractères après encodage.
Important :
- La valeur de ces paramètres ne doit pas contenir de caractères spéciaux. ( , ; . \ / espace, etc.)
sinon il se peut qu’une erreur se produise lors de l’appel au serveur de paiement. Dans tous les
cas, c’est à vous de vous assurer de la conformité des données transmises.
- Vous ne serez pas informé d’un dépassement de leur taille, par contre il se peut que dans ce cas
une erreur se produise lors de l’appel au serveur de paiement ou durant le traitement du paiement. - Dans le champ ´"Payment Extra Info", ajouter :
<?php require_once(PAGEPATH."checkout.spplus_cc_form.php"); ?>
6. Sauvegarder
Configuration de l'administration de SPPLUS
Connectez vous à l'administration de SPPLUS. Cliquez sur informations techniques.
Dans le pavé "Caractéristiques Techniques", pour le paramètre "URL de retour paiement internaute", mettez:
http://www.votresite.com/spplus_notify.php
Dans le pavé "Notification", cochez la case "Notification complémentaire", des paramètres supplémentaires s'affichent. Pour le paramètre "URL1 pour notification complémentaire":
http://www.votresite.com/spplus_cgi.php
Quel numéro de carte utiliser pour les tests ?
Vous pouvez utiliser les 2 cartes bancaires fictives suivantes pour effectuer des tests de paiements :
- 1234567890123456 (16 chiffres) qui génèrera un paiement autorisé.
- 0000000000000000 (16 chiffres) qui génèrera un paiement refusé.
En cas de problème
Vous pouvez poser votre questions sur le forum de Joomla.fr
Vous pouvez aussi contacter le service intégration de SPPLUS soit par e-mail à Cette adresse email est protégée contre les robots des spammeurs, vous devez activer Javascript pour la voir. , soit par téléphone au +33 (0) 899 70 8091 (1.349 € TTC/appel + 0.337 € TTC/min).