Paypal

Paypal est un plugin technique qui vous permet de créer des formulaires de paiement paypal.

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:

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ètresexplicationsValeur 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ètresexplications
email Email
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ètresexplications
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.

Alternatives

Il existe d’autres plugins qui gèrent le paiement avec paypal

Ceci est une embauche de documentation. Ne pas hésiter à la compléter ou la rectifier.

updated on 2 October 2019

Discussion

12 discussions

Comment on this article

Who are you?
  • [Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom