Ecommerce DEV - Ajouter la fonction de validation/paiement PayPal à votre Panier d'achat

Mar 31 2006

Ajouter la fonction de validation/paiement PayPal à votre Panier d'achat

Analyse - Fonctionnalités

Ecrit par PayPpal

31-03-2006

Certains développeurs de sites p

Certains développeurs de sites peuvent souhaiter intégrer le processus de paiement à leur propre panier professionnel au lieu du Panier PayPal standard. Veuillez suivre les instructions ci-dessous pour autoriser vos acheteurs à payer avec PayPal lorsqu'ils sont prêts à valider et à payer une fois qu'ils ont ajouté tous leurs objets à leur panier professionnel autre que PayPal.

Il y a maintenant deux manières d'intégrer votre panier professionnel autre que PayPal dans le processus de paiement PayPal. La première consiste à transmettre la montant total du panier, plutôt que le montant des objets uniques. La seconde consiste à transmettre à PayPal les détails des objets sélectionnés, au lieu du montant total de l'ensemble du panier. Remarque : pour publier les variables requises sur PayPal selon la procédure décrite ci-dessous, vous devrez probablement installer de nouveaux scripts sur votre site.

* Méthode 1. Transmission du montant total du panier à PayPal
* Méthode 2. Transmission d'objets uniques à PayPal

Méthode 1. Transmission du montant total du panier à PayPal

