SPPLUS est la solution de paiement sécurisé de la Caisse d'Epargne. Le principe de cette 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.

Procédure d'installation du module de paiement pour Virtuemart

Téléchargement du module de paiement

Vous pouvez télécharger le module de paiement pour SPPLUS pour Virtuemart é partir du site de Virtuemart ou bien é partir de ce site .

Installation des fichiers du module de paiement 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_aspcheck.php vers /administrator/components/com_phpshop/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 choisisser 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 é