Comment ajouter PayPal Checkout à mon panier personnalisé ?

Il existe deux façons d'intégrer le traitement des paiements PayPal à votre panier tiers :

  • Indiquez le montant total du panier au lieu du prix de chaque objet.
  • Passez les détails de chaque élément.

Remarque : pour envoyer les variables nécessaires à PayPal comme décrit, vous devrez probablement mettre en œuvre un script sur votre site.

Méthode 1 : transmission du montant total du panier à PayPal

Vous pouvez transmettre le montant total de votre panier dans le code du bouton Acheter de PayPal comme s'il s'agissait d'un achat d'un seul article. Commencez par intégrer l'image et les variables obligatoires, puis personnalisez votre formulaire à l'aide de nos variables supplémentaires et étendues.

Variables obligatoires et image

Le tableau ci-dessous décrit les cinq variables cachées et l'image d'envoi du formulaire requises par le code de votre envoi PayPal.

Nom 

Description 

amount 

Le prix total de tous les articles dans le panier. 

business 

L'adresse email associée à votre compte PayPal. 

currency_code 

Définit le type de devise (par exemple, « USD » et « EUR ») utilisé par les variables monétaires (montant, expédition, expédition2, manutention, taxe). 

image 

Indique l'image pour le bouton de paiement. Vous pouvez la modifier en remplaçant l'attribut src par l'URL de l'imagede votre choix. 

item_name 

Le nom de l'article ou du panier. 

Le code minimum requis pour votre envoi à PayPal doit ressembler à l'exemple suivant :

<input type="hidden" name="cmd" value="_ext-enter">
<form action="https://www.paypal.com/us/cgi-bin/webscr" method="post">
  <input type="hidden" name="cmd" value="_xclick">
  <input type="hidden" name="business" value="[email protected]">
  <input type="hidden" name="item_name" value="Item Name">
  <input type="hidden" name="currency_code" value="USD">
  <input type="hidden" name="amount" value="0.00">
  <input type="image" src="http://www.paypal.com/en_US/i/btn/x-click-but01.gif" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
</form>

Variables supplémentaires

Consultez la page Variables HTML pour PayPal Payments Standard pour obtenir la liste des variables supplémentaires qui peuvent être transmises à votre bouton.

Méthode 2 : transmission d'articles individuels à PayPal

Si vous pouvez configurer votre panier tiers pour transmettre des articles individuels à PayPal, les journaux d'historique et les notifications des acheteurs et des vendeurs incluent des informations sur ces articles. Pour inclure des informations sur les objets, publiez les éléments du formulaire HTML dans un nouveau flux de panier. Ce processus est similaire à celui décrit dans la méthode 1, avec les exceptions suivantes :

Tout d'abord, modifiez l'entrée "cmd" de :

<input type="hidden" name="cmd" value="_xclick">

à :

<input type="hidden" name="cmd" value="_cart">


Variables spécifiques à un article

Pour chacune des variables spécifiques à un article, procédez comme suit :

  • Définissez un nouvel ensemble de valeurs correspondant à chaque article acheté via votre panier tiers.
  • Ajoutez « _x » au nom de la variable, où « x » correspond au numéro de l'article.
  • Définissez la quantité à 1 et incrémentez-la à chaque fois pour refléter l'augmentation de la quantité de cet article spécifique.
  • Incluez un ensemble de variables obligatoires dans le tableau ci-dessous pour chaque objet dans le panier de vos acheteurs.
  • Définissez le premier article inclus dans le panier avec des paramètres se terminant par « _1 » (tels que item_name_1 et amount_1), le deuxième article avec « _2 » (tels que item_name_2 et amount_2), et ainsi de suite.
  • Des variables facultatives peuvent être incluses. Voir Variables HTML pour PayPal Payments Standard.

Remarque : les valeurs « _x » doivent augmenter d'une unité à chaque fois pour que PayPal les reconnaisse. Si vous passez de l'article n° 1 à l'article n° 3 sans définir l'article n° 2, l'article n° 3 sera ignoré.

Toutes les variables monétaires (amount, shipping, shipping2, handling, tax) reflètent la devise désignée par la variable currency_code envoyée avec le paiement. Cela n'est pas spécifique à un article, vous n'avez donc pas besoin d'ajouter « _x » au nom de la variable. Si aucune variable currency_code n'est transmise, la devise par défaut est le dollar américain.

Le tableau ci-dessous décrit les variables spécifiques à un article.

Nom 

Description 

amount_x 

Le prix de cet objet spécifique (requis par objet).

item_name_x 

Le nom (limité à 127 caractères alphanumériques) de cet article spécifique (obligatoire pour chaque article).