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" :
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:
Accueil 
Analyse 
