SPPLUS pour Joomla 1.0 ou Joomla 1.5 et Virtuemart 1.1 - configuration du paiement

Tutoriels

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 :

a. Nom de la méthode de paiement : (Choisissez un nom)
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. Cet e-mail est protégé contre les robots collecteurs de mails, votre navigateur doit accepter le Javascript pour le voir , soit par téléphone au +33 (0) 899 70 8091 (1.349 € TTC/appel + 0.337 € TTC/min).