PAYPAL Intégral Évolution - 2012 Guide d’intégration [fr]
Guide d’intégration de
PayPal Intégral
Evolution
Dernière mise à jour : Juin 2011
Guide d’intégration de PayPal Intégral Evolution
Numéro de document : 10113.en_US-201106
© 2011 PayPal, Inc. Tous droits réservés. PayPal est une marque déposée de PayPal, Inc. Le logo PayPal est une marque déposée de PayPal, Inc. Les
autres marques, déposées ou non, appartiennent à leur propriétaire respectif.
Les informations contenues dans le présent document appartiennent à PayPal, Inc. Elles ne peuvent être utilisées, reproduites ou divulguées sans
l'autorisation écrite de PayPal, Inc.
Copyright © PayPal. Tous droits réservés. PayPal (Europe) S.à r.l. et Cie., S.C.A., Société en Commandite par Actions. Siège social : 22-24 Boulevard
Royal, L-2449, Luxembourg, R.C.S. Luxembourg B 118 349.
Avis aux utilisateurs : le service de paiement PayPal™ est considéré comme une fonction de porte-monnaie électronique par la loi de Singapour. En tant
que tel, il ne nécessite pas l'approbation de la Monetary Authority of Singapore. Nous vous invitons à lire attentivement les Conditions générales.
Exclusion de responsabilité :
Les informations contenues dans le présent document vous sont fournies par PayPal, Inc. « telles quelles », et PayPal Inc. ne garantit en aucune
manière que le présent document est exempt d'erreurs. PayPal, Inc. ne fournit aucune garantie (expresse, tacite ou légale) concernant les informations
contenues dans les présentes. PayPal, Inc. n'accepte aucune responsabilité en cas de dommages (directs ou indirects) causés par des erreurs ou
omissions ou découlant de l'utilisation du présent document ou des informations contenues dans celui-ci, ou résultant de la demande de souscription ou
de l'utilisation du produit ou service décrit aux présentes. PayPal, Inc. se réserve le droit de modifier toute information figurant aux présentes sans vous
en avertir.
Sommaire
Préface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
A propos de ce document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Public ciblé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Historique des révisions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Commentaires sur la documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Chapitre 1 Premiers pas avec PayPal Intégral Evolution . . . . . . . . 9
Aperçu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Fonctionnalités et avantages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Fonctionnement d'Intégral Evolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Protection des Marchands PayPal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Vérification instantanée de paiement . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Traitement des transactions PayPal Express . . . . . . . . . . . . . . . . . . . . . . . . 13
Présentation de l'intégration d'Intégral Evolution . . . . . . . . . . . . . . . . . . . . . . 14
Chapitre 2 Intégration sur votre site en HTML . . . . . . . . . . . . . 15
Intégration simple d'Intégral Evolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Exemple d'intégration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Variables HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Chapitre 3 Personnalisation de votre page de paiement PayPal . . . .21
Modifier les paramètres de compte PayPal . . . . . . . . . . . . . . . . . . . . . . . . . 21
Paramètres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Apparence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Ajouter des variables HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Chapitre 4 Intégration d'iFrame sur votre site . . . . . . . . . . . . .33
Intégrer des iFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Intégration manuelle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Intégration API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Guide d’intégration de PayPal Intégral Evolution 3
Sommaire
Chapitre 5 Intégration sur votre site avec les API . . . . . . . . . . . 39
Hébergement de boutons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Utiliser l'API du Gestionnaire de boutons avec le paiement Intégral Evolution . . . . . . . 40
Utiliser l'URL renvoyée dans la réponse (recommandé) . . . . . . . . . . . . . . . . 40
Utiliser le formulaire POST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Crypter les boutons à l'aide des clés publique et privée. . . . . . . . . . . . . . . . . 43
Exemple de lancement de paiement. . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Opération d'API BMCreateButton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Requête BMCreateButton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Réponse BMCreateButton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Erreurs BMCreateButton. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Chapitre 6 Protéger les boutons avec la fonction Paiements sur site
marchand cryptés51
Cryptage à clé publique utilisé par la fonction Paiements sur site marchand cryptés . . . . 52
Configurer les certificats avant d'utiliser la fonction Paiements sur site marchand cryptés . 53
Générer votre clé privée avec OpenSSL . . . . . . . . . . . . . . . . . . . . . . . . 53
Générer votre certificat public avec OpenSSL. . . . . . . . . . . . . . . . . . . . . . 53
Télécharger votre certificat public sur votre compte PayPal . . . . . . . . . . . . . . . 54
Télécharger le certificat public PayPal à partir du site PayPal. . . . . . . . . . . . . . 54
Supprimer votre certificat public . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Utiliser la fonction Paiements sur site marchand cryptés pour protéger vos boutons de
paiement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Bloquer les paiements sur site marchand non protégés et non cryptés . . . . . . . . . 57
Chapitre 7 Tester votre intégration dans l'Environnement de test . . .59
Création d'un compte préconfiguré . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Tester votre intégration et vos paramètres. . . . . . . . . . . . . . . . . . . . . . . . 63
Chapitre 8 Traitement de la commande . . . . . . . . . . . . . . . . .65
Vérifier l'état et l'authenticité de la transaction . . . . . . . . . . . . . . . . . . . . . . . 65
Valider la notification instantanée de paiement (IPN) . . . . . . . . . . . . . . . . . . 65
Exécuter un appel API GetTransactionDetails. . . . . . . . . . . . . . . . . . . . . . 66
Finaliser une commande . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Annexe A Opérations d'API facultatives . . . . . . . . . . . . . . . . 67
API GetTransactionDetails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
4 Guide d’intégration de PayPal Intégral Evolution
Sommaire
Requête GetTransactionDetails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Réponse GetTransactionDetails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
API RefundTransaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Requête RefundTransaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Réponse RefundTransaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
API DoCapture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Requête DoCapture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Réponse DoCapture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Chapitre B Passer de PayPal Intégral à PayPal Intégral Evolution . . .85
Comparaison d'échantillons de code . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Annexe C Messages d'erreur . . . . . . . . . . . . . . . . . . . . . .89
Annexe D Codes de devises . . . . . . . . . . . . . . . . . . . . . .99
Guide d’intégration de PayPal Intégral Evolution 5
Sommaire
6 Guide d’intégration de PayPal Intégral Evolution
Préface
P
A propos de ce document
Le Guide d’intégration de PayPal Intégral Evolution explique comment intégrer Intégral
Evolution. Il inclut des informations sur les aspects suivants :
z Fonctionnalités et avantages d'Intégral Evolution
z Protection des Marchands
z Passage de Paiements sur site marchand à Intégral Evolution
z Intégration sur votre site marchand d'Intégral Evolution
z Personnalisation de votre page de paiement PayPal
z Test de votre intégration dans l'Environnement de test
z Vérification de l'état et de l'authenticité des transactions avant de traiter des commandes
Public ciblé
Ce guide est destiné aux marchands qui souhaitent intégrer Intégral Evolution pour ajouter une
solution de traitement des transactions à leur site.
Historique des révisions
Le tableau suivant donne l'historique des révisions apportées au Guide d’intégration de
PayPal Intégral Evolution.
TABLEAU P.1 Historique des révisions pour ce guide
Date de
publication Description
Octobre 2010 Ajout des informations sur les API et iFrame.
Mai 2010 Création du Guide d’intégration de PayPal Intégral Evolution
Guide d’intégration de PayPal Intégral Evolution 7
Préface
P
Commentaires sur la documentation
Commentaires sur la documentation
Aidez nous à améliorer ce guide en envoyant vos commentaires à :
documentationfeedback@paypal.com
8 Guide d’intégration de PayPal Intégral Evolution
1
Aperçu
Premiers pas avec PayPal Intégral Evolution
PayPal Intégral Evolution est une plateforme de paiement permettant aux commerçants de
recevoir sur leur site des paiements par carte et par compte PayPal. Cette solution est hébergée
par PayPal. Vous n'avez donc ni à collecter ni à stocker d'informations relatives aux cartes des
acheteurs sur votre site, ce qui contribue à la conformité PCI.
Intégral Evolution est le meilleur choix pour les marchands qui préfèrent une solution où les
informations financières sont gérées par PayPal.
Outre Intégral Evolution, PayPal vous recommande de mettre un bouton PayPal Express sur
votre site. Le bouton apparaît beaucoup plus tôt dans le flux de paiement et donne aux
titulaires de compte PayPal la possibilité d'utiliser PayPal, augmentant ainsi le taux de
conversion.
Fonctionnalités et avantages
Voici les fonctionnalités et avantages d'Intégral Evolution :
z Conformité PCI : les standards de sécurité des données PCI (Payment Card Industry), ou
PCI DSS, constituent une norme de sécurité mondiale qui s'applique à toutes les entreprises
qui collectent, stockent, traitent ou transfèrent des informations sur les titulaires de carte.
Vous pouvez utiliser la page de paiement hébergée de PayPal dans le cadre d'une solution
conforme à PCI.
REMARQUE : Intégral Evolution contribue à la mise en conformité avec les normes PCI
mais ne la garantit pas nécessairement.
z PayPal e-Terminal : solution de paiement en ligne hébergée par PayPal, qui vous permet
d'accepter des commandes par téléphone, fax et courrier pour les principales cartes.
z Protection des Marchands - Ce programme vous protège contre les oppositions au
paiement sur les transactions par carte ou compte PayPal. Pour plus d'informations,
consultez la section « Protection des Marchands PayPal » page 11
z PayPal Express : option de paiement en deux clics pour les titulaires de compte PayPal.
Pour plus d'informations, consultez la section « Traitement des transactions PayPal
Express » page 13.
Guide d’intégration de PayPal Intégral Evolution 9
Premiers pas avec PayPal Intégral Evolution
Fonctionnement d'Intégral Evolution
z Prise en charge d'iFrame : PayPal propose un formulaire de paiement compact pouvant
être intégré à un iFrame sur votre site. L'acheteur effectue le paiement sur votre site et vous
pouvez appliquer l'apparence de votre site dans le cadre principal autour du formulaire de
paiement compact. Les champs de carte sont intégrés dans le formulaire de paiement
compact pour que vous n'ayez pas à collecter ces informations séparément. Pour plus
d'informations, consultez la section Chapitre 3, « Personnalisation de votre page de
paiement PayPal ».
z Prise en charge des principales cartes de paiement : Visa, MasterCard, Carte Bancaire,
Carte Aurore, Cofinoga et 4 étoiles.
Fonctionnement d'Intégral Evolution
Dans l'image ci-dessus, le flux d'en haut illustre le paiement avec un compte PayPal et celui
d'en bas le paiement par carte.
Pour intégrer Intégral Evolution sur votre site :
1. Générez un bouton dans le flux de paiement de votre site en utilisant HTML ou les API
(disponible dans une version ultérieure). L'intitulé du bouton peut être Payer ou Acheter
ou un texte similaire. Lorsque l'acheteur clique sur ce bouton, il est redirigé vers la page de
paiement hébergée par PayPal.
2. Sur la page de paiement, l'acheteur entre ses informations de carte et clique sur le bouton
Payer. Il peut utiliser son compte PayPal, mais ce n'est pas nécessaire d'avoir un compte
pour pouvoir payer.
3. Si la transaction réussit, la page de confirmation PayPal s'affiche ou l'acheteur est redirigé
vers une URL que vous avez spécifiée. Si la transaction a échoué, un message d'erreur
s'affiche et l'acheteur peut rectifier l'erreur et recommencer la transaction.
10 Guide d’intégration de PayPal Intégral Evolution
Premiers pas avec PayPal Intégral Evolution
Vous pouvez spécifier le contenu de la page de paiement et configurer son apparence afin
qu'elle reflète celle de votre site, y compris votre logo.
Protection des Marchands PayPal
Si PayPal est la seule solution de paiement proposée sur votre site, les transactions traitées via
Intégral Evolution peuvent bénéficier de la Protection des Marchands PayPal. Cette protection
couvre les paiements effectués par l'intermédiaire du flux de paiement de votre site pour des
objets vendus en France comme à l'étranger. Ceux-ci peuvent être payés à l'aide d'une carte ou
d'un compte PayPal.
Pour bénéficier de la Protection des Marchands PayPal, l'objet acheté doit être expédié à
l'adresse que vous avez communiquée à PayPal.
D'un point de vue technique, vous devrez notamment :
z Envoyer toutes les informations sur les adresses de facturation et de livraison fournies par
l'acheteur dans le formulaire POST.
z Définir la variable address_override sur 1 et la variable showShippingAddress
sur false (ou la désélectionner sur la page des Paramètres de vos Préférences).
Protection des Marchands PayPal
IMPORTANT :Le bénéfice de cette protection est soumis à conditions. Pour les consulter
dans leur intégralité, merci de lire les Conditions d'Utilisation de PayPal eTerminal et de PayPal Intégral Evolution.
Vérification instantanée de paiement
Pour bénéficier de la Protection des Marchands PayPal, vous devez procéder à l'intégration en
activant la vérification de paiement instantanée. Vérification de paiement est une fonction qui
identifie les transactions à haut risque et vous avertit pour que vous puissiez reporter
l'expédition ou la livraison jusqu'à ce que le risque ait été évalué par PayPal. Cette fonction est
disponible pour tous les marchands. Elle vous aide à réduire vos pertes et vous permet de faire
bénéficier les transactions de la Protection des Marchands.
Lorsqu'une transaction est initiée, PayPal effectue une évaluation supplémentaire du risque
présenté par l'acheteur. PayPal évalue toutes les transactions (Autorisations et Ventes) de façon
immédiate et identifie les transactions à haut risque comme étant « En cours de vérification »,
et vous en êtes immédiatement averti. Vous ne devez pas envoyer les biens ou, s'il s'agit d'un
support électronique, vous ne devez pas autoriser l'accès au téléchargement tant que le
paiement est en cours de vérification. Les spécialistes de la fraude PayPal étudient la
transaction dans un délai de 24 heures et vous indiquent s'il s'agit d'une transaction Terminée
(validée par la vérification de paiement) ou Inversée (rejetée par la vérification de paiement).
Pour les transactions à risque, PayPal vous conseille de ne pas expédier les objets avant que la
transaction ne soit Terminée. Les paiements validés sont admissibles à la Protection des
Marchands PayPal.
Guide d’intégration de PayPal Intégral Evolution 11
Premiers pas avec PayPal Intégral Evolution
Protection des Marchands PayPal
Vous pouvez déterminer l'état d'un paiement de plusieurs manières :
z en vous connectant à https://www.paypal.fr et en affichant les informations d'état dans
l'Historique des transactions ;
z en vérifiant l'email envoyé par PayPal ;
z en vérifiant le message de notification instantanée de paiement (IPN) ;
z en vérifiant l'état des transactions par l'intermédiaire d'un programme. Pour vérifier l'état
initial d'une transaction, utilisez l'une des opérations API suivantes :
– DoExpressCheckoutPayment
– DoReferenceTransaction
– DoAuthorization
– DoReauthorization
Vous pouvez vérifier l'état suivant de la transaction en appelant l'opération d'API
GetTransactionDetails. Pour plus d'informations, consultez la section «API
GetTransactionDetails » page 67.
REMARQUE : Vous devez utiliser la version 58.0 (ou ultérieure) de l'API pour obtenir les
informations d'état initial fournies par DoExpressCheckoutPayment,
DoReferenceTransaction, DoAuthorization ou DoReauthorization.
Pour utiliser la vérification de paiement avec les opérations d'API de paiements
DoExpressCheckoutPayment, DoReferenceTransaction, DoAuthorization et
DoReauthorization, vous devez :
1. Observer l'état du paiement dans la réponse de l'opération d'API, et plus particulièrement
vérifier si la valeur de PaymentStatus est Pending.
2. Si la valeur de PaymentStatus est Pending, vérifiez si celle de PendingReason
est PaymentReview, parce qu'une transaction peut être mise en attente (état Pending)
pour d'autres motifs. Par exemple, le champ PaymentStatus d'une autorisation non
réglée peut avoir la valeur Pending et son champ PendingReason avoir pour valeur
authorization, ce qui n'a aucun rapport avec la vérification de paiement.
Si PaymentStatus a pour valeur Pending et si la valeur de PendingReason est
PaymentReview, vous ne devez pas envoyer les biens, ou ne pas autoriser l'accès au
téléchargement s'il s'agit d'un support électronique.
L'état du paiement étant modifié après la vérification, vous devez consulter régulièrement cet état
par l'opération de l'API GetTransactionDetails, en vérifiant l'email envoyé par PayPal, en vérifiant
les messages, ou en consultant l'Historique des transactions sur https://www.paypal.fr.
12 Guide d’intégration de PayPal Intégral Evolution
Premiers pas avec PayPal Intégral Evolution
Traitement des transactions PayPal Express
Traitement des transactions PayPal Express
PayPal Express est une solution de paiement en 2 clics qui permet de booster votre taux de
conversion. Elle donne aux acheteurs la possibilité d'utiliser les informations de livraison
stockées de façon sécurisée auprès de PayPal pour procéder au paiement, de sorte qu'ils n'ont
pas besoin de les ressaisir sur votre site. Cette solution peut être insérée à la fois sur les pages
produit et sur la page de récapitulatif du panier.
Les étapes suivantes décrivent le fonctionnement de PayPal Express.
1. Après avoir choisi les produits à acheter sur votre site, l'acheteur clique sur le bouton Payer
avec PayPal.
2. Il est alors redirigé vers le site PayPal, où il se connecte en utilisant son identifiant et son
mot de passe PayPal.
3. Après s'être connecté, il vérifie le résumé de la commande et clique sur Continuer pour
autoriser la transaction.
4. L'acheteur est alors redirigé vers la page de confirmation de votre site, où il peut vérifier les
détails de la commande et soumettre la transaction.
Pour plus d'informations sur le paiement express PayPal, consultez le
Paiement express.
Guide d'intégration de
Guide d’intégration de PayPal Intégral Evolution 13
Premiers pas avec PayPal Intégral Evolution
Présentation de l'intégration d'Intégral Evolution
Présentation de l'intégration d'Intégral Evolution
Après avoir fait une demande pour Intégral Evolution, suivez les étapes suivantes pour
intégrer Intégral Evolution à votre site :
1. Connectez votre site au service Intégral Evolution : identifiez un point du flux de paiement
de votre site où vous souhaitez placer un bouton Payer ou un bouton similaire, sur lequel
l'acheteur peut cliquer pour effectuer le paiement. Vous pouvez le faire en utilisant HTML
ou les API. En cliquant sur ce bouton, le navigateur de l'acheteur sera redirigé vers la page
de paiement PayPal pour le traitement de la transaction. Selon le mode d'intégration
souhaité, suivez les étapes décrites dans le Chapitre 2, « Intégration sur votre site en
HTML » ou le Chapitre 5, « Intégration sur votre site avec les API ».
2. Vous pouvez personnaliser l'apparence et le contenu de votre page de paiement hébergée
par PayPal en envoyant les variables HTTP appropriées ou en modifiant les paramètres de
votre compte PayPal. Consultez le Chapitre 3, « Personnalisation de votre page de
paiement PayPal ».
3. Vous pouvez également tester votre intégration dans l'Environnement de test PayPal. Cette
étape est décrite dans le Chapitre 7, « Tester votre intégration dans l'Environnement de
test ».
14 Guide d’intégration de PayPal Intégral Evolution
2
Intégration sur votre site en HTML
Ce chapitre décrit comment réaliser une intégration simple vous permettant de traiter les
transactions à l'aide d'Intégral Evolution.
REMARQUE : PayPal recommande la mise en œuvre d'une intégration simple pour vous
familiariser avec Intégral Evolution avant de passer à une intégration plus
personnalisée.
Dans le cadre d'une intégration simple, votre page de paiement est définie selon les paramètres
par défaut. Pour personnaliser l'apparence de la page et l'harmoniser avec votre site marchand,
procédez comme suit :
z Modifiez les paramètres de vos Préférences PayPal, comme indiqué dans la section
« Modifier les paramètres de compte PayPal » page 21.
z Ajoutez les variables HTML appropriées à la page de paiement, comme indiqué dans le
Tableau 2.1, « Variables HTML permettant de paramétrer la page de paiement » et le
Tableau 3.1, « Variables HTML permettant de paramétrer l'apparence de la page de
paiement ».
IMPORTANT : les variables HTML remplaceront les paramètres sauvegardés dans les
Préférences.
Intégration simple d'Intégral Evolution
Pour intégrer Intégral Evolution à votre site, identifiez un point du flux de paiement de votre
site où vous souhaitez placer un bouton sur lequel l'acheteur pourra cliquer pour effectuer le
paiement. L'intitulé du bouton doit être Continuer, Payer ou un texte similaire et un clic sur le
bouton doit déclencher l'envoi d'un formulaire POST à PayPal. Le clic sur ce bouton redirige
également le navigateur de l'acheteur vers la page de paiement de PayPal, où il peut procéder
au paiement avec une carte ou son compte PayPal.
Le formulaire POST intègre un ensemble de variables HTML qui permettent de décrire la
transaction. Dans le formulaire POST, vous devez indiquer ce qui suit :
z subtotal : montant de la transaction
z business : identifiant de compte marchand sécurisé (trouvé sur la page de Préférences)
ou adresse email associée à votre compte PayPal.
z paymentaction : Indique si la transaction est pour le paiement d'une vente finale ou
une autorisation pour une vente finale (qui sera repris plus tard).
Guide d’intégration de PayPal Intégral Evolution 15
Intégration sur votre site en HTML
Intégration simple d'Intégral Evolution
La devise par défaut est le dollar USD. Vous pouvez également spécifier les variables HTML
appropriées figurant dans le Tableau 2.1, « Variables HTML permettant de paramétrer la page
de paiement » afin de personnaliser les informations collectées sur la page de paiement ou le
Tableau 3.1, « Variables HTML permettant de paramétrer l'apparence de la page de paiement »
pour modifier l'apparence de la page. Si le paiement est réussi, l'acheteur voit s'afficher la page
de confirmation PayPal ou est redirigé vers l'URL que vous avez indiquée.
Un numéro de transaction est ajouté à l'URL de renvoi dans la chaîne de requête pendant la
redirection de la page de paiement vers votre site. Ce numéro de transaction peut être utilisé
pour récupérer l'état et vérifier l'authenticité de la transaction. Pour en savoir plus sur la
vérification de l'authenticité de la transaction avant de terminer la commande, consultez le
Chapitre 8, « Traitement de la commande ».
Exemple d'intégration
L'exemple ci-dessous illustre une intégration simple d'Intégral Evolution :
1. Exemple de formulaire POST pour Intégral Evolution :
<form action="https://securepayments.paypal.com/cgi-bin/acquiringweb"
method="post">
<input type="hidden" name="cmd" value="_hosted-payment">
<input type name="subtotal" value="50">
<input type name="business" value="HNZ3QZMCPBAAA">
<input type name="paymentaction" value="sale">
<input type name="return"
value="https://yourwebsite.com/receipt_page.html">
<input type="submit" name="METHOD" value="Pay">
</form>
Le texte en gras représente la valeur définie pour la variable correspondante. Nous vous
conseillons de mettre les valeurs entre parenthèses. Pour en savoir plus sur ces valeurs,
consultez le Tableau 2.1, « Variables HTML permettant de paramétrer la page de
paiement ».
2. Ajoutez le texte HTML sur votre site à l'endroit où les acheteurs procéderont à leur
paiement.
3. Ouvrez votre page de paiement et cliquez sur le bouton pour vérifier que la page de
paiement PayPal s'affiche.
Vous pouvez également utiliser l'environnement de test PayPal pour vérifier votre
intégration. Pour obtenir des informations détaillées sur les tests de votre intégration dans
l'environnement de test PayPal, consultez le Chapitre 7, « Tester votre intégration dans
l'Environnement de test ».
16 Guide d’intégration de PayPal Intégral Evolution
Variables HTML
Le tableau ci-dessous fournit une liste des variables HTML Intégral Evolution que vous
pouvez utiliser pour envoyer des informations supplémentaires sur la transaction avec votre
requête Web. Pour obtenir une liste des variables HTML que vous pouvez utiliser pour
personnaliser l'apparence de votre page de paiement, consultez le Tableau 3.1, « Variables
HTML permettant de paramétrer l'apparence de la page de paiement ».
TABLEAU 2.1 Variables HTML permettant de paramétrer la page de paiement
Variable Description Requis
Intégration sur votre site en HTML
Variables HTML
address1
address2
address_override
billing_ address1
billing_ address2
billing_ city
billing_ country
billing_ first_name
billing_ last_name
billing_ state
billing_ zip
bn
business
Rue de l'adresse de livraison. (champ 1 sur 2) Non
Rue de l'adresse de livraison. (champ 2 sur 2) Non
Le payeur voit l'adresse qui est transmise, mais ne peut pas
Non
la modifier. Cette variable est annulée si l'adresse
comporte des erreurs. Les valeurs autorisées sont
true/false. La valeur par défaut est false.
Rue de l'adresse de facturation. (champ 1 sur 2) Non
Rue de l'adresse de facturation. (champ 2 sur 2) Non
Ville de l'adresse de facturation. Non
Code pays de l'adresse de facturation. Non
Prénom pour l'adresse de facturation. Non
Nom pour l'adresse de facturation. Non
Etat de l'adresse de facturation. Non
Code postal de l'adresse de facturation. Non
Identifie la source qui a créé le code pour ce bouton.
Format -
<Société>_<Service>_<Produit>_<Pays>
Adresse email du compte PayPal ou numéro PayPal
Non
Oui
associé à votre compte PayPal (identifiant sécurisé du
marchand) Nous vous conseillons d'utiliser ce numéro, que
vous pouvez trouver dans la section supérieure de la page
Préférences PayPal.
buyer_email
cancel_return
Adresse email de l'acheteur. Non
Le navigateur sera redirigé vers cette URL si l'acheteur
Non
clique sur le lien "Retour chez le marchand". Entrez bien
l'URL entière, y compris http:// ou https://.
Guide d’intégration de PayPal Intégral Evolution 17
Intégration sur votre site en HTML
Variables HTML
T
ABLEAU 2.1 Variables HTML permettant de paramétrer la page de paiement(Suite)
Variable Description Requis
cbt
city
country
currency_code
custom
first_name
handling
invoice
last_name
lc
night_phone_a
Définit le texte du lien "Retour sur le site du marchand" de
Non
la page de confirmation PayPal. Pour les comptes
Business, le bouton de renvoi affiche votre raison sociale à
la place du mot "marchand" par défaut.
REMARQUE : La variable shopping_url doit être définie.
Ville de l'adresse de livraison. Non
Pays de l'adresse de livraison. Non
Devise du paiement. La valeur par défaut est USD. Non
Variable de transit qui n'est jamais communiquée au
Non
payeur.
Prénom de la personne à qui l'objet est envoyé. Non
Frais de traitement facturés. Ce montant est ajouté à la
valeur
subtotal pour obtenir le montant total.
Numéro de commande figurant dans le système de
Non
Non
commande et/ou de facturation du marchand.
Nom de la personne à qui l'objet est envoyé. Non
Langue de la page de connexion ou d'inscription. Non
Indicatif régional pour les numéros de téléphone aux Etats-
Non
Unis ou indicatif pays du numéro de téléphone en dehors
des Etats-Unis. Cette variable préremplit le numéro de
téléphone du domicile de l'acheteur.
night_phone_b
Préfixe à trois chiffres pour les numéros de téléphone aux
Non
Etats-Unis ou numéro de téléphone complet en dehors des
Etats-Unis , sans l'indicatif de pays. Cette variable
préremplit le numéro de téléphone du domicile de
l'acheteur.
REMARQUE : Utilisez cette variable pour les numéros
hors Etats-Unis.
night_phone_c
Numéro à quatre chiffres pour les numéros de téléphone
Non
aux Etats-Unis. Cette variable préremplit le numéro de
téléphone du domicile de l'acheteur.
notify_url
URL sur laquelle PayPal publie des informations sur la
Non
transaction, sous la forme de notification instantanée de
paiement (IPN). Entrez bien l'URL entière, y compris
http:// ou https://.
18 Guide d’intégration de PayPal Intégral Evolution
Intégration sur votre site en HTML
Variables HTML
T
ABLEAU 2.1 Variables HTML permettant de paramétrer la page de paiement(Suite)
Variable Description Requis
paymentaction
return
shipping
state
subtotal
tax
zip
Indique si la transaction concerne un paiement pour une
Oui
vente finale ou une autorisation pour une vente finale (à
collecter ultérieurement).
z Valeurs autorisées : authorization ou sale
z Valeur par défaut : sale
URL vers laquelle le navigateur de l'acheteur est redirigé
Non
une fois le paiement effectué. Entrez bien l'URL entière, y
compris http:// ou https://.
Frais d'expédition facturés. Ce montant est ajouté à la
valeur
subtotal pour obtenir le montant total.
Non
Etat de l'adresse de livraison. Non
Montant facturé pour la transaction. Si les frais
Oui
d'expédition et de traitement et les taxes ne sont pas
spécifiés, il s'agit du montant total facturé.
Taxes facturées. Ce montant est ajouté à la valeur
subtotal pour obtenir le montant total.
Non
Code postal de l'adresse de livraison. Non
Guide d’intégration de PayPal Intégral Evolution 19
Intégration sur votre site en HTML
Variables HTML
20 Guide d’intégration de PayPal Intégral Evolution
Personnalisation de votre page
3
de paiement PayPal
Vous pouvez personnaliser l'apparence de la page de paiement PayPal des deux façons
suivantes :
z Modifier les paramètres de compte PayPal
z Ajouter des variables HTML
REMARQUE : les variables HTML remplaceront les paramètres sauvegardés dans les
Préférences.
Modifier les paramètres de compte PayPal
Dans vos Préférences PayPal, vous pouvez modifier l'apparence de la page de paiement en
changeant les paramètres des pages suivantes de la section Paramètres de Paiements sur site
marchand.
z Paramètres
z Apparence
Guide d’intégration de PayPal Intégral Evolution 21
Personnalisation de votre page de paiement PayPal
Modifier les paramètres de compte PayPal
22 Guide d’intégration de PayPal Intégral Evolution
Paramètres
Personnalisation de votre page de paiement PayPal
Modifier les paramètres de compte PayPal
Cette page vous permet de sélectionner les informations que vous souhaitez collecter et
afficher sur votre page de paiement ainsi que l'emplacement de votre confirmation de
paiement.
Bien que nous offrions de nombreuses options pour cette page, nous vous recommandons
d'afficher le moins d'options possible sur la page de paiement. Par exemple, vous avez peutêtre déjà collecté une adresse de livraison sur votre site afin de calculer le coût de la livraison,
puis communiqué ces informations sur la page de paiement PayPal. Il n'est donc pas
nécessaire de réafficher cette option sur la page de paiement.
Vous pouvez disposer d'informations collectées auparavant sur votre site mais souhaiter les
communiquer à PayPal pour les réafficher sur la page de paiement. Ces informations seront
présaisies et modifiables sur cette page.
Guide d’intégration de PayPal Intégral Evolution 23
Personnalisation de votre page de paiement PayPal
Modifier les paramètres de compte PayPal
Quelles informations souhaitez-vous afficher sur votre page de paiement PayPal Intégral Evolution ?
Vous pouvez sélectionner les champs qui s'affichent sur la page de paiement parmi les champs
suivants :
z Informations relatives à la carte : informations de carte de l'acheteur. Ce champ est
sélectionné par défaut.
z Nom du client : prénom et nom de l'acheteur
z Adresse de facturation : adresse de facturation de l'acheteur
z Numéro de téléphone de facturation : numéro de téléphone de l'acheteur
z Adresse email de facturation : adresse email de l'acheteur
z Adresse de livraison : adresse de livraison de l'acheteur. Ce champ est obligatoire pour
que le paiement bénéficie de la Protection des Marchands PayPal. Si vous ne cochez pas
cette case, assurez-vous que la variable HTML de l'adresse de livraison de l'acheteur est
définie.
Comment souhaitez-vous afficher la confirmation de paiement ?
Une fois la transaction terminée, vous pouvez choisir d'afficher votre confirmation de
paiement sur une page PayPal ou sur votre propre page.
z Sur une page PayPal qui indique que le paiement est effectué : la confirmation du
paiement apparaît sur la page de confirmation PayPal. Une option vous permet également
d'ajouter une URL sur la page de confirmation qui redirige l'acheteur vers votre site.
Saisissez simplement l'URL appropriée dans le champ existant.
z Sur la page de confirmation de votre société : la confirmation du paiement apparaîtra sur
votre propre page. Saisissez l'URL de cette page qui affichera la confirmation de paiement.
Vous devez communiquer à l'acheteur le résultat de la transaction lorsque PayPal redirige
vers cette URL. Assurez-vous d'afficher les informations de la commande de façon à ce
que la confirmation soit comprise par l'acheteur. Vous pouvez obtenir ces informations en
utilisant le numéro de transaction que nous vous communiquons avec l'URL de renvoi.
24 Guide d’intégration de PayPal Intégral Evolution
Apparence
Personnalisation de votre page de paiement PayPal
Modifier les paramètres de compte PayPal
Guide d’intégration de PayPal Intégral Evolution 25
Personnalisation de votre page de paiement PayPal
Modifier les paramètres de compte PayPal
Cette page vous permet de personnaliser votre page de paiement. Vous pouvez personnaliser
l'en-tête, l'arrière-plan, le titre, le bouton et la colonne Résumé de la commande de votre page
de paiement.
PayPal vous permet de choisir entre trois modèles. Le modèle A est le modèle par défaut mais
vous pouvez choisir n'importe lequel des modèles proposés.
REMARQUE : vos acheteurs ne pourront pas visualiser la page de paiement tant que
l'intégration HTML sur votre site ne sera pas terminée.
Affichez l'aperçu de votre page de paiement. Vous pouvez soit modifier l'apparence de votre
modèle, soit sélectionner et personnaliser un modèle différent. Pour effectuer des
modifications, cliquez à gauche sur la section que vous souhaitez modifier ou sur le bouton
Cliquez ici pour modifier correspondant à cette section. Dans la fenêtre qui s'affiche, cliquez
sur la couleur choisie ou saisissez si nécessaire l'URL appropriée pour modifier la couleur.
Si l'acheteur effectue un paiement en se connectant à PayPal, l'apparence de ce flux peut être
personnalisée grâce aux options de personnalisation d'Intégral Evolution de la page
Préférences.
Après avoir effectué vos modifications, cliquez sur l'un des boutons suivants :
z Aperçu : prévisualiser les modifications que vous avez apportées à votre modèle avant de
l'enregistrer et de le publier.
z Enregistrer et publier : enregistrer toutes les modifications effectuées, puis publier le
modèle mis à jour. Vos acheteurs verront la page de paiement mise à jour.
z Annuler : annuler toutes les modifications effectuées dans cette session.
z Version précédente : annuler toutes les modifications effectuées depuis le dernier
enregistrement du modèle. Les acheteurs auront accès au dernier modèle sauvegardé.
REMARQUE : vous devez effectuer toutes les modifications (y compris le choix du modèle)
dans la même session, sans quoi tous vos changements seront perdus. Si la
session expire, l'apparence du modèle restera celle de la dernière version
publiée.
26 Guide d’intégration de PayPal Intégral Evolution
Personnalisation de votre page de paiement PayPal
Modifier les paramètres de compte PayPal
Choisir un modèle
Choisissez l'un des trois modèles suivants :
z Modèle A
z Modèle B
z Modèle C
Modèle A. Sélectionné par défaut : vous pouvez personnaliser l'en-tête.
FIGURE 3.1 Modèle A
Guide d’intégration de PayPal Intégral Evolution 27
Personnalisation de votre page de paiement PayPal
Modifier les paramètres de compte PayPal
Modèle B. Personnalisez l'en-tête, l'arrière-plan, le titre, le bouton et la colonne Résumé de la
commande.
FIGURE 3.2 Modèle B
28 Guide d’intégration de PayPal Intégral Evolution
Personnalisation de votre page de paiement PayPal
Modifier les paramètres de compte PayPal
Modèle C. Personnalisez l'en-tête, l'arrière-plan, le titre et le bouton.
FIGURE 3.3 Modèle C
Guide d’intégration de PayPal Intégral Evolution 29
Personnalisation de votre page de paiement PayPal
Modifier les paramètres de compte PayPal
Personnalisation de votre modèle
Lorsque vous personnalisez votre modèle, prenez en compte ce qui suit :
z En-tête (s'applique aux modèles A, B et C) : par défaut, votre raison sociale, telle
qu'indiquée dans vos préférences, s'affiche dans l'en-tête. Vous pouvez modifier les
éléments suivants :
– Hauteur et couleur de l'en-tête
– Type, taille et couleur de la police
– Choix de l'affichage : votre raison sociale ou votre logo
– Emplacement de la raison sociale ou du logo
REMARQUE : nous vous conseillons d'héberger vos images sur un serveur sécurisé
(https://) afin d'éviter l'affichage de la boîte de dialogue de sécurité, néfaste
pour la conversion.
z Arrière-plan (s'applique aux modèles B et C) - Vous pouvez modifier les éléments
suivants :
– Couleur d'arrière-plan
– URL de l'image d'arrière-plan
z Titre et bouton (s'applique aux modèles B et C) - Vous pouvez modifier les éléments
suivants :
– Couleur de l'en-tête
– Couleur du texte et de la barre du titre
– Couleur du bouton et du texte du bouton
z Colonne du résumé de la commande (s'applique au modèle C) - Vous pouvez modifier les
éléments suivants :
– Couleur de la colonne
– URL de l'image
30 Guide d’intégration de PayPal Intégral Evolution
Loading...