![](/html/53/5313/5313838752edc77510897bd013a95aa82a62c432c66c4fff736df27b7034a90f/bg1.png)
Version 1.1 - Janvier 2009
Ajoutez le moyen de paiement plébiscité
par plus d’un tiers des acheteurs en ligne
*
PayPal Option+
Ajoutez le moyen de paiement plébiscité
Leader mondial des paiements en ligne
GUIDE DE DÉMARRAGE
* Baromètre eCommerce de Tns sofrès, septembre 2007.
![](/html/53/5313/5313838752edc77510897bd013a95aa82a62c432c66c4fff736df27b7034a90f/bg2.png)
www.paypal.fr/developpeurs
2
PayPal Option+ | GUIDE DE DÉMARRAGE
INTRODUCTION ............................................................................. p. 3
Étape 1. Ouverture et configuration
de votre compte Business ............................................... p. 4
Étape 2. Choix du la technologie d’intégration .......................... p. 4
Étape 3. Ouverture d’un compte test .......................................... p. 4
Étape 4. Intégration de la solution .............................................. p. 5
Intégration en HTML ..................................................................... p. 5
Intégration en API (Webservice) .................................................. p. 6
Les API au sein du flux de paiement ............................................ p. 9
PayPal Option + : Paiement express avec page de récapitulatif . p. 10
PayPal Option + : Paiement express sans page de récapitulatif . p. 10
Le détail des API .............................................................................. p. 11
Paramètres d’authentification ........................................................ p.11
Réponses aux appels API ................................................................. p.12
SETEXPRESSCHECKOUT ................................................................... p.12
DOEXPRESSCHECKOUT ................................................................... p.14
Étape 5. Test de l’intégration ..................................................... p. 16
Étape 6. Vérification de l’intégration visuelle ........................... p. 16
SOMMAIRE
![](/html/53/5313/5313838752edc77510897bd013a95aa82a62c432c66c4fff736df27b7034a90f/bg3.png)
www.paypal.fr/developpeurs
3
PayPal Option+ | GUIDE DE DÉMARRAGE
INTRODUCTION
Vous désirez intégrer PayPal comme moyen de paiement sur votre site e-commerce en plus des autres
options de paiement que vous proposez déjà.
Ce document a pour objectif de vous guider dans l’intégration de PayPal Option+.
Vous voulez recevoir
des paiements par carte
Vous recevez déjà
des paiements par carte
• Vous avez un site
Internet
• Vous n’avez pas
de site Internet
• Vous ajoutez PayPal
pour augmenter
vos ventes
• Vous ajoutez PayPal
pour booster votre
taux de conversion
PayPal Intégral PayPal Email
PayPal Option +
PayPal Express
• Plateforme de
paiement sécurisée
complète permettant
de gérer les paiements
par carte effectués sur
votre site
• Solution de paiement
permettant au
marchand d’effectuer
des demandes de
paiement à ses clients
grâce à un simple
e-mail
• Moyen de paiement
supplémentaire à
ajouter sur son site
marchand, en plus
de ceux déjà acceptés
• Option de commande
rapide qui permet
aux détenteurs de
compte PayPal de
payer en seulement
2 clics
Intégration
en HTLM ou API
Aucune intégration
nécessaire
Intégration
en HTLM ou API
Intégration
en API
![](/html/53/5313/5313838752edc77510897bd013a95aa82a62c432c66c4fff736df27b7034a90f/bg4.png)
www.paypal.fr/developpeurs
4
PayPal Option+ | GUIDE DE DÉMARRAGE
• Créez un compte PayPal Business sur http://www.paypal.fr/marchands
• Vériez votre compte Business
Pour en savoir plus, consultez le guide d’ouverture de compte (PDF) sur www.paypal.fr/documentation-technique
ÉTAPE 1. Ouverture et configuration de votre compte Business
PayPal vous offre la possibilité d’intégrer ses solutions en HTML ou en API. Le tableau ci-dessous vous
aidera à choisir la technologie adaptée à vos compétences techniques et aux besoins de votre site
e-commerce.
HTML
• Compétences techniques élémentaires
• Intégration simple et rapide
• Paiement effectué sur le site sécurisé
de PayPal
API (WebService)
• Connaissances sur la programmation
API SOAP ou NVP
• Intégration avancée et plus robuste
• Accès aux fonctions variées et avancées
de la plateforme PayPal
• SDK disponibles
• Appels synchrones
ÉTAPE 2. Choix de la technologie d’intégration
L’Environnement de test de PayPal (Sandbox) est un environnement autonome dans lequel vous pouvez
créer des prototypes et tester les fonctions et API de PayPal. Il s’agit d’une copie pratiquement identique
du site en production de PayPal.
Créer un compte de test permettra de tester votre intégration PayPal avant de l’utiliser sur votre site.
Pour en savoir plus sur le fonctionnement de l’Environnement de Test, consultez le guide d’utilisation de l’Environnement
de Test (PDF) à l’adresse suivante : www.paypal.fr/documentation-technique
Pour accéder à l’Environnement de Test de PayPal, connectez-vous sur : https://developer.paypal.com
(vous allez être redirigé vers une page en anglais).
ÉTAPE 3. Ouverture d’un compte test
![](/html/53/5313/5313838752edc77510897bd013a95aa82a62c432c66c4fff736df27b7034a90f/bg5.png)
www.paypal.fr/developpeurs
5
PayPal Option+ | GUIDE DE DÉMARRAGE
* Pour consulter la liste des solutions partenaires, connectez-vous à http://www.paypal.fr/partenaires
ÉTAPE 4. Intégration de la solution
Intégration en HTML
• Copiez et collez le code HTML suivant sur votre page de paiement :
Code HTML
Valeurs
> business : l’adresse email de votre compte PayPal
> item_name : le descriptif de la transaction, visible par l’acheteur
> item_number : un identifiant interne, non visible par l’acheteur (option)
> amount : le montant (utiliser le point comme séparateur décimal)
> currency_code : la devise du paiement (EUR, GBP, USD, etc…)
> no_note : si « 1 », alors PayPal ne demande pas à l’acheteur de saisir un message à votre intention
> no shipping :
Si « 0 », alors PayPal demande à l’acheteur de saisir une adresse de livraison et vous la communique
Si « 1 », alors PayPal ne demande pas à l’acheteur de saisir une adresse de livraison
> lc : définit le langage à présenter par défaut à l’acheteur : FR, EN, ES, IT, DE etc… (option)
Note importaNte
Si vous collectez les coordonnées du client sur votre site, alors vous pouvez les communiquer à PayPal pour
éviter que l’acheteur non-titulaire d’un compte soit contraint de les saisir à nouveau.
VOUS AVEZ DÉJÀ UN PANIER D’ACHAT
Ajout de PayPal Option+
à votre panier
(HTML ou API)
Intégration par biais
de nos partenaires
![](/html/53/5313/5313838752edc77510897bd013a95aa82a62c432c66c4fff736df27b7034a90f/bg6.png)
www.paypal.fr/developpeurs
6
PayPal Option+ | GUIDE DE DÉMARRAGE
Pour cela, copiez et collez le code HTML suivant sur votre page de paiement :
Valeurs
> Vous passez les coordonnées de l’acheteur dans les variables first_name, last_name, address1,
address2, city, zip, country, night_phone_a (et _b et _c).
> Les variables cmd et redirect_cmd sont différentes de l’exemple précédent.
> Le reste des paramètres est défini comme précédemment.
> Vous pouvez aussi optionnellement passer à PayPal les objets présents dans votre panier
(cf. liens ci-dessous).
Pour plus d’informations sur les fonctionnalités et options disponibles, consultez le guide détaillé PayPal Option+ en HTML
(PDF) disponible sur www.paypal.fr/documentation-technique
Intégration en API (Webservice)
Génération des codes d’authentification API
Afin de pouvoir utiliser l’API ExpressCheckout de PayPal, vous devez au préalable générer des codes
d’authentification API.
• Connectez-vous à partir de https://developer.paypal.com sur le compte test Business Sandbox en
cliquant sur Enter Sandbox Test Site.
Code HTML