Si vous le souhaitez, vous pouvez regrouper votre panier et transmettre le montant total dans le code des boutons Acheter maintenant (c'est-à-dire que vous devrez publier un nom unique pour le panier entier ou le prix total du contenu du panier comme s'il s'agissait de l'achat d'un objet unique).

L'un des inconvénients de cette méthode est que vos utilisateurs ne pourront voir apparaître les objets uniques dans leur panier. De plus, vous ne pouvez pas modifier nos noms de variable, et vous ne pouvez pas ajouter vos propres noms de variable.

Si vous avez d'autres questions techniques après avoir consulté les informations ci-dessous, visitez notre page Service d'assistance développeurs. Pour plus d'informations sur le code des boutons Acheter maintenant ou sur les variables ci-dessous, consultez le Guide d'intégration de Paiements sur site marchand (PDF, 7 Mo, novembre 2005).

Variables obligatoires

Le code de votre enregistrement PayPal doit contenir les 4 variables cachées suivantes, ainsi qu'une image pour l'envoi du formulaire :

Variables obligatoires
Nom	Valeur
business	Adresse email associée à votre compte PayPal
item_name	Nom de l'objet (ou nom du panier).
currency_code	Définit la devise dans laquelle les variables monétaires (amount, shipping, shipping2, handling, tax) sont indiquées. Les valeurs possibles sont les suivantes : "USD", "EUR", "GBP", "CAD", "JPY".
amount	Prix de l'objet (prix total de tous les objets du panier)
image	Image associée au bouton sur lequel votre acheteur appuiera pour initier le processus de paiement PayPal. Vous pouvez sélectionner votre propre image en remplaçant la valeur src par l'URL de votre image.

Ceci signifie que le code requis minimal pour votre publication sur PayPal se présentera comme suit :

<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
<input type="hidden" name="cmd" value="_xclick">
<input type="hidden" name="business" value=" ">
<input type="hidden" name="item_name" value="Nom de l'objet">
<input type="hidden" name="currency_code" value="USD">
<input type="hidden" name="amount" value="0,00">
<input type="image" src="http://www.paypal.com/fr_FR/i/btn/x-click-but01.gif" name="submit" alt="Effectuez vos paiements via PayPal : une solution rapide, gratuite et sécurisée !">
</form>

PayPal fournit des variables supplémentaires pour personnaliser la publication de votre formulaire. La liste complète des variables disponibles est répertoriée ci-dessous (les noms de variable doivent figurer en minuscules) :

Variables disponibles
Nom	Valeur
business	Adresse email associée à votre compte PayPal
quantity	Nombre d'objets. Si cette valeur est supérieure à un, le montant est multiplié.
item_name	Nom de l'objet (ou nom du panier). Doit être alphanumérique (127 caractères maximum).
item_number	Variable de transit facultative vous permettant d'effectuer le suivi des paiements. Doit être alphanumérique (127 caractères maximum).
amount	Prix de l'objet (prix total de tous les objets du panier)
shipping	Frais de livraison pour chaque objet
shipping2	Frais de livraison pour chaque objet supplémentaire
handling	Frais de dossier
tax	Valeur de taxe basée sur la transaction. Si elle est présente, la valeur transmise ici remplace tous les éventuels paramètres de taxe définis dans le Profil (indépendamment de l'adresse de l'acheteur).
no_shipping	Adresse de livraison. Si cette valeur est "1", votre utilisateur ne sera pas invité à entrer une adresse de livraison. Cette option est facultative ; si elle est omise ou égale à "0", votre utilisateur sera invité à indiquer une adresse de livraison.
cn	Libellé facultatif qui apparaît au-dessus du champ Remarque (40 caractères maximum)
no_note	Insertion d'une remarque avec le paiement. Si cette valeur est égale à "1", votre utilisateur ne sera pas invité à inclure une remarque. Cette option est facultative, si vous l'ignorez ou si vous lui affectez la valeur "0", l'utilisateur sera invité à inclure une remarque.
on0	Nom du premier champ d’option. 64 caractères maximum.
os0	Premier ensemble de valeur(s) d'option. 200 caractères maximum. La valeur "on0" doit être définie pour permettre la reconnaissance de "os0".
on1	Nom du second champ d’option. 64 caractères maximum.
os1	Deuxième ensemble de valeur(s) d'option. 200 caractères maximum. La valeur "on1" doit être définie pour permettre la reconnaissance de "os1".
custom	Variable de transit facultative qui n'est jamais présentée à l'utilisateur. Peut être utilisée pour le suivi du stock.
invoice	Variable de transit facultative qui n'est jamais présentée à l'utilisateur. Peut être utilisée pour le suivi des numéros de paiement.
notify_url	Utilisée uniquement avec la fonction NIP. URL Internet vers laquelle seront dirigées les publications de formulaire NIP.
return	URL Internet vers laquelle votre utilisateur sera dirigé une fois le paiement effectué.
cancel_return	URL Internet vers laquelle votre utilisateur sera dirigé une fois le paiement annulé.
image_url	L'URL Internet est l'image de 150 X50 pixels que vous souhaitez utiliser comme logo.
cs	Définit la couleur d'arrière-plan de vos pages de paiement. Si cette valeur est "1", la couleur d'arrière-plan est le noir. Cette option est facultative : si vous l'ignorez ou si elle est égale à "0", la couleur d'arrière-plan est le blanc.

Variables étendues

PayPal vous permet de publier des variables étendues si vous modifiez cette entrée "cmd" :

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

en :

<input type="hidden" name="cmd" value="_ext-enter">
<input type="hidden" name="redirect_cmd" value="_xclick">

En modifiant l'entrée "cmd" comme indiqué ci-dessus, vous pouvez également utiliser les variables ci-dessous :

Variables étendues
Nom	Valeur
email	Adresse email de l'utilisateur
first_name	Prénom de l'utilisateur. Doit être alphanumérique (32 caractères maximum).
last_name	Nom de l'utilisateur. Doit être alphanumérique (64 caractères maximum).
address1	Première ligne de l'adresse de l'utilisateur. Doit être alphanumérique (100 caractères maximum).
address2	Deuxième ligne de l'adresse de l'utilisateur. Doit être alphanumérique (100 caractères maximum).
city	Ville de l'adresse de l'utilisateur. Doit être alphanumérique (100 caractères maximum).
state	Etat de l'adresse de l'utilisateur. Indiquez l'abréviation officielle en 2 lettres.
zip	Code postal de l'adresse de l'utilisateur
night_phone_a	Indicatif régional du numéro de téléphone où l'utilisateur peut être joint le soir
night_phone_b	Les trois premiers chiffres du numéro de téléphone où l'utilisateur peut être joint le soir

day_phone_a	Indicatif régional du numéro de téléphone où l'utilisateur peut être joint dans la journée
day_phone_b	Les trois premiers chiffres du numéro de téléphone où l'utilisateur peut être joint dans la journée

Remarque :Pour indiquer des frais de livraison et de traitement différents des frais de livraison par défaut définis dans votre Profil, accédez à votre Profil, modifiez vos calculs des frais de livraison et cochez la case "Autoriser le remplacement des paramètres de livraison relatifs à la transaction".

Méthode 2. Transmission d'objets uniques à PayPal

Si votre panier professionnel autre que PayPal peut être configuré pour transmettre des objets individuels à PayPal, les informations sur les objets sont incluses dans les historiques et les notifications des acheteurs et des vendeurs. Pour inclure des informations à propos des objets, vous devez publier des éléments de formulaire HTML dans une nouvelle version du processus Panier de PayPal. Ce processus est très semblable à celui décrit dans la section 1, "Transfert du montant total du panier vers PayPal", à l'exception des différences suivantes :

Définissez la variable "cmd" sur "_cart"
Remplacez cette ligne HTML obligatoire

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

par

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

Ajoutez une nouvelle variable nommée "upload"

Ajoutez la ligne suivante entre les balises <form> et </form>

<input type="hidden" name="upload" value="1">

Définir les détails de l'objet

Pour chacun des paramètres spécifiques de l'objet suivants, définissez un nouvel ensemble de valeurs correspondant à chaque objet acheté par l'intermédiaire de votre panier professionnel autre que PayPal. Ajoutez "_x" au nom de la variable, où x est le numéro de l'objet, commençant par 1 et s'incrémentant d'une unité pour chaque objet ajouté.

Nom	Valeur
item_name_x	(Obligatoire pour l'objet #x) Nom de l'objet #x dans le panier. Doit être alphanumérique (127 caractères maximum).
item_number_x	Variable de transit facultative associée à l'objet x dans le panier. Doit être alphanumérique (127 caractères maximum).
amount_x	(Obligatoire pour l'objet x) Prix de l'objet x
shipping_x	Coût de livraison de la première unité (quantité de 1) de l'objet #x
shipping2_x	Coût de livraison de chaque unité supplémentaire (quantité de 2 ou plus) de l'objet #x
handling_x	Frais de dossier pour l'objet #x
on0_x	Nom du premier champ d'option pour l'objet #x. 64 caractères maximum.
os0_x	Premier ensemble de valeur(s) d'option pour l'objet #x. 200 caractères maximum. La valeur "on0_x" doit être définie pour permettre la reconnaissance de "os0_x".
on1_x	Nom du second champ d'option pour l'objet #x. 64 caractères maximum.
os1_x	Premier ensemble de valeur(s) d'option pour l'objet #x. 200 caractères maximum. La valeur "on1_x" doit être définie pour permettre la reconnaissance de "os1_x".

Répéter pour chaque objet inclus dans le panier

Incluez un ensemble de variables obligatoires et facultatives répertoriées dans le tableau ci-dessus pour chaque objet du panier de votre acheteur. Le premier objet du panier doit être défini par des paramètres se terminant par "_1", tels que "item_name_1", "amount_1", etc. De même, le deuxième objet doit être désigné par des variables telles que "item_name_2", "amount_2", etc. Remarque : les valeurs "_x" doivent être incrémentées d'une unité de manière continue pour être reconnues. Si vous passez directement de l'objet 1 à l'objet 3 sans définir d'objet 2, le troisième objet est ignoré.

Pour indiquer la devise : toutes les variables monétaires (amount, shipping, shipping2, handling, tax) seront interprétées dans la devise désignée par la variable "currency_code" publiée avec le paiement. Le nom de la variable n'étant pas spécifique à l'objet, il n'est pas nécessaire de lui ajouter un "_x". Si aucune variable "currency_code" n'est publiée, nous supposerons que toutes les valeurs monétaires sont en Dollars USD.

Si vous avez d'autres questions techniques après avoir consulté les informations ci-dessous, visitez notre page Service d'assistance développeurs. Pour plus d'informations sur le code des boutons Acheter maintenant ou sur les variables ci-dessous, consultez le Guide d'intégration de Paiements sur site marchand (PDF, 7 Mo, novembre 2005).

Source:

Cet article est extrait du site de Paypal à l'adresse:

https://www.paypal.com/fr/cgi-bin/webscr?cmd=_pdn_howto_checkout_outside

Dernière mise à jour : ( 31-03-2006 )