PAYPAL Paiement Express - 2007 Guide d'intégration [fr]

Guide d’intégration de Paiement express PayPal

Référence : 100010.en_US-200702

© 2007 PayPal, Inc. Tous droits réservés. PayPal et le logo PayPal sont des marques déposées de PayPal, Inc. Les autres marques et marques
commerciales mentionnées sont la propriété de leurs détenteurs respectifs.
Les informations contenues dans ce document sont la propriété de PayPal Inc. et ne peuv ent être utilisées, reproduites ni diffusées sans
l'autorisation écrite de PayPal, Inc.
PayPal Europe Limited est autorisée et réglementée par la Financial Services Authority (FSA) du Royaume-Uni en tant qu'institution émettrice de
monnaie électronique.
Numéro de registre FSA de PayPal : 226056.

Avis de non responsabilité :
PayPal, Inc. fournit les informations de ce manuel en l'état. PayPal, Inc. ne fournit de quelque manière que ce soit (expresse, tacite ou légale)
aucune garantie résultant de ces informations. PayPal, Inc. n'assume aucune responsabilité en cas d'erreurs ou d'omissions pour tous dommages
(directs ou indirects), résultant de l'utilisation de ce manuel ou des informations qu'il contient ou résultant de l'application ou de l'utilisation du
produit ou du service décrit dans ce document. PayPal, Inc. se réserve le droit de modifier les informations de ce manuel sans préavis.
PayPal, Inc. ne garantit pas que les fonctionnalités décrites dans ce manuel seront annoncées ou mis es à di sposition de tous à l'avenir.

Guide

Guide d’intégration de Paiement express Février 2007 3

Guide

© 2007 PayPal, Inc. Tous droits réservés. PayPal et le logo P ayPal sont des marques déposées de PayPal, Inc. Les autres marques et
marques commerciales mentionnées sont la propriété de leurs détenteurs respectifs. Les informations contenues dans ce document
sont la propriété de PayPal Inc. et ne peuvent être utilisées, reproduites ni diffusées sans l'autorisation écrite de PayPal, Inc.
PayPal Europe Limited est autorisée et réglementée par la Financial Services Authority (FSA) du Royaume-Uni en tant qu'institution
émettrice de monnaie électronique.
Numéro de registre FSA de PayPal : 226056.

Avis de non responsabilité :
PayPal, Inc. fournit les informations de ce manuel en l'état. PayPal, Inc. ne fournit de quelque manière que ce soit (expresse, tacite
ou légale) aucune garantie résultant de ces informations. PayPal, Inc. n'assume aucune responsabilité en cas d'erreurs ou d'omis-
sions pour tous dommages (directs ou indirects), résultant de l'utilisation de ce manuel ou des informations qu'il contien t ou résultant
de l'application ou de l'utilisation du produit ou du service décrit dans ce document. PayPal, Inc. se réserve le droit de modifier les
informations de ce manuel sans pré a v is.
PayPal, Inc. ne garantit pas que les fonctionnalités décrites dans ce manuel seront annoncées ou mises à disposition de tous à l'ave-
nir.

4 Février 2007 Guide d’intégration de Paiement express

Sommaire

Chapitre P Préface . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

A propos de ce document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Public ciblé. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Conventions typographiques. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Problèmes relatifs à la documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Historique des révisions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Premiers pas : Espace Intégration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Qu'est-ce que la fonction Paiement express PayPal ?. . . . . . . . . . . . . . . . . . . . 17

Fonctionnement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Disponibilité . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Compatibilité . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Sources d'approvisionnement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Chapitre 2 Placement du bouton PayPal, conception des

pages et flux de contrôle du programme . . . . . . . . . . 19

HTML pour créer l'image du bouton PayPal . . . . . . . . . . . . . . . . . . . . . . . . . 19

Exemples de placement de bouton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Rapport entre le bouton et l'appel API : SetExpressCheckout

