Attention le plugin permet simplement de créer des formulaires de paiement. Il ne gère pas un panier, une boutique, .... C’est à vous d’implémenter les boucles requises.
Ce plugin a été concu par Matthieu Marcillaud, Les Développements Durables et touti. Merci à eux.
Installation et configuration
Une fois le plugin installé, aller dans le panneau de configuration pour régler les options suivantes
Type d’environnement | test ou production | est que les paiements sont réels ou simulés ? |
Compte | email de votre compte paypal | Le compte paypal (email) qui reçoit l’argent |
Devise | euro ou dollar |
Sur le site paypal, dans le compte du vendeur, il faut aussi :
- Définir la TVA dans vos préférences
- Penser à activer IPN (le retour de confirmation de transactions)
Utilisation rédacteur
Le plugin offre un modèle pour insérer un bouton d’une manière simplifiée
Bouton d’achat
<paypal
|titre=Tongues vertes
|prix=15>
Affichera
Bouton de don
Pour les dons, le prix est facultatif (don libre)
<paypal
|type=donner
|titre=Sauvons les écureuils>
Affichera
Utilisation développeur
Deux pages de démonstrations sont disponibles :
- http://monsite/?page=demo_paypal : un paiement simple
- http://monsite/?page=demo_paypal_details : un paiement complexe avec un panier comportant plusieurs articles
Le syntaxe générale du formulaire est :
[(#FORMULAIRE_PAYPAL{#ARRAY{
prix,30,
libelle,T-Shirt Pomme,
redirect_ok,[(#URL_PAGE{paiement_ok})],
}})]
Voici les paramètres principaux du tableau #ARRAY
à fournir
Pour connaitre l’intégralité des paramètres, éditer le fichier formulaires/paypal.html
Paramètres liés à la commande
Paramètres | explications | Valeur par défaut |
---|---|---|
prix | prix de l’objet | |
libelle | description courte de l’objet | |
redirect_url | adresse de retour, une fois le paiement effectué | |
shipping | frais de port | 0 |
type | (vide) : acheter abonnement : abonnement donner : faire un don |
(vide) |
no_shipping | 0 : on demande, mais pas obligatoire 1 : pas demandé 2 : obligatoire. |
1 |
Paramètres liés l’acheteur
Il est aussi possible de passer les coordonnées de l’acheteur pour pré-remplir son adresse
Paramètres | explications |
---|---|
first_name | Prénom |
last_name | Nom |
address1 | Voie |
address2 | Complément |
city | Ville |
zip | Code postal |
country | Code du pays (2 lettres, idem plugin « pays ») |
night_phone_b | Numéro de téléphone |
Exemple de syntaxe avancée
Voici un usage avancé du formulaire issu du code du squelette zcommerce qui permet d’afficher le détail d’une commande avec plusieurs articles dans l’interface Paypal.
[(#FORMULAIRE_PAYPAL{#ARRAY{
custom,payer_commande,
libelle,Commande #ID_COMMANDE,
identifiant,#REFERENCE,
redirect_ok, #URL_ACTION_AUTEUR{
supprimer_panier_encours,
"",
#URL_PAGE{
z-commerce,
appel=paiement,
reference=#REFERENCE}},
details,#GET{details},
}})]
On appelle le formulaire avec un tableau #ARRAY contenant :
Paramètres | explications |
---|---|
custom, libelle, identifiant | la commande de l’internaute |
redirect_ok | page de retour (dans l’exemple, une URL d’action qui vide le panier) |
details | détails de la commande (un tableau) |
IPN
L’IPN est le mécanisme technique de Paypal pour informer au site vendeur si une transaction a été validé ou non. Pensez à bien activer l’option dans le compte paypal du vendeur.
Le plugin gère ce retour IPN et si la transaction est bonne, il l’envoie au pipeline traitement_paypal.
Pour avoir un exemple d’utilisation de ce pipeline, on pourra consulter le plugin Commandes Paypal.
SPIP4
En SPIP4, pour des raisons de sécurité, les données ne sont pas transmises aussi le raccourci du modèle risque de ne pas fonctionner, il faut alors utiliser le système d’inclusion dans le squelette.
<INCLURE{fond=modeles/paypal, env}>
Alternatives
Il existe d’autres plugins qui gèrent le paiement avec paypal
Aucune discussion
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires : |