Guide de démarrage rapide | PayPal Intégral 2009 Manuel utilisateur

PayPal Intégral
Acceptez les paiements en ligne
grâce à une plateforme complète
Guide de démarraGe
Version 1.1 - Janvier 2009
Leader mondial des paiements en ligne
PayPal Intégral | Guide de démarraGe
SO mm aire
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 (facultative) ..................... p. 4
Étape 4. intégration de la solution .............................................. p. 5
OPTiON 1 : Création d’un bouton de paiement (HTmL) ............. p. 5
OPTiON 2 : Création d’un panier d’achat (HTmL) ....................... p. 9
OPTiON 3 : intégration du panier d’achat et de PayPal
intégral par le biais de nos partenaires .................. p. 12
OPTiON 4 : ajout de la plateforme de paiement
à votre panier professionnel (HTmL ou aPi) .......... p. 13
OPTiON 5 : intégration de la solution PayPal intégral
par le biais de nos partenaires ................................ p. 15
Étape 5. Test de l’intégration (facultatif) .................................. p. 15
Étape 6. Vérification de l’intégration visuelle ........................... p. 16
www.paypal.fr/developpeurs
2
PayPal Intégral | Guide de démarraGe
iNTrOduCTiON
Vous désirez intégrer PayPal comme solution de paiement sur votre site e-commerce pour accepter
les paiements par carte et compte PayPal.
Ce document a pour objectif de vous guider dans l’intégration de PayPal intégral.
Vous voulez recevoir
des paiements par carte
• Vous avez un site
internet
• Vous n’avez pas
de site internet
Vous recevez déjà
des paiements par carte
• 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
www.paypal.fr/developpeurs
3
PayPal Intégral | Guide de démarraGe
ÉTAPE 1. Ouverture et configuration de votre compte Business
• Créez un compte PayPal Business sur http://www.paypal.fr/marchands
• Vérifiez votre compte Business
Pour en savoir plus, consultez le guide d’ouverture de compte (PDF) sur www.paypal.fr/documentation-technique
ÉTAPE 2. Choix de la technologie d’intégration
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
API (WebService)
• Compétences techniques élémentaires
• Intégration simple et rapide
• Paiement effectué sur le site sécurisé
de PayPal
• 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 3. Ouverture d’un compte test (facultative)
Note importaNte
Il n’est pas nécessaire de créer un compte test pour tester les boutons et le panier PayPal créés avec l’Assistant
pour création de boutons.
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).
www.paypal.fr/developpeurs
4
PayPal Intégral | Guide de démarraGe
ÉTAPE 4. Intégration de la solution
1
2
Créez votre compte Business pour vendre en ligne
Vous voulez une solution qui
gère le panier d’achat ?
Vous voulez gérer
le panier d’achat vous-même.
Si vous
vendez 1 article
à la fois.
Si vous vendez
- de 15 articles
sur votre site.
Si vous vendez
+ de 15 articles
sur votre site.
Installation
d’un bouton
d’achat pour
vendre en ligne
Installation du
panier d’achat
PayPal, qui
comprend notre
solution de paiement
PayPal Intégral
Installation
du panier d’achat
et de PayPal Intégral
par le biais de
nos partenaires*
Installation de
la solution PayPal
Intégral par
vous-même
en HTML ou API
Installation de
la solution PayPal
Intégral par
le biais de nos
partenaires*
en HTML ou API
oPtIon 1
oPtIon 2
oPtIon 3
oPtIon 4
oPtIon 5
* Pour consulter la liste des solutions partenaires, connectez-vous à http://www.paypal.fr/partenaires
oPtIon 1 >
création d’un bouton de paiement (HtML)
Les boutons de paiement PayPal conviennent parfaitement au paiement d’un seul ou d’un petit nombre
d’objets. L’assistant pour création de boutons vous permet de choisir toutes les options et génère un
code HTmL que vous pouvez simplement copier et coller dans le code HTmL de votre site.
Les boutons Acheter sont faciles à configurer et à utiliser.
Connectez-vous sur http://www.paypal.fr/boutons pour y accéder.
Étape 1 : choisissez le type de bouton et saisissez les détails du paiement
• Connectez-vous ou ouvrez un compte PayPal Business pour utiliser toutes les fonctions de l’assistant
pour création de boutons sur www.paypal.fr/marchands
• Indiquez le type d’articles que vous souhaitez vendre
• Cliquez sur non, créer un bouton Acheter
• Indiquez le nom, le prix et tous les autres éléments de l’objet que vous souhaitez vendre.
www.paypal.fr/developpeurs
5
PayPal Intégral | Guide de démarraGe
• Ajoutez des informations facultatives telles que le montant de la livraison, la TVA et des champs
d’option (de taille, de couleur, etc…).
Étape 2 : Effectuez le suivi de votre stock (facultatif)
Vous devez vous connecter ou ouvrir un compte PayPal Business pour bénéficier de cette option :
• Choisissez d’ajouter les options Enregistrer le bouton auprès de PayPal et Effectuer le suivi du stock
en fonction de vos besoins.
www.paypal.fr/developpeurs
6
PayPal Intégral | Guide de démarraGe
Étape 3 : Fonctions de paiement (facultatif)
Vous devez vous connecter ou ouvrir un compte PayPal Business pour bénéficier de cette option :
• Choisissez de Personnaliser les pages de paiement (modification des quantités demandées, instructions
spéciales, adresse de livraison, etc…).
• Cliquez sur créer un bouton pour que l’assistant pour création de boutons génère le code HTmL
personnalisé.
• Copiez et collez le code HTML sur votre site afin de créer le bouton choisi.
www.paypal.fr/developpeurs
7
PayPal Intégral | Guide de démarraGe
Lorsqu’un acheteur clique sur le bouton de paiement, il accède à une page de paiement sécurisée
PayPal à partir de laquelle il peut payer soit par carte bancaire soit par son compte PayPal.
Bannière Personnalisée
www.paypal.fr/developpeurs
8
PayPal Intégral | Guide de démarraGe
oPtIon 2 >
création d’un panier d’achat (HtML)
Lorsque vous utilisez le Panier d’achat PayPal sur votre site, vos clients peuvent acheter plusieurs objets
et payer en une seule fois, parcourir la liste complète des objets que vous proposez et visualiser la liste
récapitulative des objets qu'ils ont sélectionnés avant d'effectuer leur achat.
Le Panier d’achat PayPal est facile à configurer et à utiliser.
Connectez-vous sur www.paypal.fr/boutons pour y accéder.
Étape 1 : choisissez le type de bouton et saisissez les détails du paiement
• Connectez-vous ou ouvrez un compte PayPal Business pour utiliser toutes les fonctions de l'assistant
pour création de boutons sur www.paypal.fr/marchands
• Indiquez le type d’articles que vous souhaitez vendre
• Cliquez sur oui, créer un bouton Ajouter au panier
• Indiquez le nom, le prix et tous les autres éléments de l'objet que vous souhaitez vendre
• Ajoutez des informations facultatives telles que la livraison, la TVA et des champs d'option (de taille,
de couleur, etc…).
www.paypal.fr/developpeurs
9
PayPal Intégral | Guide de démarraGe
Étape 2 : Effectuez le suivi de votre stock (facultatif)
Vous devez vous connecter ou ouvrir un compte PayPal Business pour bénéficier de cette option :
• Choisissez d’ajouter les options Enregistrer le bouton auprès de PayPal et Effectuer le suivi du stock
en fonction de vos besoins.
www.paypal.fr/developpeurs
10
PayPal Intégral | Guide de démarraGe
Étape 3 : Fonctions de paiement (facultatif)
Vous devez vous connecter ou ouvrir un compte PayPal Business pour bénéficier de cette option :
• Choisissez de Personnaliser les pages de paiement (modification des quantités demandées, instructions
spéciales, adresse de livraison, etc…)
• Cliquez sur créer un bouton pour que l'assistant pour création de boutons génère le code HTmL
personnalisé.
• Copiez et collez le code HTML sur votre site afin de créer le bouton choisi.
www.paypal.fr/developpeurs
11
PayPal Intégral | Guide de démarraGe
Lorsqu’un acheteur clique sur Ajouter au panier, une nouvelle fenêtre s’ouvre. Cette fenêtre affiche le
contenu du Panier PayPal de l’acheteur, y compris l’objet qui vient d’y être ajouté.
Bannière Personnalisée
récapitulatif du panier
oPtIon 3 >
Intégration du panier d'achat et de PayPal Intégral par le biais
de nos partenaires
Vous pouvez activer la solution directement dans le back-office des solutions de nos partenaires.
Pour consulter la liste de nos partenaires, connectez-vous à :
https://www.paypal-france.fr/marchands/partenaires-paypal/
www.paypal.fr/developpeurs
12
PayPal Intégral | Guide de démarraGe
oPtIon 4 >
Ajout de la plateforme de paiement PayPal à votre panier
professionnel (HtML ou API)
La solution PayPal intégral est également destinée aux développeurs souhaitant intégrer la procédure
de paiement à leur propre panier professionnel au lieu du Panier PayPal standard. Vous avez la
possibilité d’installation PayPal en HTmL ou en aPi.
• Sur votre page de paiement, faites savoir à vos acheteurs ou visiteurs que la solution de paiement
PayPal intégral vous permet d’accepter différents moyens de paiement.
Vous pouvez télécharger les logos à partir de www.paypal.fr/logos
Intégration en HtML
• Copiez et collez le code HTML suivant sur votre page de paiement :
code HtML
<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
<input type="hidden" name="cmd" value="_xclick"/>
<input type="hidden" name="business" value="moi@monsite.com"/>
<input type="hidden" name="item_name" value="nom de l’objet"/>
<input type="hidden" name="item_number" value="identifiant interne"/>
<input type="hidden" name="amount" value="10.00"/>
<input type="hidden" name="currency_code" value="EUR"/>
<input type="hidden" name="no_note" value="1"/>
<input type="hidden" name="no_shipping" value="0"/>
<input type="hidden" name="lc" value="FR"/>
<input type="image" src=" https://www.paypal.com/fr_FR/i/bnr/horizontal_solution_
PP.gif" border="0" name="submit" alt="Paiement sécurisé par carte bancaire"/>
</form>
Valeurs
> business : l’adresse e-mail 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.
www.paypal.fr/developpeurs
13
PayPal Intégral | Guide de démarraGe
Pour cela, copiez et collez le code HTmL suivant sur votre page de paiement :
code HtML
<form action="https://www.paypal.com/cgi-bin/webscr" method="POST">
<input type="hidden" name="cmd" value="_ext-enter">
<input type="hidden" name="redirect_cmd" value="_xclick">
<input type="hidden" name="first_name" value="Prénom">
<input type="hidden" name="last_name" value="Nom">
<input type="hidden" name="address1" value="9 rue de l’Eglise">
<input type="hidden" name="address2" value="Bat A">
<input type="hidden" name="city" value="Paris">
<input type="hidden" name="zip" value="75000">
<input type="hidden" name="country" value="FR">
<input type="hidden" name="night_phone_a" value="33">
<input type="hidden" name="night_phone_b" value="146000000">
<input type="hidden" name="night_phone_c" value="">
<input type="hidden" name="business" value=" moi@monsite.com">
<input type="hidden" name="item_name" value="n nom de l’objet">
<input type="hidden" name="item_number" value=" identifiant interne">
<input type="hidden" name="amount" value=" 10.00">
<input type="hidden" name="no_note" value="1"/>
<input type="hidden" name="no_shipping" value="1"/>
<input type="hidden" name="lc" value="FR"/>
<input type="image" src=" https://www.paypal.com/fr_FR/i/bnr/horizontal_solution_
PP.gif" border="0" name="submit" alt="Paiement sécurisé par carte bancaire"/>
</form>
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 en savoir plus sur les fonctionnalités et options disponibles, consultez le guide détaillé PayPal Intégral en HTML (PDF)
disponible sur www.paypal.fr/documentation-technique
Intégration en API
Pour intégrer PayPal intégral à votre panier professionnel en version aPi, consultez le guide d’intégration
de PayPal intégral en version aPi (PdF) disponible sur :
www.paypal.fr/documentation-technique
www.paypal.fr/developpeurs
14
PayPal Intégral | Guide de démarraGe
oPtIon 5 > Intégration de la solution PayPal Intégral par le biais de nos
partenaires
Vous pouvez activer la solution directement dans le back-office des solutions de nos partenaires.
Pour consulter la liste de nos partenaires, connectez-vous à :
https://www.paypal-france.fr/marchands/partenaires-paypal/
Autres documentations et liens utiles
Guide d’intégration de Paiement express (PdF)
https://www.paypalobjects.com/fr_Fr/Fr/pdf/PP_expressCheckout_integrationGuide.pdf
Guide d’intégration de la gestion des commandes (PdF)
https://www.paypal.com/fr_Fr/pdf/PP_Ordermanagement_integrationGuide.pdf
Guide de développement et référence de l’API nVP PayPal (PdF)
https://www.paypal.com/fr_Fr/pdf/PP_NVPaPi_developerGuide.pdf
Guide de référence de l'API SoAP (PdF)
https://www.paypal.com/fr_Fr/pdf/PP_aPireference.pdf
Retrouvez toutes ces informations sur l’espace développeurs à l’adresse suivante : www.paypal.fr/developpeurs
ÉTAPE 5. Test de l’intégration
Note importaNte
Il n’est pas nécessaire de créer un compte test pour tester les boutons et le panier PayPal créés avec l’Assistant
pour création de boutons.
Pour tester votre intégration grâce à l’Environnement de test :
• Ouvrez un compte Sandbox (si vous ne l’avez pas déjà fait)
• Connectez-vous à votre compte sur https://developer.paypal.com
• Créez des comptes test Vendeur (Business) et Acheteur (Personnel)
• Vérifiez votre compte test Vendeur
• Testez votre intégration
Pour plus d’informations 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 6.Vérification de l’intégration visuelle
afin d’optimiser l’expérience d’achat et d’augmenter les ventes, choisissez la meilleure intégration
visuelle. Pour cela, consultez le guide d’intégration visuelle (PdF) sur :
www.paypal.fr/documentation-technique
www.paypal.fr/developpeurs
15
PayPal (Europe) S.à r.l. & Cie, S.C.A.
Siège social : 22-24 Boulevard Royal
L-2449, Luxembourg
RCS Luxembourg B 118 349
Contact PayPal
Tél. : 0 800 942 850 (appel gratuit)
E-mail : marchands@paypal.fr
Web : www.paypal.fr/developpeurs
Copyright © 1999-2008 PayPal. Tous droits réservés.