Certains développeurs de sites peuvent souhaiter intégrer la procédure 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 à 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 la procédure de paiement PayPal. La première consiste à transmettre le montant total du panier, plutôt que le montant des différents objets. 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 |
|
Si vous le souhaitez, vous pouvez regrouper votre panier et transmettre le montant total dans le code des boutons
Acheter (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 seul objet).
L'un des inconvénients de cette méthode est que vos utilisateurs ne pourront voir apparaître les différents objets 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 ou sur les variables ci-dessous, consultez le
Guide d'intégration de PayPal Intégral.
Variables obligatoiresLe 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 la procédure 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/fr/cgi-bin/webscr" method="post">
<input type="hidden" name="cmd" value="_xclick">
<input type="hidden" name="business" value="you@youremail.com">
<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/fr_FR/i/btn/x-click-but01.gif" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
</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 écho 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 les Préférences (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 écho facultative qui n'est jamais présentée à l'utilisateur. Peut être utilisée pour le suivi du stock. | | invoice | Variable écho facultative qui n'est jamais présentée à l'utilisateur. Peut être utilisée pour le suivi des numéros de facture. | | notify_url | Utilisée uniquement avec la fonction IPN. URL Internet vers laquelle seront dirigées les publications de formulaire IPN. | | 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 étenduesPayPal 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 vos Préférences, accédez à vos Préférences, 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'un seul objet à 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 de la procédure Panier de PayPal. Cette procédure 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 écho 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 de panier ou sur les variables ci-dessous, consultez le
Guide d'intégration de PayPal Intégral.