et Redirection vers PayPal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Variante graphique : élimination de la vérification de la commande . . . . . . . . . . . . . 21

Recommandations de disposition de la page Modes de paiement . . . . . . . . . . . . . 22

Comportement de la page lorsque PayPal est sélectionné . . . . . . . . . . . . . . . 23

Flux de contrôle du programme de Paiement express. . . . . . . . . . . . . . . . . . . . 24

Chapitre 3 Fonctionnement de Paiement express PayPal . . . . . . .27

Relation avec la fonction Autorisation et collecte . . . . . . . . . . . . . . . . . . . . . . 29

Etape 1a : le client sélectionne PayPal sur votre site . . . . . . . . . . . . . . . . . . . . 30

Etape 1b : point d'intégration 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Notes d'utilisation à propos des éléments de SetExpressCheckout. . . . . . . . . . . 31

Transfert de votre client vers PayPal . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Etape 2a : le client approuve l'utilisation de PayPal . . . . . . . . . . . . . . . . . . . . . 35

Etape 2b : le client retourne sur votre site . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Guide d’intégration de Paiement express Février 2007 5

Sommaire

Etape 2c : point d'intégration 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

ReturnURL, CancelURL et jeton Express Checkout . . . . . . . . . . . . . . . . . . 38

Notes d'utilisation à propos des éléments de GetExpressCheckoutDetails . . . . . . . 38

Etape 3a : le client termine sa commande . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Etape 3b : point d'intégration 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Notes d'utilisation à propos des éléments DoExpressCheckoutPaymentRequest . . . 43

Etape 4 : le client est averti que la commande est terminée. . . . . . . . . . . . . . . . . 45

Chapitre 4 Présentation de la fonction Autorisation et collecte . . . .47

Procédure d'autorisation de base avec les API . . . . . . . . . . . . . . . . . . . . . . . 47

Période de validité du paiement et Période d'autorisation. . . . . . . . . . . . . . . . 47

Scénarios d'autorisation de commande . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Commande simple. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Commande complexe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Autorisations concurrentes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Tolérance relative des montants collectés avec les autorisations ouvertes . . . . . . . 51

Annulation d'autorisations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Collecte partielle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Collecte complète . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Optimisez l'expérience de votre acheteur . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Collecter des fonds faisant l'objet d'autorisations de base . . . . . . . . . . . . . . . 54

Approbation de l'acheteur pour les autorisations de base. . . . . . . . . . . . . . . . 55

Annuler les autorisations de base . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Chapitre 5 Questions/réponses au sujet du Paiement

express PayPal . . . . . . . . . . . . . . . . . . . . . . . 57

Pourquoi le bouton de Paiement express PayPal doit-il se trouver au début

de la procédure de paiement ?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Que se passe-t-il si mon client a besoin d'entrer une nouvelle adresse

de livraison ou de modifier ses informations de livraison ? . . . . . . . . . . . . . . . . . 57

Quelle est la différence maximale entre la valeur estimée et

la valeur finale de OrderTotal ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Question . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Réponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Que se passe-t-il si j'envoie mon client vers PayPal et qu'il change d'avis ? . . . . . . . . 58

Que se passe-t-il si mon client approuve l'utilisation de PayPal mais

qu'il n'achète pas mon produit ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

6 Février 2007 Guide d’intégration de Paiement express

Sommaire

Lorsque le point d'intégration 2 est atteint, suis-je sûr que

le paiement pourra avoir lieu ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Question . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Réponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Puis-je simplement ajouter les champs de nom d'utilisateur et de mot

de passe PayPal sur mon site ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Guide d’intégration de Paiement express Février 2007 7

Sommaire

8 Février 2007 Guide d’intégration de Paiement express

Liste des tableaux

Tableau P.1 Historique des révisions . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Tableau 2.1 Placement du bouton PayPal et règles associées . . . . . . . . . . . . . 19

Tableau 2.2 Flux de contrôle du programme de Paiement express

