PayPal Paiement Express 2007 Manuel utilisateur

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 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'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 mises à disposition 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 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 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'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 mises à disposition de tous à l'avenir.
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
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
. . . . . 28
Tableau 4.1
Produits PayPal acceptant Autorisation et collecte
Tableau 4.2
Scénario dans le cas d'une commande simple
Tableau 4.3
Scénario dans le cas d'une commande complexe . . . . . . . . . . . . . 50
Tableau 4.4
Scénario dans le cas d'autorisations concurrentes
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
. . . . . . . . . . . . 48
. . . . . . . . . . . . . . 49
. . . . . . . . . . . . 51
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
Figure 2.2
Modes de paiement : conception horizontale . . . . . . . . . 23
Figure 2.3
Modes de paiement : Liste déroulante de type SELECT
Figure 2.4
Flux de contrôle de Paiement express
Figure 3.1
Paiement des clients
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
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
. . . . . . 22
. . . . 23
. . . . . . . . . . . . 25
. . . . . . . . . . . . . . . . . . . . 28
Février 2007
. . . . . . . . . . . . . . . . . 36
11
Liste des figures
12
Février 2007
Guide d’intégration de Paiement express
P
Préface
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 cidessous :
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 forme 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 sansé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_X est le nom de la variable d'un panier contenant plusieurs
objets. amount_3 est le montant du troisième objet dans un panier contenant
plusieurs objets.
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 concernant 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
Préface
Historique des révisions
Historique des révisions
Historique des révisions du Guide d’intégration de Paiement express PayPal as a Payment
Option: Express Checkout.
TABLEAU 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.
Septembre 2006
z
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.
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.
Août 2006
Diverses corrections mineures
Juillet 2006
Diverses corrections mineures
Janvier 2006
Messages d'erreur d'API supplémentaires pour Paiement express PayPal :
10445, 10446.
Décembre 2005
Suppression de la description erronée indiquant que le champ cpp-headerimage 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.
R E M A R Q U E : un client qui n'a pas de compte PayPal et qui veut payer avec PayPal doit ouvrir
un compte. Une fois le compte ouvert, PayPal renvoie le client sur votre site.
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.
Sources d'approvisionnement
Avec la fonction Express Checkout, vous pouvez accepter les principales cartes bancaires et
les paiements sur solde PayPal.
18
Février 2007
2
Placement du bouton PayPal,
conception des pages et flux de
contrôle du programme
IMPO RTANT : Lorsque
vous offrez le Paiement express PayPal à vos clients, vous devez
l'afficher sous deux formes, pour faciliter la procédure d'achat :
1. PayPal comme option de paiement, à la page du panier de votre site
2. PayPal comme mode de paiement
TABLEAU 2.1 Placement du bouton PayPal et règles associées
Placement
1.
2.
Image du bouton PayPal
Conditions requises
Placez le bouton Paiement PayPal sur la page du
panier de votre site, et alignez-le sur tous les autres
boutons de paiement.
PayPal
comme
option de
paiement
Placez le logo d'acceptation de PayPal :
1. Sur votre page des modes de paiement
2. Sur votre page d'accueil, à côté des logos de cartes
bancaires, le cas échéant
PayPal
comme
mode de
paiement
HTML pour créer l'image du bouton PayPal
Vous pouvez obtenir le lien HTML vers le bouton Express Checkout la marque d'acceptation
de PayPal à la page suivante :
https://www.paypal.com/fr_FR/i/btn/btn_xpressCheckout.gif
IMPO RTANT : Au lieu
d'enregistrer l'image du bouton sur votre propre serveur, utilisez les
chemins d'images fournis par PayPal pour pouvoir assurer à vos clients que
le mode de paiement est parfaitement sécurisé et que vous affichez les logos
PayPal les plus à jour.
Février 2007
19
Placement du bouton PayPal, conception des pages et flux de contrôle du programme
Exemples de placement de bouton
Exemples de placement de bouton
Voici quelques exemples de placement correct :
1. PayPal comme option de paiement et comme mode de paiement
2. PayPal comme mode de paiement
Pour PayPal comme mode de paiement, vous avez le choix entre différentes variantes
graphiques. Reportez-vous aux «Recommandations de disposition de la page Modes de
paiement» .
20
Février 2007
Placement du bouton PayPal, conception des pages et flux de contrôle du programme
Rapport entre le bouton et l'appel API : SetExpressCheckout et Redirection vers PayPal
Rapport entre le bouton et l'appel API :
SetExpressCheckout et Redirection vers PayPal
Les deux images doivent appeler l'API SetExpressCheckout. Reportez-vous au Guide de
référence de l’ API SOAP et au Guide de développement de l’API NVP PayPal.
Après la réponse de SetExpressCheckout, redirigez le navigateur du client vers PayPal. La
réponse SetExpressCheckout inclut un jeton de session Paiement express PayPal. Ajoutez la
valeur de l'élément Token de la réponse SetExpressCheckout sous forme de paire
nom/valeur à l'URL suivante, et redirigez le navigateur de l'utilisateur vers cette adresse :
https://www.paypal.com/cgibin/webscr?cmd=_express-checkout&token=value_from_SetExpressCheckoutResponse
R E M A R Q U E : Paiement
express propose une variation sur cette URL de redirection ("action
utilisateur"), qui permet de contourner l'appel de la deuxième API
(GetExpressCheckoutDetails) et de modifier le texte du bouton final qui s'affiche
dans PayPal. Reportez-vous à la section “Variante graphique : élimination de la
vérification de la commande“ page 21.
Recommandations pour la redirection d'un navigateur
Pour rediriger le navigateur d'un client vers l'URL de PayPal, PayPal vous recommande
d'utiliser la réponse HTTPS 302 "Objet déplacé" avec votre URL PayPal comme valeur de
l'en-tête Location dans la réponse HTTPS. Vérifiez que votre serveur utilise le protocole
SSL : vous évitez ainsi que le navigateur ne reçoive des avertissements à propos d'un mélange
d'images sécurisées et non sécurisées.
Variante graphique : élimination de la vérification de la commande
Si votre programme de paiement normal inclut une page de modes de paiement vers la fin,
vous n'avez pas besoin d'afficher cette page de modes de paiement une fois le client revenu de
PayPal sur votre site, puisqu'elle est alors superflue. Le client a déjà sélectionné PayPal pour
vous payer.
Vous pouvez afficher la procédure de paiement complet sur le site de PayPal, et non sur votre
propres site ; vous contournez ainsi entièrement votre propre page de vérification de la
commande. (Lorsque le client revient de PayPal à votre site, vous devez appeler l'API
DoExpressCheckoutPayment pour vraiment terminer la transaction.) Si, par exemple, vous ne
voulez pas afficher de page de vérification de la commande sur votre site lorsque le client
revient du site PayPal sur votre site, le texte du bouton sur PayPal doit indiquer : Payer.
Vous contrôlez le texte du bouton qui s'affiche sur le site PayPal, par la variable useraction
de l'URL PayPal vers laquelle vous redirigez le client après SetExpressCheckout :
z
Si la variable useraction n'est pas configurée ou si useraction=continue : PayPal
affiche un bouton Continuer sur son site.
z
useraction=commit : PayPal affiche un bouton Payer sur son site.
Février 2007
21
Placement du bouton PayPal, conception des pages et flux de contrôle du programme
Recommandations de disposition de la page Modes de paiement
Voici les étapes de l'utilisation de la variable useraction :
1. Obtenez le jeton de la réponse de SetExpressCheckout.
La réponse de SetExpressCheckout est le jeton de l'acheteur. Si, par exemple, la valeur
de ReturnURL sur SetExpressCheckout est
https://www.mybiz.com/snagECvalues, l'URL vers laquelle PayPal redirige le
navigateur ressemble à ceci :
https://www.mybiz.com/snagECvalues?token=EC-0W8920957N684880R
2. Ajoutez le jeton et la variable useraction désirée sous forme de paire nom/valeur à
l'URL suivante, et redirigez le navigateur de l'utilisateur vers cette adresse :
https://www.paypal.com/cgi-bin/webscr?cmd=_express-checkout&token=valueFrom
SetExpressCheckoutResponse&useraction=continue_or_commit
Recommandations de disposition de la page Modes de paiement
Lorsque vous affichez la marque d'acceptation PayPal avec d'autres modes de paiement, vous
avez le choix entre plusieurs images :
z
Bouton d'option
z
Champs horizontaux
z
Liste déroulante de type SELECT
IMPO RTANT : Ne
présélectionnez aucun mode de paiement. Laissez le client faire son
choix, sans aucune option par défaut.
Bouton d'option :
FIGURE 2.1 Mode de paiement : PayPal comme unique option
22
Février 2007
Placement du bouton PayPal, conception des pages et flux de contrôle du programme
Recommandations de disposition de la page Modes de paiement
Champs horizontaux :
FIGURE 2.2 Modes de paiement : conception horizontale
Liste déroulante de type SELECT :
FIGURE 2.3 Modes de paiement : Liste déroulante de type SELECT
Comportement de la page lorsque PayPal est sélectionné
Lorsque votre client sélectionne PayPal en tant que mode de paiement, procédez comme suit
pour lui offrir la meilleure expérience d'achat possible :
z
Utilisez JavaScript pour masquer ou désactiver les champs de carte bancaire et les champs
d'adresses de facturation, car ces informations ne sont pas pertinentes lorsqu'un client paie
par PayPal.
z
Si la page comporte d'autres champs, par exemple, prévus pour un code de bon d'achat ou
un chèque cadeau, affichez-les tout de même pour que votre client puisse les renseigner
avant qu'il ne soit redirigé vers PayPal.
z
Modifiez la fonction du bouton "Continuer" pour appeler l'API SetExpressCheckout et
rediriger le client vers PayPal.
Février 2007
23
Placement du bouton PayPal, conception des pages et flux de contrôle du programme
Flux de contrôle du programme de Paiement express
Flux de contrôle du programme de Paiement express
La conception de votre page déclenche les appels d'API Paiement express PayPal. Voici
comment fonctionne l'API Paiement express. Pour en savoir plus sur les champs et valeurs des
appels API Paiement express, reportez-vous à la section "API Paiement express" du Guide de
référence de l’API SOAP et au Guide de développement de l''API NVP PayPal.
1. Indication préparatoire signalant à PayPal que vous allez utiliser le Paiement express pour le
paiement de la commande du client : SetExpressCheckout.
2. Redirection du client vers le site PayPal.
3. Obtention des informations concernant ce client auprès de PayPal (adresse de livraison, par
exemple) et, éventuellement, autorisation accordée au client de modifier ces informations pendant la
vérification de la commande : GetExpressCheckoutDetails.
4. Transaction de paiement avec DoExpressCheckoutPayment à la fin de la procédure de paiement,
sous une ou deux formes :
24
z
Montant complet de la vente finale
z
Autorisation pour un montant total à collecter ultérieurement avec Autorisation et collecte
Février 2007
Placement du bouton PayPal, conception des pages et flux de contrôle du programme
Flux de contrôle du programme de Paiement express
FIGURE 2.4 Flux de contrôle de Paiement express
Février 2007
25
Flux de contrôle du programme de Paiement express
TABLEAU 2.2 Flux de contrôle du programme de Paiement express et points
d'intégration
1
Le client...
Le marchand...
PayPal...
Clique sur le
bouton
Paiement
avec PayPal.
Appelle l'API SetExpressCheckout avec les champs
requis – OrderTotal estimé, ReturnURL et
CancelURL – et les champs facultatifs, tels que
MaxAmount.
2. Renvoie une réponse SetExpressCheckout
avec Token et ajoute les valeurs de Token et
PayerID à votre URL de renvoi.
3. Ajoute la valeur de l'élément Token de la réponse
SetExpressCheckout sous forme de paire nom/valeur
à l'URL suivante, et redirige le navigateur de l'utilisateur
vers cette adresse :
https://www.paypal.fr/cgi-bin/webscr?cmd=_express-checkout&token=value
Se connecte à
PayPal,
approuve
l'utilisation de
PayPal et
clique sur
Continuer ou
sur Payer.
4. Avec GET, redirige le navigateur de l'utilisateur
vers le ReturnURL du marchand, et la valeur du
jeton est jointe.
5. Appelle éventuellement l'API
GetExpressCheckoutDetails avec Token pour
récupérer les informations du client.
Renvoie une réponse
GetExpressCheckoutDetails avec PayerID,
l'adresse email, l'adresse de livraison, l'état de cette
adresse (confirmée ou non confirmée) et d'autres
détails.
Présente une page dans le navigateur du client pour l'étape
suivante de la procédure de paiement, par exemple votre
page de vérification de la commande.
Clique sur le
bouton de
confirmation
de la
commande.
6. Appelle DoExpressCheckoutPayment API avec les
éléments requis Token, OrderTotal, PaymentAction
et PayerID renvoyés par la réponse
GetExpressCheckoutDetails.
7. Affiche la page de remerciement.
26
Février 2007
Renvoie les informations sur le paiement avec la
valeur important TransactionID et d'autres
détails concernant le paiement.
3
Fonctionnement de Paiement
express PayPal
La fonction Paiement express PayPal est une combinaison de la procédure de paiement de
votre site, des pages de connexion et récapitulatives du site PayPal https://www.paypal.fr et
des requêtes/réponses SOAP des API PayPal.
Pour expliquer le fonctionnement de Express Checkout, ce chapitre présente une procédure de
paiement et détaille l'intégration de la fonction Express Checkout. Cette procédure, qui peut
être différente de la vôtre, est illustrée à la Figure 3.1, «Paiement des clients». Chaque étape
numérotée du schéma correspond à ce que ce guide appelle les points d'intégration 1, 2 et 3 de
Express Checkout.
L'ordre des points d'intégration est le suivant. Votre client démarre et termine toujours sa
commande sur votre site.
1. Lorsqu'un client clique sur Paiement avec PayPal, il est transféré vers PayPal pour s'y
connecter.
2. Il sélectionne alors une adresse de livraison et un mode de paiement, puis il approuve
l'utilisation de PayPal.
3. PayPal renvoie ensuite le client vers votre site pour qu'il vérifie sa commande et la finalise.
Février 2007
27
Fonctionnement de Paiement express PayPal
FIGURE 3.1 Paiement des clients
A chaque point d'intégration, vous devez définir les valeurs de certains éléments obligatoires
de l'API et vous pouvez modifier le comportement et l'utilité de la fonction Express Checkout
en définissant des éléments facultatifs.
Après une brève description du schéma technique d'intégration de la fonction Express
Checkout, la suite de ce chapitre présente la procédure à chaque point d'intégration.
TABLEAU 3.1 Etapes de l'intégration de la fonction Paiement express PayPal
28
Etapes
Description
1a
Une fois que votre client a sélectionné ses produits, il clique sur le bouton Paiement
avec PayPal sur votre site.
Ceci lui évite d'avoir à saisir les informations de livraison et de facturation sur votre site.
Reportez-vous à la section "Etape 1a : le client sélectionne PayPal sur votre site"
page 30.
1b
Point d'intégration 1
Grâce à un appel API, vous transmettez à PayPal les informations concernant la
transaction.
Vous transférez ensuite le client vers PayPal via une redirection HTTP.
Votre client est transféré vers PayPal.
Reportez-vous à la section "Etape 1b : point d'intégration 1" page 31.
2a
Votre client sélectionne une adresse de livraison et un mode de paiement enregistrés
auprès de PayPal.
Reportez-vous à l' "Etape 2a : le client approuve l'utilisation de PayPal" page 35.
Février 2007
Fonctionnement de Paiement express PayPal
Relation avec la fonction Autorisation et collecte
TABLEAU 3.1 Etapes de l'intégration de la fonction Paiement express PayPal
Etapes
Description
2b
Votre client clique sur Continuer pour approuver l'utilisation de PayPal, puis il est
renvoyé sur votre site.
Reportez-vous à la section "Etape 2b : le client retourne sur votre site" page 37.
2c
Point d'intégration 2
Votre client est à nouveau transféré sur votre site.
PayPal transfère le client via une redirection HTTP. Vous effectuez alors un appel API
pour récupérer les détails de la transaction, tels que l'adresse de livraison, l'adresse email
et les autres informations nécessaires à l'exécution de la commande.
Reportez-vous à la section "Etape 2c : point d'intégration 2" page 37.
3a
Votre client termine la procédure de paiement sur votre site, vérifie la commande et la
termine.
Reportez-vous à la section "Etape 3a : le client termine sa commande" page 39.
3b
Point d'intégration 3
Une fois la commande confirmée par votre client, vous effectuez un appel API à PayPal
pour demander le paiement. (Cette étape est invisible pour le client.)
Le paiement de la transaction débute et PayPal envoie le reçu correspondant à votre
client par email.
Reportez-vous à la section "Etape 3b : point d'intégration 3" page 41.
4
Vous transférez votre client vers la page de confirmation de la commande de votre site.
Reportez-vous à la section "Etape 4 : le client est averti que la commande est
terminée" page 45.
La fonction Express Checkout 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.
Relation avec la fonction Autorisation et collecte
PayPal suppose que vous allez réaliser une vente finale et un paiement de transaction via
PayPal à la fin de la procédure de paiement.
Si au point de vente vous ne connaissez pas le coût total de la commande (par exemple, si vous
ne connaissez pas exactement les frais d'expédition et de traitement et le montant de la TVA ou
si vous souhaitez vendre davantage) vous pouvez autoriser une transaction que vous
collecterez ultérieurement avec la fonction Autorisation et collecte.
Pour en savoir plus sur la fonction Autorisation et collecte, consultez le Chapitre 4,
“Présentation de la fonction Autorisation et collecte”.
Février 2007
29
Fonctionnement de Paiement express PayPal
Etape 1a : le client sélectionne PayPal sur votre site
Etape 1a : le client sélectionne PayPal sur votre site
PayPal recommande que le bouton de la fonction Paiement express PayPal apparaisse sur
votre site avant que les clients aient à entrer leurs informations de livraison et de facturation,
tel qu'illustré à la Figure 3.2, «Bouton de la fonction Paiement express PayPal précédant la
saisie de l'adresse de livraison».
FIGURE 3.2 Bouton de la fonction Paiement express PayPal précédant la saisie de
l'adresse de livraison
R E M A R Q U E : votre
client vérifie toujours les détails de la transaction et effectue le paiement
final sur votre site. PayPal gère la vérification du paiement et vous transmet les
informations de livraison du client. PayPal ne partage jamais les informations
financières de votre client avec qui que ce soit.
30
Février 2007
Fonctionnement de Paiement express PayPal
Etape 1b : point d'intégration 1
Etape 1b : point d'intégration 1
Comme le montre la Figure 3.3, «Express Checkout point d'intégration 1», le point
d'intégration 1 correspond au moment où vous transférez le navigateur d'un client vers PayPal
pour qu'il sélectionne ou ajoute une adresse de livraison et une source d'approvisionnement.
FIGURE 3.3 Express Checkout point d'intégration 1
Le point d'intégration 1 comporte les actions et les événements suivants :
z
Le client clique sur le bouton Paiement avec PayPal.
z
Vous envoyez SetExpressCheckoutRequest à PayPal.
z
PayPal renvoie SetExpressCheckoutResponse.
z
Vous redirigez le navigateur du client vers PayPal.
Notes d'utilisation à propos des éléments de SetExpressCheckout
Voici des informations d'utilisation importantes sur certains des éléments obligatoires ou
facultatifs de la première requête SOAP de Express Checkout. Pour obtenir tous les détails sur
Février 2007
31
Fonctionnement de Paiement express PayPal
Etape 1b : point d'intégration 1
l'ensemble des éléments, reportez-vous à la section “SetExpressCheckout” du Guide de
référence de l'API SOAP.
TABLEAU 3.2 Notes d'utilisation de SetExpressCheckoutRequest
Elément
Obligatoire
ou facultatif ?
OrderTotal
Obligatoire
Coût total estimé de la commande pour le client.
Si vous connaissez les frais d'expédition et de livraison et la TVA,
incluez-les dans OrderTotal ; dans le cas contraire,
OrderTotal doit correspondre au sous-total actuel de la
commande.
MaxAmount
Facultatif
Montant total maximum prévu de la commande complète, y
compris frais d'expédition et de livraison et de TVA.
PayPal utilise un OrderTotal ajusté pour déterminer quelles
sources d'approvisionnement le client peut être autorisé à utiliser.
Les calculs de la logique métier de PayPal prennent en compte le
fait que la livraison et la TVA seront probablement ajoutées à
OrderTotal avant que le client ne termine l'achat. MaxAmount
est une information supplémentaire permettant à la logique métier
de PayPal de calculer correctement les fonds disponibles du client
pour chaque cas de figure.
Si OrderTotal est le montant final, attribuez à MaxAmount une
valeur égale à celle de OrderTotal.
Notes
R E M A R Q U E : si la valeur finale de OrderTotal envoyée avec
DoExpressCheckoutPaymentRequest
(l'API Paiement express PayPal finale) dépasse la
valeur de MaxAmount, le paiement est traité.
ReturnURL
32
Obligatoire
Février 2007
URL vers laquelle le navigateur du client est renvoyé après
l'approbation de l'utilisation de PayPal.
PayPal recommande que la valeur de l'élément obligatoire
ReturnURL corresponde à la page de vérification finale sur
laquelle le client confirme la commande et le paiement.
La valeur de votre ReturnURL doit toujours supposer que GET
correspond à FORM METHOD, comme si la valeur devait être incluse
dans un FORM. En fait, vous devez prévoir que votre ReturnURL
sera lu à partir de la variable d'environnement QUERY_STRING et
non à partir d'une entrée standard.
Pour votre contrôle par programmation de la redirection du
navigateur du client vers votre site, la valeur de ReturnURL peut
inclure n'importe quelle paire nom/valeur requise par vos
programmes.
Fonctionnement de Paiement express PayPal
Etape 1b : point d'intégration 1
TABLEAU 3.2 Notes d'utilisation de SetExpressCheckoutRequest
Elément
Obligatoire
ou facultatif ?
CancelURL
Obligatoire
URL vers laquelle le client est renvoyé s'il décide de ne pas utiliser
PayPal ou si PayPal ne peut pas l'autoriser.
PayPal recommande que la valeur de l'élément obligatoire
CancelURL corresponde à la page initiale sur laquelle le client a
choisi d'utiliser PayPal. Par exemple, si le client a été transféré vers
PayPal à partir de votre page contenant les informations de
livraison, la valeur de CancelURL doit correspondre à l'URL de
cette page. Si le client clique sur Annuler sur le site PayPal, son
navigateur est redirigé vers votre page contenant les informations
de livraison, ce qui lui permet de poursuivre en utilisant votre
procédure de paiement standard.
PaymentAction
Facultatif
Mode d'obtention du paiement :
z Sale indique qu'il s'agit d'une vente finale pour laquelle vous
demandez un paiement.
z Authorization ou Order indique qu'il s'agit d'un paiement
qui sera traité par Autorisation et collecte PayPal. Une
PaymentAction avec la valeur Authorization indique à
PayPal que le total de la commande à la fin du paiement du
client ne sera pas une vente finale. Si vous choisissez cette
action, vous devrez réaliser une autre étape pour collecter le
paiement.
Notes
I M P O R T A N T : Vous ne pouvez pas donner à PaymentAction la
valeur Sale ou à Order la valeur
SetExpressCheckoutRequest et donner
ensuite à PaymentAction la valeur
Authorization pour l'API PayPal du Paiement
express
DoExpressCheckoutPaymentRequest.
Pour en savoir plus sur la fonction Autorisation et collecte PayPal,
consultez le Chapitre 4, “Présentation de la fonction
Autorisation et collecte”.
Février 2007
33
Fonctionnement de Paiement express PayPal
Etape 1b : point d'intégration 1
TABLEAU 3.2 Notes d'utilisation de SetExpressCheckoutRequest
Elément
cpp-headerimage
Obligatoire
ou facultatif ?
Facultatif
Notes
URL de l'image que vous souhaitez voir apparaître dans la partie
supérieure gauche de la page de paiement. La taille maximale de
l'image est de 750 pixels en largeur et de 90 pixels en hauteur.
R E M A R Q U E : PayPal vous recommande de fournir une image
provenant d'un serveur sécurisé (https). Dans le cas
contraire, lorsque le navigateur du client est
redirigé vers le site PayPal, un message sur les
risques de sécurité potentiels s'affiche (mélange
d'éléments sécurisés et non sécurisés). Ce message
peut empêcher certains clients de poursuivre leurs
achats.
Dans la Figure 3.4, «Page de connexion PayPal» page 35,
l'image DesignerFotos située sous le logo PayPal montre comment
apparaît une image du type cpp-header-image.
Pour en savoir plus sur les pages de paiement personnalisées,
consultez le Guide d'intégration de Paiements sur site marchand.
Custom
Facultatif
L'élément facultatif Custom est une variable écho. Sa valeur est
renvoyée intégralement sur l'API finale de Paiement express
PayPal, DoExpressCheckoutPaymentResponse. Vous
pouvez utiliser cette valeur comme vous le souhaitez, par exemple
comme numéro de suivi comptable ou comme données
supplémentaires nécessaires à vos programmes (par exemple un ID
de session ou une autre variable).
TABLEAU 3.3 Notes d'utilisation de SetExpressCheckoutResponse
Elément
Notes
Token
Jeton horodaté par lequel vous indiquez à PayPal que vous traitez ce paiement avec la
fonction Paiement express PayPal.
R E M A R Q U E : Le jeton expire au bout de trois heures.
Transfert de votre client vers PayPal
Lorsque vous avez reçu une réponse de PayPal, vous devez ajouter la valeur de l'élément
Token de SetExpressCheckoutResponse sous forme de paire nom/valeur à l'URL
suivante et y rediriger le navigateur de votre client :
https://www.paypal.com/cgibin/webscr?cmd=_express-checkout&token=value_from_SetExpressCheckoutResponse
Express Checkout propose une variation sur cette URL de redirection, qui permet de
contourner l'appel de la deuxième API (GetExpressCheckoutDetails) et de modifier le texte du
34
Février 2007
Fonctionnement de Paiement express PayPal
Etape 2a : le client approuve l'utilisation de PayPal
bouton final qui s'affiche dans PayPal. Reportez-vous à la section "Variante graphique :
élimination de la vérification de la commande" page 21.
Recommandations pour la redirection d'un navigateur
Pour rediriger le navigateur d'un client vers l'URL de PayPal, PayPal vous recommande
d'utiliser la réponse HTTPS 302 « Objet déplacé » avec votre URL comme valeur de l'en-tête
Location dans la réponse HTTPS. Vérifiez que votre serveur utilise le protocole SSL : vous
évitez ainsi que le navigateur ne reçoive des avertissements à propos d'un mélange d'images
sécurisées et non sécurisées.
Etape 2a : le client approuve l'utilisation de PayPal
Lorsque le navigateur du client a été redirigé vers PayPal avec le jeton de réponse, l'étape
suivante consiste, pour le client, à approuver PayPal comme mode de paiement pour son achat.
Le client est redirigé vers la page de connexion PayPal pour entrer son adresse email et son
mot de passe, comme illustré à la Figure 3.4, «Page de connexion PayPal». Si le client n'a pas
de compte PayPal, il peut cliquer sur le lien Vous n'avez pas de compte PayPal ? Cliquez ici.
et entrer ses informations de carte bancaire pour ouvrir un compte PayPal.
FIGURE 3.4 Page de connexion PayPal
Si le client s'est déjà connecté à PayPal, son adresse email est pré-remplie, ce qui simplifie la
connexion.
Une fois que le client s'est connecté à PayPal, il doit vérifier les informations le concernant sur
la page « Vérifiez les informations enregistrées par PayPal », comme illustré à la Figure 3.5,
«Page de vérification PayPal».
Février 2007
35
Fonctionnement de Paiement express PayPal
Etape 2a : le client approuve l'utilisation de PayPal
FIGURE 3.5 Page de vérification PayPal
Ensuite, le client :
1. Peut vérifier sa source d'approvisionnement et son adresse de livraison par défaut,
sélectionner d'autres sources ou une autre adresse déjà enregistrées par PayPal ou en saisir
de nouvelles.
R E M A R Q U E : PayPal
renvoie votre client vers la ReturnURL indiquée dans
SetExpressCheckoutRequest. Si le client clique sur le bouton Annuler,
PayPal le renvoie vers la CancelURL indiquée dans
SetExpressCheckoutRequest.
2. Clique sur Continuer pour approuver l'utilisation de PayPal.
3. Retourne sur votre site pour terminer l'achat.
36
Février 2007
Fonctionnement de Paiement express PayPal
Etape 2b : le client retourne sur votre site
Etape 2b : le client retourne sur votre site
Une fois que le client a sélectionné les informations de livraison et de facturation sur le site
PayPal, il clique sur Payer, ce qui signifie qu'il approuve l'utilisation de PayPal. PayPal
redirige alors le navigateur du client vers votre site, tel que décrit à l'Etape 2c : point
d'intégration 2.
Etape 2c : point d'intégration 2
La Figure 3.6, «Point d'intégration 2 de la fonction Paiement express PayPal» illustre le point
d'intégration 2 de la fonction Paiement express PayPal.
FIGURE 3.6 Point d'intégration 2 de la fonction Paiement express PayPal
Le point d'intégration 2 comporte les actions et les événements suivants :
z
Le client clique sur Continuer sur l'écran de vérification PayPal.
z
PayPal transfère votre client vers l'emplacement que vous avez indiqué dans ReturnURL.
z
Vous envoyez GetExpressCheckoutDetailsRequest à PayPal.
z
PayPal renvoie GetExpressCheckoutDetailsResponse.
z
Vous affichez l'écran suivant de votre procédure de paiement pour votre client.
Une fois que votre client a vérifié et approuvé ses informations financières et de livraison et
apporté les modifications éventuelles, PayPal redirige son navigateur vers la valeur de
ReturnURL contenue dans SetExpressCheckoutRequest.
Février 2007
37
Fonctionnement de Paiement express PayPal
Etape 2c : point d'intégration 2
ReturnURL, CancelURL et jeton Express Checkout
PayPal ajoute les paires nom/valeur token=tokenValue et PayerID=payeridValue à la valeur
de vos ReturnURL et CancelURL. Par exemple, si vous avez défini ReturnURL comme suit :
https://www.newco.com/ourcheckout
PayPal modifie la valeur comme suit :
https://www.newco.com/ourcheckout?token=tokenValue&PayerID=payeridValue
De même, si la valeur de votre ReturnURL a les paires nom/valeurs suivantes :
https://www.newco.com/ourcheckout?cartid=1234
PayPal fait précéder le jeton ajouté du délimiteur de paire nom/valeur comme suit :
https://www.newco.com/ourcheckout?cartid=1234&token=tokenValue&PayerID=payerid
Value
Une fois que le client arrive à cette ReturnURL, vous pouvez envoyer
GetExpressCheckoutDetailsRequest avec la valeur de Token fournie dans
SetExpressCheckoutResponse. PayPal vous envoie alors une réponse avec les
informations de transaction de votre client.
Pour connaître la liste de tous les éléments de GetExpressCheckoutDetailsResponse, consultez
le Guide de référence de l'API SOAP.
Notes d'utilisation à propos des éléments de GetExpressCheckoutDetails
Des informations au sujet de l'utilisation de certains éléments importants envoyés dans cette
réponse sont présentées brièvement ci-dessous.
TABLEAU 3.4 Notes d'utilisation de GetExpressCheckoutDetailsResponse
Elément
Notes
Payer
Adresse email du payeur
PayerID
Numéro de compte unique du client PayPal.
Vous devez fournir cette valeur avec
DoExpressCheckoutPaymentRequest.
PayerStatus
Etat du compte PayPal du payeur.
L'état Verified signifie que le client a confirmé qu'il dispose d'un compte ou
qu'il a vérifié l'état de son compte par d'autres moyens.
FirstName
LastName
38
Nom du payeur
Février 2007
Fonctionnement de Paiement express PayPal
Etape 3a : le client termine sa commande
TABLEAU 3.4 Notes d'utilisation de GetExpressCheckoutDetailsResponse
Elément
Notes
Address
Adresse de livraison du payeur sélectionnée sur PayPal.
R E M A R Q U E : avec SetExpressCheckoutRequest, si vous avez
envoyé à PayPal une Address et si vous avez défini
AddressOverride, dans
GetExpressCheckoutDetailsResponse PayPal
renvoie l'adresse de livraison que vous avez initialement
envoyée dans SetExpressCheckoutRequest.
AddressStatus
Etat de l'adresse de livraison du client.
ContactPhone
Numéro de téléphone à contacter du payeur.
ContactPhone est renvoyé uniquement si vous l'avez défini les Préférences de
réception de paiements sur le site sous l'onglet Préférences sur
https://www.paypal.com/fr.
Pour protéger la vie privée de votre client, PayPal ne partage pas l'adresse de facturation ni les
informations financières telles que les numéros de carte bancaire.
R E M A R Q U E : selon les conditions du Règlement sur le respect de la vie privée de PayPal, vous
avez le droit d'utiliser les informations personnelles d'un client uniquement à
des fins de communication concernant la transaction, sauf si le client vous
autorise expressément à les utiliser à d'autres fins. Pour en savoir plus sur le
Règlement sur le respect de la vie privée de PayPal, reportez-vous à la page
https://www.paypal.com/fr/privacy.
Etape 3a : le client termine sa commande
Une fois que vous avez reçu un GetExpressCheckoutDetailsResponse, affichez la page
suivante de votre procédure de paiement. Il peut s'agir d'une page de vérification de la
commande ou d'une page sur laquelle le client peut sélectionner un mode de livraison, entrer
des instructions de livraison ou indiquer d'autres renseignements nécessaires à la finalisation
de l'achat.
Février 2007
39
Fonctionnement de Paiement express PayPal
Etape 3a : le client termine sa commande
FIGURE 3.7 Exemple de page de vérification de la commande
40
Février 2007
Fonctionnement de Paiement express PayPal
Etape 3b : point d'intégration 3
PayPal vous recommande de modifier votre page de vérification de la commande comme suit.
La Figure 3.7, «Exemple de page de vérification de la commande» page 40 est un exemple de
page modifiée qui prend ces indications en compte.
TABLEAU 3.5 Utilisation des informations de livraison, de facturation et du total de la
commande
Section des
informations sur la
livraison
Affichez l'adresse de livraison fournie par PayPal.
Le bouton de modification doit renvoyer votre client vers le site PayPal pour qu'il y
effectue les changements voulus. Cela lui permet de sélectionner rapidement une
autre adresse qu'il a déjà enregistrée auprès de PayPal ou d'en saisir une nouvelle.
Cela garantit également que PayPal vous fournit la valeur AddressStatus actualisée de
la nouvelle adresse de livraison.
Pour en savoir plus au sujet du AddressStatus, consultez le Guide de référence de
l'API SOAP.
Section des
informations sur la
facturation
Pour les informations de facturation, affichez l'adresse email PayPal du client fournie
dans Express Checkout.
Total de la
commande
Avec la fonction Paiement express PayPal, vous devez afficher pour le client une
valeur OrderTotal absolument identique à celle que vous envoyez à PayPal dans
DoExpressCheckoutPaymentRequest.
Lorsque le client clique sur le bouton « Passer commande », envoyez
DoExpressCheckoutPaymentRequest pour lancer le paiement. Lorsque PayPal vous a
envoyé une réponse, dirigez le client vers votre page de fin de commande pour l'informer que
vous avez reçu sa commande.
Etape 3b : point d'intégration 3
La Figure 3.8, «Point d'intégration 3 de la fonction Paiement express PayPal» illustre le point
d'intégration 3 de la fonction Paiement express PayPal.
Février 2007
41
Fonctionnement de Paiement express PayPal
Etape 3b : point d'intégration 3
FIGURE 3.8 Point d'intégration 3 de la fonction Paiement express PayPal
Le point d'intégration 3 implique les actions et les événements suivants :
42
z
Le client clique sur le bouton « Passer commande » de votre site.
z
Vous envoyez DoExpressCheckoutPaymentRequest à PayPal.
z
PayPal renvoie DoExpressCheckoutPaymentResponse.
z
Vous redirigez le client vers votre page de confirmation de la commande.
Février 2007
Fonctionnement de Paiement express PayPal
Etape 3b : point d'intégration 3
Notes d'utilisation à propos des éléments
DoExpressCheckoutPaymentRequest
Voici des informations d'utilisation importantes sur certains des éléments obligatoires ou
facultatifs de la requête SOAP finale de Express Checkout.
TABLEAU 3.6 Notes d'utilisation : DoExpressCheckoutPaymentRequest
Elément
Obligatoire
ou facultatif ?
OrderTotal
Obligatoire
Notes
Total de la commande, incluant les frais d'expédition et de livraison,
de dossier et le montant de la TVA. Il doit s'agir du montant final de
l'achat et il peut être différent de la valeur initiale estimée de
OrderTotal, que vous avez envoyée dans
SetExpressCheckoutRequest.
R E M A R Q U E : PayPal n'impose pas de différence maximale entre
la valeur initiale estimée de OrderTotal et celle que
vous envoyez dans
SetExpressCheckoutRequest . Toutefois,
si la différence est importante, il se peut que votre
client ne soit plus approuvé pour l'utilisation de la
source d'approvisionnement qu'il a acceptée au
départ.
PaymentAction
Obligatoire
Mode d'obtention du paiement :
z Sale indique qu'il s'agit d'une vente finale pour laquelle vous
demandez un paiement.
z Authorization ou Order indique qu'il s'agit d'un paiement
qui sera traité par Autorisation et collecte PayPal.
R E M A R Q U E : Si vous donnez à PaymentAction la valeur Sale
ou à Order la valeur
SetExpressCheckoutRequest, vous ne pouvez
pas ensuite modifier la valeur PaymentAction de
DoExpressCheckoutPaymentRequest.
Vous pouvez cependant donner à PaymentAction
la valeur Sale pour
DoExpressCheckoutPaymentRequest si
vous l'aviez auparavant défini sur Authorization
pour SetExpressCheckoutRequest.
R E M A R Q U E : PayPal exige qu'un vendeur utilisant le Paiement
express PayPal affiche pour le client un montant
identique à celui qu'il envoie à PayPal pour
l'autorisation initiale dans l'élément OrderTotal
avec l'API
DoExpressCheckoutPaymentRequest .
Février 2007
43
Fonctionnement de Paiement express PayPal
Etape 3b : point d'intégration 3
TABLEAU 3.6 Notes d'utilisation : DoExpressCheckoutPaymentRequest
Elément
44
Obligatoire
ou facultatif ?
Notes
ItemTotal
ShippingTotal
HandlingTotal
TaxTotal
Facultatif
Vous pouvez envoyer des totaux individuels pour les objets,
l'expédition et la livraison, les frais de dossier et la TVA au moment
de la commande. Si vous envoyez ces informations, PayPal les
inclut dans l'avis de réception de transaction que le client reçoit de
PayPal et sur la page Détails de la transaction du site PayPal.
Si vous envoyez ces informations, la somme de ces quatre totaux
doit être égale à OrderTotal.
Order
Description
Facultatif
Description que vous souhaitez voir apparaître sur l'avis de
réception de transaction que le client reçoit de PayPal et sur la page
Détails de la transaction du site PayPal.
PayPal vous recommande d'inclure votre numéro de commande
pour cet achat, si vous en avez un.
PaymentDetail
sItem
z Name
z Number
z Amount
z Quantity
z SalesTax
Payment
Details
z ItemTotal
z TaxTotal
Payment
Details
Item est
facultatif.
Payment
Details est
obligatoire.
Si vous envoyez des détails sur chaque objet, ils sont inclus dans
l'avis de réception de transaction que le client reçoit de PayPal et
sur la page Détails de la transaction du site PayPal.
Ces informations permettent à votre client de vérifier les
informations concernant l'achat dans les détails de son compte
PayPal, elles peuvent l'aider à se souvenir des détails de l'achat et
réduire le risque que votre client ne dépose un rejet de débit par
erreur.
Les règles suivantes s'appliquent aux éléments de PaymentItem :
1. Si vous envoyez PaymentDetailsItem.Name, vous devez
également envoyer PaymentItem.Amount.
2. Si vous envoyez PaymentDetailsItem.Amount, la somme
de (PaymentDetailsItem.Amount x
PaymentDetailsItem.Quantity) de tous les objets du
paiement doit être égale à PaymentDetails.ItemTotal.
3. Si vous envoyez PaymentDetailsItem.SalesTax, la somme
de (PaymentDetailsItem.SalesTax x
PaymentDetailsItem.Quantity) de tous les objets du
paiement doit être égale à PaymentDetails.TaxTotal.
Février 2007
Fonctionnement de Paiement express PayPal
Etape 4 : le client est averti que la commande est terminée
TABLEAU 3.6 Notes d'utilisation : DoExpressCheckoutPaymentRequest
Elément
Obligatoire
ou facultatif ?
ShipToAddress
Facultatif
Notes
Si vous autorisez votre client à entrer ou à modifier les informations
de livraison sur votre site, vous devez transmettre son adresse de
livraison à PayPal.
R E M A R Q U E : si vous utilisez l'adresse de livraison que PayPal
vous a renvoyée avec
GetExpressCheckoutDetailsResponse,
ne la retransmettez pas à PayPal dans
DoExpressCheckoutPaymentRequest.
R E M A R Q U E : dans la mesure du possible, PayPal vous
recommande d'autoriser votre client à utiliser
l'adresse de livraison enregistrée par PayPal. La
procédure de paiement est simplifiée pour le client
et PayPal peut vous fournir la valeur
AddressStatus de l'adresse de livraison dans
GetExpressCheckoutDetailsResponse.
TABLEAU 3.7
Elément
Notes
TransactionID
Enregistre ce nombre pour suivre la commande. Il représente un espace réservé
de commande dans le système PayPal pour une autorisation ultérieure.
Etape 4 : le client est averti que la commande est terminée
Une fois que le client a approuvé la commande et qu'elle est terminée, PayPal vous
recommande d'afficher une page de fin de commande comportant les détails de la transaction.
Un exemple vous est donné ci-dessous.
Février 2007
45
Fonctionnement de Paiement express PayPal
Etape 4 : le client est averti que la commande est terminée
FIGURE 3.9 Exemple de page de fin de commande
PayPal envoie une notification par email au client avec les détails de la transaction terminée
concernant la commande. Vous recevez également un email à propos du paiement que vous
pouvez afficher dans votre Historique téléchargeable ou dans l'Aperçu de votre compte.
46
Février 2007
4
Présentation de la fonction
Autorisation et collecte
Autorisation et collecte est une solution de règlement offrant aux marchands davantage de
flexibilité pour obtenir le paiement de leurs acheteurs. Lors d'un achat classique via PayPal,
l'autorisation et la collecte sont effectuées simultanément. Autorisation et collecte sépare
l'autorisation de paiement de la collecte du paiement autorisé.
Autorisation et collecte s'adresse aux marchands dont le traitement des commandes est différé
et qui prélèvent en général 1 € pour l'autorisation lors du paiement. Cette opération permet aux
marchands de modifier le montant dû associé à l'autorisation initiale afin d'appliquer les
changements effectués après la commande initiale (tels que les taxes, les frais d'expédition ou
la disponibilité de l'objet). Ce chapitre vous guide tout au long des étapes d'autorisation, de
collecte, de nouvelle autorisation et d'annulation de fonds.
Il existe deux manières d'utiliser Autorisation et collecte :
1. Utilisez l'API (Application Programming Interface) Autorisation et collecte présentée ici et
abordée plus en détail dans le Guide de référence de l'API SOAP.
2. Créer une commande ou une autorisation avec Paiements sur site marchand HTML et
collecter ou annuler l'autorisation sur le site PayPal (https://www.paypal.fr/). Ce sujet n'est
pas abordé ici. Pour de plus amples informations sur Autorisation et collecte et Paiements
sur site marchand, consultez le Guide d'intégration de Paiements sur site marchand.
Procédure d'autorisation de base avec les API
Autorisation et collecte commence lorsque l'acheteur autorise un montant de paiement lors du
paiement.
1. Vous pouvez, par exemple, utiliser l'API Paiement express PayPal avec l'élément
<PaymentAction> réglé sur Autorisation ou Commande.
2. Une fois que votre acheteur a effectué la procédure de paiement, vous pouvez utiliser le
numéro de transaction avec l'API Autorisation et collecte. Vous pouvez :
– Collecter un montant partiel ou le montant total de l'autorisation ;
– Autoriser un montant plus élevé, jusqu'à 115 % du montant autorisé à l'origine (dans la
limite de $75 USD en plus) ;
– Annuler une autorisation antérieure.
Période de validité du paiement et Période d'autorisation
Lorsque votre acheteur approuve une autorisation, son solde peut être bloqué pendant 29 jours
pour garantir la disponibilité du montant autorisé pour la collecte. Vous pouvez autoriser à
Février 2007
47
Présentation de la fonction Autorisation et collecte
Procédure d'autorisation de base avec les API
nouveau une transaction une seule fois, jusqu'à 115 % du montant autorisé initialement (dans
la limite de $75 USD en plus).
Après une nouvelle autorisation réussie, PayPal honore 100 % des fonds autorisés pendant
trois jours. Cette période démarre avec le jour calendaire au cours duquel l'autorisation ou la
nouvelle autorisation a été accordée (de midi à 23 h 50, heure Pacifique).
Vous pouvez effectuer un règlement sans nouvelle autorisation du jour 4 au jour 29 de la
période d'autorisation, mais PayPal ne peut pas garantir que 100 % des fonds seront
disponibles après la période de trois jours de validité du paiement. Cependant, PayPal ne vous
permet pas de collecter des fonds si le compte de l'acheteur est restreint, bloqué, fait l'objet
d'un dossier signalant une fraude, ou si votre compte subit un second niveau de restriction.
Vous pouvez utiliser la fonction Autorisation et collecte uniquement si votre compte subit un
premier niveau de restriction.
La période de validité du paiement et la période d'autorisation sont définies comme suit :
Si vous tentez de collecter des fonds en dehors de la période de validité du paiement, PayPal
s'efforce de les collecter pour vous. Cependant, il se peut que ces fonds ne soient pas
disponibles à ce moment précis.
Les comptes de l'acheteur et du vendeur ne peuvent pas être clôturés si une autorisation est en
attente (règlement non effectué).
Produits de paiement PayPal acceptés
Vous pouvez utiliser la fonction Autorisation et collecte avec les produits PayPal répertoriés
dans le Tableau 4.1, "Produits PayPal acceptant Autorisation et collecte".
Par défaut, ces produits supposent qu'une transaction est une vente finale. Vous devez spécifier
explicitement si une transaction est une autorisation de base ou de commande.
R E M A R Q U E : vous devez capturer et annuler les commandes et les autorisations de commande
à l'aide des API de la fonction Autorisation et collecte. Autrement dit, vous ne
pouvez procéder à des autorisations de commande sur le site PayPal
(https://www.paypal.fr). Le site PayPal ne prend en charge que les autorisations
de base, pas les autorisations de commande.
TABLEAU 4.1 Produits PayPal acceptant Autorisation et collecte
Produit
Utilisation type
Paiements sur site marchand
paymentaction=”authorization”
Acheter maintenant
paymentaction=”authorization”
Dons
paymentaction=”authorization”
Paniers
paymentaction=”authorization”
Produits PayPal non acceptés. La fonction Autorisation et collecte ne peut pas être utilisée
avec les produits suivants :
z
48
Contact simplifié eBay
Février 2007
Présentation de la fonction Autorisation et collecte
Scénarios d'autorisation de commande
z
Chèque électronique
z
Chèques-cadeau et bons de réduction
z
Abonnements
z
Achat immédiat
z
Paiement
z
Demande de paiement
z
Terminal virtuel
z
Facturation
Scénarios d'autorisation de commande
Ci-après sont présentés des scénarios courants que vous rencontrerez lors de l'implémentation
de scénarios d'autorisation.
Commande simple
TABLEAU 4.2 Scénario dans le cas d'une commande simple
Action
Appel API
Solde en cours
Votre acheteur commande un objet de
votre site.
Vous demandez une commande auprès de
PayPal pour autoriser le paiement, avec la
variable paymentaction=order. Vous
recevez une réponse indiquant que la
commande a été créée pour un paiement
de 100 €.
DoExpressCheckoutPaymentRequest
avec :
Vous demandez une autorisation pour
100 €.
DoAuthorizationRequest
<100 €>
Vous collectez des fonds d'un montant de
115 €, montant maximum permis. La
commande présente maintenant l'état
"Terminé".
DoCaptureRequest
15 €
<PaymentAction>
order
</PaymentAction>
Février 2007
49
Présentation de la fonction Autorisation et collecte
Scénarios d'autorisation de commande
Commande complexe
TABLEAU 4.3 Scénario dans le cas d'une commande complexe
Action
Appel API
Solde en cours
Votre acheteur commande deux objets de
votre site.
50
Vous demandez une commande auprès de
PayPal pour autoriser le paiement, avec la
variable paymentaction=order. Vous
recevez une réponse indiquant que la
commande a été créée pour un paiement
de 100 €.
DoExpressCheckoutPaymentRequest
avec :
Vous demandez une autorisation pour
75 €.
DoAuthorizationRequest
<75 €>
Votre acheteur vous contacte et demande
une expédition pour le lendemain. Vous
collectez les fonds pour un montant de
80 € pour l'autorisation n° 1, afin de tenir
compte des frais d'expédition
supplémentaires.
DoCaptureRequest
5€
Vous demandez l'autorisation nº2 pour
25 €.
DoAuthorizationRequest
<25 €>
Votre acheteur vous contacte et modifie un
objet de la commande. Vous annulez
l'autorisation nº 2.
DoVoid
0,00 €
Vous demandez l'autorisation nº 3 pour
35 €, correspondant à la sélection du
nouvel objet.
DoAuthorizationRequest
<35 €>
Vous collectez l'autorisation nº 3 pour
35 €. Etant donné que le montant maximal
qu'il est possible de collecter est atteint
(115 % du montant d'origine), l'état de la
commande est maintenant "Terminé".
DoCaptureRequest
0,00 €
<PaymentAction>
order
</PaymentAction>
Février 2007
Présentation de la fonction Autorisation et collecte
Scénarios d'autorisation de commande
Autorisations concurrentes
TABLEAU 4.4 Scénario dans le cas d'autorisations concurrentes
Action
Appel API
Solde en cours
Votre acheteur commande 3 équipements
d'une valeur totale de 300 € sur votre site.
Vous demandez une commande auprès de
PayPal pour autoriser le paiement, avec la
variable paymentaction=order. Vous
recevez une réponse indiquant que la
commande a été créée pour un paiement
de 300 €.
DoExpressCheckoutPaymentRequest
avec :
Vous demandez une autorisation n° 1 au
jour 1, pour un montant de 100 €
correspondant au clavier. Vous recevez
une réponse indiquant que l'autorisation a
été créée pour un paiement de 100 €.
DoAuthorizationRequest
<100 €>
Vous collectez l'autorisation nº 1 pour
100 €. Vous expédiez le clavier.
DoCaptureRequest
0,00 €
Vous demandez une autorisation n° 2 au
jour 2, pour un montant de 200 €
correspondant au deuxième composant.
Vous recevez une réponse indiquant que
l'autorisation a été créée pour un paiement
de 200 €.
DoAuthorizationRequest
<200 €>
Le jour 3, vous collectez l'autorisation nº 2
pour 200 €.
DoCaptureRequest
0,00 €
<PaymentAction>
order
</PaymentAction>
Vous expédiez le deuxième composant.
Tolérance relative des montants collectés avec les autorisations ouvertes
TABLEAU 4.5 Scénario de tolérance relative des montants collectés avec les
autorisations ouvertes
Action
Appel API
Solde en cours
Votre acheteur commande un objet de
votre site d'une valeur de 1 000 €.
Février 2007
51
Présentation de la fonction Autorisation et collecte
Scénarios d'autorisation de commande
TABLEAU 4.5 Scénario de tolérance relative des montants collectés avec les
autorisations ouvertes
Action
Appel API
Vous demandez une commande auprès de
PayPal pour autoriser le paiement, avec la
variable paymentaction=order. Vous
recevez une réponse indiquant que la
commande a été créée pour un paiement
de 1 000 €.
DoExpressCheckoutPaymentRequest
avec :
Solde en cours
<PaymentAction>
order
</PaymentAction>
DoAuthorizationRequest
<1 100 €>
Vous collectez l'autorisation nº 1 pour
1 100 €.
DoCaptureRequest
0,00 €
Votre acheteur vous contacte et ajoute un
objet à la commande. Vous demandez
l'autorisation nº 2 pour 60 €, augmentant
ainsi le total de la commande à 1 160 €, ce
qui dépasse la limite de tolérance de
115 % de la commande d'origine.
DoAuthorizationRequest
<60,00 €>
Votre acheteur demande l'expédition pour
le lendemain. Vous demandez une
autorisation nº 1 pour 1 100 € (tolérance
relative de 110 %).
Vous recevez une réponse indiquant que
l'autorisation a été créée pour un paiement
de 1 100 €. Vous expédiez l'objet en stock
par courrier express pour livraison le
lendemain.
Vous recevez une réponse indiquant que la
demande d'autorisation nº 2 a été rejetée.
0,00 €
Annulation d'autorisations
TABLEAU 4.6 Scénario dans le cas d'annulation d'autorisations
Action
Appel API
Votre acheteur commande deux objets de
votre site.
Vous demandez une commande auprès de
PayPal pour autoriser le paiement, avec la
variable paymentaction=order. Vous
recevez une réponse indiquant que la
commande a été créée pour un paiement
de 350 €.
52
DoExpressCheckoutPaymentRequest
avec :
<PaymentAction>
order
</PaymentAction>
Février 2007
Solde en cours
Présentation de la fonction Autorisation et collecte
Scénarios d'autorisation de commande
TABLEAU 4.6 Scénario dans le cas d'annulation d'autorisations
Action
Appel API
Solde en cours
Vous demandez une autorisation n° 1 au
jour 1, pour un montant de 100 €. Vous
recevez une réponse indiquant que
l'autorisation a été créée pour un paiement
de 100 €.
DoAuthorizationRequest
<100 €>
Vous expédiez l'article. Vous collectez
l'autorisation nº 1 pour 100 €.
DoCaptureRequest
0,00 €
Vous demandez une autorisation n° 2 au
jour 2, pour un montant de 200 €. Vous
recevez une réponse indiquant que
l'autorisation a été créée pour un paiement
de 200 €.
DoAuthorizationRequest
<200 €>
DoVoid
0,00 €
L'acheteur vous contacte et annule l'objet
restant.
Vous annulez l'autorisation nº 2.
Collecte partielle
TABLEAU 4.7 Scénario dans le cas d'une collecte partielle
Action
Appel API
Solde en cours
Votre acheteur commande un objet de
votre site.
Vous demandez une commande auprès de
PayPal pour autoriser le paiement, avec la
variable paymentaction=order. Vous
recevez une réponse indiquant que la
commande a été créée pour un paiement
de 100 €.
DoExpressCheckoutPaymentRequest
avec :
Vous demandez une autorisation n° 1 au
jour 1, pour un montant de 100 €. Vous
recevez une réponse indiquant que
l'autorisation a été créée pour un paiement
de 100 €.
DoAuthorizationRequest
<100 €>
Vous expédiez l'article. Vous collectez
l'autorisation nº 1 pour 100 €.
DoCaptureRequest
0,00 €
Réglez la fonction CompleteType sur
NotComplete dans l'API DoCapture, et
collectez les fonds d'un montant de 50 €.
DoCaptureRequest
50 €
<PaymentAction>
order
</PaymentAction>
Février 2007
53
Présentation de la fonction Autorisation et collecte
Optimisez l'expérience de votre acheteur
Collecte complète
TABLEAU 4.8 Scénario dans le cas d'une collecte complète
Action
Appel API
Solde en cours
Votre acheteur commande un objet de
votre site.
Vous demandez une commande auprès de
PayPal pour autoriser le paiement, avec la
variable paymentaction=order. Vous
recevez une réponse indiquant que la
commande a été créée pour un paiement
de 100 €.
DoExpressCheckoutPaymentRequest
avec :
Vous demandez une autorisation n° 1 au
jour 1, pour un montant de 100 €. Vous
recevez une réponse indiquant que
l'autorisation a été créée pour un paiement
de 100 €.
DoAuthorizationRequest
<100 €>
Vous collectez l'autorisation nº 1 pour
100 €. Vous expédiez l'article.
DoCaptureRequest
0,00 €
<PaymentAction>
order
</PaymentAction>
R E M A R Q U E : la
valeur par défaut pour l'API DoCapture est une collecte complète et non une
collecte partielle.
Optimisez l'expérience de votre acheteur
Cette section détaille les pratiques recommandées auxquelles vous devriez vous conformer
dans le cadre de l'utilisation de la fonction Autorisation et collecte, pour garantir une
expérience optimale à vos clients et pour tirer le meilleur parti de cette fonction.
Collecter des fonds faisant l'objet d'autorisations de base
PayPal vous recommande de collecter les fonds dans les trois jours suivant la transaction, car il
s'agit de la période de validité du paiement au cours de laquelle PayPal garantit les fonds après
une autorisation de base. Si vous tentez de collecter les fonds après ces trois jours et que
l'autorisation échoue, votre demande de collecte de fonds peut être rejetée.
Après le jour 4 de la période d'autorisation, vous pouvez initier une nouvelle autorisation, qui
démarrera une nouvelle période de validité du paiement de trois jours. Cependant, cette
opération n'étendra pas la période d'autorisation initiale une fois ses 29 jours écoulés. Par
exemple, si vous réussissez à effectuer une nouvelle autorisation le jour 29 de la période
d'autorisation, les fonds ne seront honorés que jusqu'à la fin du jour 29.
54
Février 2007
Présentation de la fonction Autorisation et collecte
Optimisez l'expérience de votre acheteur
Il est vivement recommandé de collecter les fonds dans les 24 heures suivant l'expédition de la
commande de votre acheteur.
Approbation de l'acheteur pour les autorisations de base
Une autorisation initiée par un acheteur vous permet de collecter les fonds du compte de
l'acheteur jusqu'à 115 % du montant autorisé initialement (ne devant pas dépasser une
augmentation de $75 USD) et jusqu'à $10 000 USD.
IMPO RTANT : si vous souhaitez mettre à jour n'importe quel détail de l'achat susceptible de
modifier le montant autorisé initialement, PayPal vous demande d'obtenir le
consentement de l'acheteur au moment de l'achat ou au moment de la
collecte.
Annuler les autorisations de base
Si vous pensez qu'une autorisation ou une nouvelle autorisation ne sera pas utilisée, nous vous
recommandons vivement de l'annuler. L'annulation de l'autorisation débloque les sources
d'approvisionnement de votre acheteur temporairement bloquées.
Février 2007
55
Présentation de la fonction Autorisation et collecte
Optimisez l'expérience de votre acheteur
56
Février 2007
5
Questions/réponses au sujet du
Paiement express PayPal
Ce chapitre répond à certaines questions concernant l'intégration de Paiement express PayPal.
Pourquoi le bouton de Paiement express PayPal doit-il se
trouver au début de la procédure de paiement ?
L'un des principaux atouts de Paiement express PayPal réside dans le fait que cette fonction
permet à votre client d'ignorer plusieurs étapes de la procédure de paiement sur votre site. Au
lieu d'avoir à entrer des informations concernant l'adresse de livraison, l'adresse de facturation
et la carte bancaire, votre client clique tout simplement sur le bouton Paiement express PayPal,
se connecte à son compte PayPal, consulte ses informations personnelles, puis retourne sur
votre site pour terminer l'achat.
Cela augmente les achats impulsifs, les achats à répétition et les achats de clients qui préfèrent
payer en ligne avec PayPal.
Que se passe-t-il si mon client a besoin d'entrer une nouvelle
adresse de livraison ou de modifier ses informations de
livraison ?
Si, la première fois que vous avez utilisé SetExpressCheckoutRequest, votre client a
sélectionné une adresse de livraison enregistrée dans son compte PayPal, PayPal vous
recommande de rediriger le navigateur de votre client vers PayPal pour qu'il modifie son
adresse de livraison. Pour rediriger le navigateur une deuxième fois, utilisez
SetExpressCheckoutRequestà nouveau , mais incluez également l'élément et la valeur
Token que vous avez reçus de SetExpressCheckoutResponse la première fois. (Dans la
seconde SetExpressCheckoutRequest, vous fournissez ReturnURL, CancelURL et les
autres éléments obligatoires uniquement si leur valeur diffère de celle fournie dans la première
SetExpressCheckoutRequest. Il est fort probable que ces valeurs soient différentes lors
de la seconde requête.)
R E M A R Q U E : n'oubliez pas d'actualiser la valeur de OrderTotal et de MaxAmount en cas de
nouveaux frais.
Pour en savoir plus concernant le Token, consultez le Guide de référence de l'API SOAP.
Février 2007
57
Questions/réponses au sujet du Paiement express PayPal
Quelle est la différence maximale entre la valeur estimée et la valeur finale de OrderTotal ?
Quelle est la différence maximale entre la valeur estimée et la
valeur finale de OrderTotal ?
Question
Quelle est la différence maximale autorisée par PayPal entre la valeur estimée de
OrderTotal envoyée avec SetExpressCheckoutRequest au point d'intégration 1 et la
valeur finale de OrderTotal envoyée avec DoExpressCheckoutPaymentRequest au
point d'intégration 3 ?
Réponse
Il n'y a pas de différence maximale autorisée. Toutefois, au point d'intégration 3, PayPal
vérifie que la valeur finale de OrderTotal est toujours dans les limites du modèle de gestion
des risques pour la source d'approvisionnement que le client a choisie au départ au point
d'intégration 1. Si les modes de paiement choisis ne sont plus acceptables, (par exemple, si le
solde PayPal du client ne suffit pas à couvrir le montant de la commande finale),
DoExpressCheckoutPaymentResponse renvoie l'erreur 10422 qui indique que vous
devez renvoyer le navigateur du client vers PayPal pour sélectionner et approuver une
nouvelle source d'approvisionnement.
Ces cas sont néanmoins rares, car au point d'intégration 1, la fonction Express Checkout
calcule une augmentation possible entre la valeur estimée de OrderTotal et la valeur finale
de OrderTotal. Cette différence estimée est prise en compte dans le modèle de gestion des
risques de PayPal mais n'est pas visible par le client.
Que se passe-t-il si j'envoie mon client vers PayPal et qu'il
change d'avis ?
Un bouton Annuler est affiché sur toutes les pages de Paiement express PayPal. Le lien du
bouton Annuler correspond à la valeur de l'élément CancelURL que vous envoyez avec
SetExpressCheckoutRequest. Si le client décide de ne plus utiliser PayPal, il clique sur le
bouton Annuler et son navigateur est renvoyé vers l'URL que vous avez fournie à cet effet. Le
jeton de Paiement express PayPal est ajouté à la valeur de votre CancelURL, tel que décrit à la
section "ReturnURL, CancelURL et jeton Express Checkout" page 38. De même, si le client
ne peut pas payer avec PayPal (par exemple, si son solde PayPal est insuffisant), toutes les
pages d'erreur de PayPal affichent un bouton qui renvoie le client vers votre CancelURL.
58
Février 2007
Questions/réponses au sujet du Paiement express PayPal
Que se passe-t-il si mon client approuve l'utilisation de PayPal mais qu'il n'achète pas mon produit ?
IMPO RTANT : une fois que le client a approuvé l'utilisation de PayPal et qu'il est revenu sur
votre site, s'il ne veut plus utiliser PayPal pour vous payer (par exemple, s'il
décide de vous payer sur votre site et non plus via PayPal), n'utilisez pas
l'API finale DoExpressCheckoutPayment. Une transaction via PayPal a lieu
uniquement lorsque vous réussissez à invoquer
DoExpressCheckoutPaymentRequest.
Que se passe-t-il si mon client approuve l'utilisation de PayPal
mais qu'il n'achète pas mon produit ?
PayPal ne crée pas de paiement de la transaction tant que vous n'envoyez pas
DoExpressCheckoutPaymentRequest au point d'intégration 3 et que vous ne recevez pas
de réponse. Par conséquent, si l'acheteur n'achète pas un produit sur votre site, aucune
transaction n'a lieu.
Lorsque le point d'intégration 2 est atteint, suis-je sûr que le
paiement pourra avoir lieu ?
Question
Une fois que le client a approuvé l'utilisation de PayPal et retourne sur mon site au point
d'intégration 2, suis-je sûr que le paiement pourra avoir lieu ?
Réponse
Non. PayPal n'autorise pas le paiement ou bloque les fonds du client tant que vous n'envoyez
pas DoExpressCheckoutPaymentRequest au point d'intégration 3, car vous pourriez
modifier la valeur finale de OrderTotal ou le client pourrait décider de ne pas terminer
l'achat.
Puis-je simplement ajouter les champs de nom d'utilisateur et
de mot de passe PayPal sur mon site ?
Non. Le nom d'utilisateur et le mot de passe PayPal d'un client sont des informations
confidentielles qui lui appartiennent et qui sont protégées par PayPal. De nombreux clients
utilisent PayPal car ils n'aiment pas entrer des informations relatives à leur carte bancaire
directement sur les sites des vendeurs. Même si votre site est sécurisé et digne de confiance,
PayPal doit demander aux clients leur nom d'utilisateur et leur mot de passe sur une page
Février 2007
59
Questions/réponses au sujet du Paiement express PayPal
Puis-je simplement ajouter les champs de nom d'utilisateur et de mot de passe PayPal sur mon site ?
hébergée par PayPal pour leur garantir que leurs informations personnelles et financières sont
protégées.
60
Février 2007
">