et points d'intégration . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Tableau 3.1 Etapes de l'intégration de la fonction Paiement express PayPal . . . . . 28

Tableau 3.2 Notes d'utilisation de SetExpressCheckoutRequest . . . . . . . . . . . . 32

Tableau 3.3 Notes d'utilisation de SetExpressCheckoutResponse . . . . . . . . . . . 34

Tableau 3.4 Notes d'utilisation de GetExpressCheckoutDetailsResponse . . . . . . . 38

Tableau 3.5 Utilisation des informations de livraison, de facturation et

du total de la commande . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Tableau 3.6 Notes d'utilisation : DoExpressCheckoutPaymentRequest . . . . . . . . 43

Tableau 3.7 45

Tableau 4.1 Produits PayPal acceptant Autorisation et collecte . . . . . . . . . . . . 48

Tableau 4.2 Scénario dans le cas d'une commande simple . . . . . . . . . . . . . . 49

Tableau 4.3 Scénario dans le cas d'u ne commande complexe . . . . . . . . . . . . . 50

Tableau 4.4 Scénario dans le cas d'autorisations concurrentes . . . . . . . . . . . . 51

Tableau 4.5 Scénario de tolérance relative des montants collectés

avec les autorisations ouvertes . . . . . . . . . . . . . . . . . . . . . . 51

Tableau 4.6 Scénario dans le cas d'annulation d'autorisations . . . . . . . . . . . . . 52

Tableau 4.7 Scénario dans le cas d'une collecte partielle . . . . . . . . . . . . . . . . 53

Tableau 4.8 Scénario dans le cas d'une collecte complète . . . . . . . . . . . . . . . 54

Guide d’intégration de Paiement express Février 2007 9

Liste des tableaux

10 Février 2007 Guide d’intégration de Paiement express

Liste des figures

Figure 2.1 Mode de paiement : PayPal comme unique option . . . . . . 22

Figure 2.2 Modes de paiement : c onc eption horizontale . . . . . . . . . 23

Figure 2.3 Modes de paiement : Liste déroulante de type SELECT . . . . 23

Figure 2.4 Flux de contrôle de Paiement express . . . . . . . . . . . . 25

Figure 3.1 Paiement des clients . . . . . . . . . . . . . . . . . . . . 28

Figure 3.2 Bouton de la fonction Paiement express

PayPal précédant la saisie de l'adresse de livraison . . . . . . 30

Figure 3.3 Express Checkout point d'intégration 1 . . . . . . . . . . . . 31

Figure 3.4 Page de connexion PayPal . . . . . . . . . . . . . . . . . . 35

Figure 3.5 Page de vérification PayPal . . . . . . . . . . . . . . . . . 36

Figure 3.6 Point d'intégration 2 de la fonction Paiement express PayPal . . 37

Figure 3.7 Exemple de page de vérification de la commande . . . . . . . 40

Figure 3.8 Point d'intégration 3 de la fonction Paiement express PayPal . . 42

Figure 3.9 Exemple de page de fin de commande . . . . . . . . . . . . 46

Guide d’intégration de Paiement express Février 2007 11

Liste des figures

12 Février 2007 Guide d’intégration de Paiement express

Préface

P

A propos de ce document

Ce document décrit Paiement express PayPal.

Public ciblé

Ce document est destiné aux marchands, aux revendeurs et aux vendeurs qui souhaitent
implémenter sur leur site une procédure de paiement efficace et dynamique pour leurs clients.

Conventions typographiques

Différents types de caractères sont utilisés dans ce document pour identifier les
caractéristiques du texte. Ces types de caractères et leurs caractéristiques sont décrits ci­dessous :

Type de
caractère Utilisation

italique sérif Titre de document

Terme traité ou défini
Exemple : Un fichier est un flux de données sous fo rm e de caractères lisibles ou

inscriptibles…
Valeurs booléennes (pas les mots-clés)

Exemple : La fonction renvoie la valeur true si une erreur se produit.

police à
espacement
constant

Chemins d'accès aux fichiers ou noms de fichier apparaissant dans le corps du
texte.

Noms associés au code apparaissant dans le corps du texte. Ces noms sont utilisés
pour les fonctions, les rappels, les arguments, les structures de données et les
champs.

Exemple : AbstractResponseType est le type de réponse SOAP sur lequel sont
basés tous les modes de réponse API de PayPal.

Composants de requêtes et de réponses de protocole Internet, tels que les variables
HTTPS et FORM.

Exemple : Le système PayPal utilise une requête method=POST pour renvoyer les
variables d'état NIP relatives aux abonnements, telles que txn_type.

Février 2007 13

Préface

Problèmes relatifs à la documentation

Type de
caractère Utilisation

gras sérif Noms d'interfaces utilisateur, tels que les noms de fenêtres ou les options de

menus
Exemple : Dans la page Préférences, cliquez sur Email pour confirmer votre

adresse email.

oblique san­sérif

Espaces réservés utilisés dans le contexte d'un format, ou norme de
programmation, ou descriptions formelles de la syntaxe du système PayPal. Les
espaces réservés indiquent les valeurs ou les noms que l'utilisateur doit fournir.

Exemple : Par exemple, amount est la variable d'un panier contenant un seul
objet, mais amount_
objets. amount_3 est le montant du troisième objet dans un panier contenant
plusieurs objets.

X est le nom de la variable d'un panier contenant plusieurs

Outre les types de caractères décrits ci-dessus, les mots et les phrases de ce document peuvent
également apparaître en gras ou soulignés, auquel cas ils donnent des informations
supplémentaires. Ces informations sont décrites ci-dessous :

Attribut du
texte Utilisation

xxxxxx Lien hypertexte vers une page du document actuel ou vers un autre document de

l'ensemble.

xxxxxx

Lien hypertexte vers une URL ou démarrant une action Web, telle que l'envoi d'un
email.

Problèmes relatifs à la documentation

Si vous relevez des erreurs ou si vous rencontrez des problèmes liés à cette documentation,
envoyez-nous un email en suivant les instructions ci-dessous. Décrivez l'erreur ou le problème
aussi précisément que possible et communiquez-nous le titre du document, sa date (indiquée
dans le pied de page de chaque page) et le(s) numéro(s) de page(s).

Pour contacter le Service clientèle concerna nt des problèmes liés à la documentation :

1. Accédez à

https://www.paypal.fr/.

2. Cliquez sur Aide en haut à droite de la page.

3. Cliquez sur Service clientèle en bas à gauche de la page.

4. Choisissez Aide par email.

5. Complétez le formulaire.

14 Février 2007

Historique des révisions

Historique des révisions du Guide d’intégration de Paiement express PayPal as a Payment
Option: Express Checkout.

T

ABLEAU P.1 Historique des révisions

Date Description

Février 2007 Corrections mineures.
Décembre 2006 Nouveaux placements de boutons requis. Nouvelle image Paiement PayPal.

Préface

Historique des révisions

Septembre 2006

Août 2006 Diverses corrections mineures
Juillet 2006 Di verses correctio ns mineures
Janvier 2006 Messages d'erreur d'API supplémentaires pour Paiement express PayPal :

Décembre 2005 Suppression de la description erronée indiquant que le champ cpp-header-

z Description de la variable useraction qui peut être utilisée pour rediriger le

navigateur de l'utilisateur vers PayPal après SetExpressCheckout pour
vérifier le texte du bouton final affiché sur le site de PayPal.

z Toutes les informations relatives aux API SOAP pour Paiement express et

Autorisation et collecte ont été transférées dans le document Guide de
référence de l'API SOAP.

10445, 10446.

image de SetExpressCheckoutRequest doit être encodé dans l'URL.

Premiers pas : Espace Intégration

L'Espace Intégration PayPal disponible sur

www.solutionspaypal.fr/RessourcesTechniquesPayPal/ic_home.html présente les étapes

détaillées de l'utilisation des kits de développement logiciel PayPal (SDK), Paiements sur site
marchand Pro, Paiement express PayPal, Paiements sur site marchand, Autorisation et
collecte, Notification instantanée de paiement et bien plus encore.

Rendez-vous dans L'Espace Intégration sur :

www.solutionspaypal.fr/RessourcesTechniquesPayPal/ic_home.html ou
www.paypal.fr/espaceintegration

.

Février 2007 15

Préface

Premiers pas : Espace Intégration

16 Février 2007

1

Présentation de Paiement express PayPal

Dès lors que vous simplifiez la procédure d'achat de vos clients, ils achètent davantage. La
fonction Paiement express PayPal leur permet de payer rapidement via PayPal et votre activité
en tire les avantages suivants :

z En facilitant la tâche des acheteurs, vous dopez vos ventes.

Comme vos clients n'ont qu'à se connecter pour utiliser des informations qu'ils ont déjà
entrées auprès de PayPal, ils réalisent les transactions en un temps record. La fidélité et les
ventes en sont les premiers bénéficiaires.

z En réalisant les ventes sur votre site, vous multipliez vos chances.

Les acheteurs remplissent leur commande sur votre site. C'est une excellente occasion de
vous faire connaître.

z Vos clients se sentent en sécurité et achètent plus.

Les acheteurs préfèrent payer avec PayPal car leurs données personnelles sont protégées.
S'ils savent que les informations qui les concernent sont sécurisées, ils achètent plus.

Qu'est-ce que la fonction Paiement express PayPal ?

z La fonction Paiement express PayPal permet à vos clients de réaliser leurs transactions très

rapidement. Ils utilisent, pour le paiement, des informations de livraison et de facturation
enregistrées dans leur compte PayPal, ce qui leur évite de les ressaisir sur votre site.

z La fonction Paiement express PayPal vous permet de proposer PayPal en première position

lors de votre procédure de paiement, ou sur votre page de facturation avec les autres
options de paiement.

z Il s'agit d'une fonctionnalité basée sur des API qui peut être utilisée avec l'API.

Fonctionnement

1. Une fois qu'un client a sélectionné ses produits, il clique sur Paiement avec PayPal sur

votre site.

2. Il est transféré vers le site PayPal où il sélectionne son mode de paiement, les adresses de

livraison et de facturation correctes, puis il revient sur votre site pour terminer son achat.

3. PayPal vous fournit automatiquement l'adresse de livraison, l'email et les autres

renseignements sur le client nécessaires pour remplir la commande.
Avec la fonction Paiement express PayPal, vos clients terminent leur commande sur votre

site, pas sur celui de PayPal, ce qui vous permet :

Février 2007 17

Disponibilité

– d'obtenir une notification en temps réel des paiements ;
– d'automatiser vos procédures ;
– d'être assuré que les acheteurs visualisent votre page de confirmation.

Disponibilité

Tous les titulaires de comptes Premier et Business peuvent intégrer la fonction Paiement
express PayPal sur leur site. Vous pouvez utiliser la fonction Express Checkout aussi bien pour
les paiements des titulaires de comptes PayPal que pour les paiements des clients qui ouvrent
un compte PayPal au cours de la procédure de paiement.

REMARQUE : un client qui n'a pas de compte PayPal et qui veut payer avec PayPal doit ouvrir

Compatibilité

La fonction Paiement express PayPal est compatible avec de nombreux produits PayPal,
notamment Notification instantanée de paiement, Système de règlement, Historique
téléchargeable, Autorisation et collecte, etc.

un compte. Une fois le compte ouvert, PayPal renvoie le client su r votre site.

Sources d'approvisionnement

Avec la fonction Express Checkout, vous pouvez accepter les principales ca rtes bancaires et
les paiements sur solde PayPal.

18 Février 2007