PAYPAL Guide d'intégration visuelle 2006 User Manual [fr]
Guide d’intégration de la gestion des commandes PayPal
Document numéro: 100009.en_US-200608
© 2006 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 appartiennent à leurs propriétaires respectifs.
Les informations contenues dans ce document sont la propriété de PayPal Inc. et ne peuvent être utilisées, reproduites ni divulguées sans l'autorisation
écrite de PayPal Inc.
PayPal (Europe) Ltd. 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 d'immatriculation FSA PayPal : 226056.
Avis de non responsabilité :
PayPal 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 et mises à disposition de tous à l'avenir.
Sommaire
Chapitre P Préface . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Ce document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Public cible . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Organisation de ce document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Conventions typographiques. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Problèmes relatifs à la documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Historique des révisions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Chapitre 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 15
Email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Rapports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Différences entre la notification instantanée de paiement (IPN) et le transfert des
données de paiement (PDT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
SSL non requis pour les IPN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Devises acceptées par PayPal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Chapitre 2 Transfert des données de paiement . . . . . . . . . . . . .19
Fonctionnement du PDT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Activer le transfert des données de paiement . . . . . . . . . . . . . . . . . . . . . . . . 23
Récupérer et utiliser le jeton d'identité. . . . . . . . . . . . . . . . . . . . . . . . . . 24
PDT et Compte PayPal facultatif. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Synchroniser la notification PDT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Construire la commande POST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Réponse de PayPal à la commande POST . . . . . . . . . . . . . . . . . . . . . . . 26
PDT et renvoi automatique : envoi d'un message à l'acheteur . . . . . . . . . . . . . 27
Prévention de la fraude . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Echantillons de code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Guide d’intégration de la gestion des commandes Octobre 2006 3
Sommaire
Chapitre 3 Notification instantanée de paiement (IPN) . . . . . . . . .29
A propos des IPN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Configuration de l'IPN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Activer l'IPN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Configurer un programme de traitement de notification instantanée de paiement . . . 31
Validation d'une IPN Prévention de la fraude . . . . . . . . . . . . . . . . . . . . . . . . 32
Secret partagé par transaction ou par préférence . . . . . . . . . . . . . . . . . . . . 32
Validation de secret partagé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Vos renvois HTTPS à PayPal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Utilisation de l'IPN dans plusieurs devises . . . . . . . . . . . . . . . . . . . . . . . . . . 35
payment_gross et payment_fee . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Exemples de variables IPN multi-devises . . . . . . . . . . . . . . . . . . . . . . . . 35
Notification d'un litige et Historique téléchargeable des litiges. . . . . . . . . . . . . . . . 38
Historique téléchargeable des litiges . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Chapitre 4 Historique des transactions et Outils de reporting . . . . . 41
Relevés de compte mensuels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Recherche en ligne dans l'Historique . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Recherche de base : Périodes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Recherche avancée : Champs clés . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Télécharger mon historique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Sélectionner une période . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Sélectionner un format de fichier et des catégories de transaction . . . . . . . . . . . 45
Transactions effectuées depuis le dernier téléchargement . . . . . . . . . . . . . . . 46
Personnaliser le téléchargement : sélectionner les champs relatifs à une transaction . 46
Rapprochement des transactions avec la colonne Impact sur le solde . . . . . . . . . 48
Cycle de vie d'une transaction : Etat. . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Colonne Montant net. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Historique des litiges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Accès programmé à l'Historique des litiges . . . . . . . . . . . . . . . . . . . . . . . 50
Annexe A Variables IPN et PDT . . . . . . . . . . . . . . . . . . . .53
A propos de ces tableaux de variables . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Valeurs de variables spécifiques à la transaction . . . . . . . . . . . . . . . . . . . . 53
Variable test_ipn dans l'Environnement de test . . . . . . . . . . . . . . . . . . . . . . . 54
4 Octobre 2006 Guide d’intégration de la gestion des commandes
Sommaire
Variables IPN dans toutes les publications . . . . . . . . . . . . . . . . . . . . . . . . . 54
Version d'IPN : notify_version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Informations sur la sécurité : verify_sign. . . . . . . . . . . . . . . . . . . . . . . . . 54
Informations sur l'acheteur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Informations de base. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Informations avancées et personnalisées . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Informations sur les Paiements sur site marchand et les remboursements . . . . . . . . . 57
Devise et conversion de devises. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Enchères . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Paiement groupé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Variables d'abonnement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Variables pour chaque événement d'abonnement. . . . . . . . . . . . . . . . . . . . 68
Variables de notification d'un litige . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Variables diverses et associées à la notification de commission . . . . . . . . . . . . 73
Variables spécifiques au PDT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Annexe B Historique téléchargeable Colonnes et valeurs . . . . . . .75
Annexe C Codes pays . . . . . . . . . . . . . . . . . . . . . . . . .85
Indice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91
Guide d’intégration de la gestion des commandes Octobre 2006 5
Sommaire
6 Octobre 2006 Guide d’intégration de la gestion des commandes
Liste des tableaux
Tableau P.1 Historique des révisions . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Tableau 1.1 Devises acceptées par PayPal et codes de devises pour les transactions 17
Tableau 4.1 Recherche de base : Types d'activité pouvant être sélectionnés . . . . . 43
Tableau 4.2 Recherche avancée de transactions : Champs clés . . . . . . . . . . . . 44
Tableau A.1 Variables IPN et PDT : Informations sur l'acheteur . . . . . . . . . . . . . 54
Tableau A.2 Variables IPN et PDT : Informations de base . . . . . . . . . . . . . . . . 55
Tableau A.3 Variables IPN et PDT : Informations avancées et personnalisées . . . . . 56
Tableau A.4 Variables IPN et PDT : Informations sur les Paiements sur site
marchand et les remboursements . . . . . . . . . . . . . . . . . . . . . 57
Tableau A.5 Variables IPN et PDT : devise et conversion de devises . . . . . . . . . . 62
Tableau A.6 Variables IPN et PDT : enchères . . . . . . . . . . . . . . . . . . . . . . 64
Tableau A.7 Variables IPN et PDT : Paiement groupé . . . . . . . . . . . . . . . . . . 65
Tableau A.8 Variables d'abonnement . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Tableau A.9 Variables IPN pour chaque événement d'abonnement . . . . . . . . . . . 69
Tableau A.10 Variables de notification d'un litige . . . . . . . . . . . . . . . . . . . . . 71
Tableau A.11 Variables diverses et associées à la notification de commission . . . . . . 73
Tableau A.12 Variables spécifiques au PDT. . . . . . . . . . . . . . . . . . . . . . . . 73
Tableau B.1 Colonnes et valeurs de l'historique téléchargeable . . . . . . . . . . . . . 75
Tableau C.1 Codes pays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Guide d’intégration de la gestion des commandes Octobre 2006 7
Liste des tableaux
8 Octobre 2006 Guide d’intégration de la gestion des commandes
Liste des figures
Figure 3.1 Fonctionnement de la notification instantanée de paiement :
Trois étapes principales . . . . . . . . . . . . . . . . . . . 30
Figure 4.1 Page Historique . . . . . . . . . . . . . . . . . . . . . . 41
Figure 4.2 Télécharger mon historique . . . . . . . . . . . . . . . . . 45
Figure 4.3 Personnaliser les champs de téléchargement . . . . . . . . . 47
Figure 4.4 Calculs des montants Avant commission, Commission,
Montant net dans l'Historique . . . . . . . . . . . . . . . . 49
Figure 4.5 Historique des litiges . . . . . . . . . . . . . . . . . . . . 50
Guide d’intégration de la gestion des commandes Octobre 2006 9
Liste des figures
10 Octobre 2006 Guide d’intégration de la gestion des commandes
P
Ce document
Cette version du PayPal Order Management Integration Guide, qui décrit les fonctions de
gestion des commandes de PayPal, telles que le transfert des données de paiement (PDT), la
notification instantanée de paiement (IPN) et l'historique téléchargeable, remplace la version
de décembre 2005.
Ce document remplace certaines parties du Guide du marchand et du Guide d'intégration de
Paiements sur site marchand publié en avril 2005.
Public cible
Ce document est destiné aux marchands qui utilisent PayPal pour gérer leurs informations sur
les commandes.
Préface
Organisation de ce document
Le Chapitre 1, « Introduction », présente brièvement les fonctions de gestion des commandes
de PayPal décrites dans ce guide.
Le Chapitre 2, « Transfert des données de paiement », explique le fonctionnement et la
configuration du PDT.
Le Chapitre 3, « Notification instantanée de paiement (IPN) », explique le fonctionnement et
la configuration de l'IPN.
Le Chapitre 4, « Historique des transactions et Outils de reporting », décrit les relevés de
compte mensuels, la recherche de transactions en ligne, l'Historique téléchargeable et
l'Historique des litiges.
L’Annexe A, « Variables IPN et PDT », décrit en détail toutes les variables et les valeurs
renvoyées par les fonctions IPN et PDT.
L’Annexe B, « Historique téléchargeable Colonnes et valeurs », présente les colonnes et les
valeurs contenues dans l'historique téléchargeable.
Guide d’intégration de la gestion des commandes Octobre 2006 11
Préface
Conventions typographiques
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
gras sérif Noms d'interfaces utilisateur, tels que les noms de fenêtres ou les options de
oblique sansérif
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 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 IPN relatives aux abonnements, telles que txn_type.
menus
Exemple : Dans la page Préférences, cliquez sur Email pour confirmer votre
adresse email.
Espaces réservés utilisés dans le contexte d'un format, ou norme de
programmation, ou descriptions formelles de la syntaxe du système PayPal. Les
espaces réservés indiquent les valeurs ou les noms que l'utilisateur doit fournir.
Exemple : Par exemple, amount est la variable d'un panier contenant un seul
objet, mais amount_
objets. amount_3 est le montant du troisième objet dans un panier contenant
plusieurs objets.
X est le nom de la variable d'un panier contenant plusieurs
12 Octobre 2006 Guide d’intégration de la gestion des commandes
Préface
Problèmes relatifs à la documentation
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 à
2. Cliquez sur Aide en haut à gauche 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.
https://www.paypal.fr/.
Historique des révisions
Historique des révisions du PayPal Order Management Integration Guide.
ABLEAU P.1 Historique des révisions
T
Date Description
Octobre 2006 Informations sur l'Historique téléchargeable des litiges. Ajouts et corrections
mineur(e)s à certaines variables de l'Annexe A.
Juillet 2006 Corrections mineures sur les valeurs de la variable IPN payment_status.
Guide d’intégration de la gestion des commandes Octobre 2006 13
Préface
Historique des révisions
T
ABLEAU P.1 Historique des révisions
Date Description
Mai 2006 Description de l'Historique des litiges, dont la consultation peut être
programmée. Nouvelles valeurs de la variable IPN pour txn_type : merch-pmt
pour les frais mensuels de Paiements sur site marchand Pro et modifications
pour la résolution d'un litige portant sur un rejet de débit.
14 Octobre 2006 Guide d’intégration de la gestion des commandes
1
Introduction
PayPal fournit quatre méthodes de notification de paiement à intégrer au système principal :
z Email
z Outils de reporting
z Notification instantanée de paiement (IPN)
z Transfert des données de paiement (PDT)
Vous recevez une notification par email dans les cas suivants :
z Paiement réussi
z Paiement en attente
z Paiement annulé
Si vous ne souhaitez pas recevoir de notifications de paiement par email :
1. Cliquez sur le sous-onglet Préférences de l'onglet Mon compte.
2. Cliquez sur le lien Notifications dans la colonne Informations personnelles.
3. Sous Notifications de paiement, désélectionnez la case à cocher Réception de paiement
4. Cliquez sur Enregistrer.
Rapports
Les outils de reporting de PayPal vous fournissent les informations dont vous avez besoin pour
évaluer et gérer efficacement votre activité. Avec les outils de reporting de PayPal, vous
pouvez :
z analyser vos sources de revenus pour mieux comprendre le comportement d'achat des
z automatiser les tâches de comptabilité fastidieuses ;
z régler et rapprocher précisément les transactions.
et règlement instantané sur le site PayPal.
clients ;
Rapports disponibles :
Guide d’intégration de la gestion des commandes Octobre 2006 15
Introduction
Différences entre la notification instantanée de paiement (IPN) et le transfert des données de paiement
z Relevés de compte mensuels : Consultez chaque mois le récapitulatif de tous les crédits et
débits ayant affecté le solde de votre compte.
z Rapports des ventes professionnelles : Recevez chaque semaine une analyse pertinente
des recettes par réseau de distribution et par devise.
z Historique : Accédez à un registre en ligne des paiements reçus et envoyés.
z Historiques téléchargeables : Effectuez un suivi de l'historique de vos transactions en le
téléchargeant dans divers formats de fichier (adaptés aux règlements financiers).
Pour en savoir plus sur les rapports de PayPal, consultez
bin/webscr?cmd=p/xcl/rec/reports-intro-outside.
http://www.paypal.com/fr/cgi-
Différences entre la notification instantanée de paiement (IPN)
et le transfert des données de paiement (PDT)
La principale fonction du PDT est d'indiquer le détail des transactions de paiements aux
acheteurs lorsque ceux-ci sont redirigés automatiquement vers votre site une fois le paiement
terminé. Toutefois, il est possible que vous ne receviez pas une notification pour toutes les
transactions, comme pour les transactions en attente, les remboursements ou les annulations.
Pour cette raison et si vous utilisez ces données pour honorer des commandes, PayPal vous
recommande fortement d'activer également la notification instantanée de paiement (IPN).
L'IPN et le PDT renvoient les mêmes données ; toutefois, il existe des différences importantes.
PDT :
z Requiert l'activation du renvoi automatique.
z Le renvoi automatique inclut un numéro d'identification qui peut être utilisé pour demander
à PayPal les détails complets de la transaction.
z Une notification peut être manquée si l'utilisateur ferme le navigateur avant la fin de la
redirection.
IPN :
z Ne requiert pas l'activation du renvoi automatique.
z A la fin de la procédure de paiement sur le site marchand, PayPal envoie les données IPN
de manière asynchrone (c'est-à-dire, en dehors de la procédure de paiement sur le site
marchand).
z Des IPN sont également envoyées pour les annulations et les remboursements.
SSL non requis pour les IPN
Les informations de carte bancaire n'étant pas transmises dans les notifications instantanées de
paiement (IPN), PayPal ne requiert pas l'utilisation du cryptage SSL (Secure Sockets Layer)
pour les transmissions d'IPN.
16 Octobre 2006 Guide d’intégration de la gestion des commandes
Devises acceptées par PayPal
Les devises suivantes sont acceptées par PayPal.
TABLEAU 1.1 Devises acceptées par PayPal et codes de devises pour les
transactions
Code ISO4217 Devise
AUD Dollar australien
CAD Dollar canadien
CHF Franc suisse
CZK Couronne tchèque
DKK Couronne danoise
EUR Euro
Introduction
Devises acceptées par PayPal
GBP Livre sterling
HKD Dollar de Hong-Kong
HUF Forint hongrois
JPY Yen japonais
NOK Couronne norvégienne
NZD Dollar néo-zélandais
PLN Zloty polonais
SEK Couronne suédoise
SGD Dollar de Singapour
USD Dollar américain
Guide d’intégration de la gestion des commandes Octobre 2006 17
Introduction
Devises acceptées par PayPal
18 Octobre 2006 Guide d’intégration de la gestion des commandes
Transfert des données de
2
paiement
La fonction de transfert des données de paiement offre aux vendeurs la possibilité d'indiquer le
détail des transactions de paiements aux acheteurs qui sont redirigés vers leur site une fois le
paiement terminé.
REMARQUE : Pour utiliser le transfert des données de paiement, vous devez activer le renvoi
automatique des paiements sur site marchand. Le renvoi automatique redirige
les acheteurs vers votre site une fois le paiement terminé. Le renvoi
automatique s'applique à tous les paiements sur site marchand, y compris aux
fonctions Acheter maintenant, Dons, Panier et Abonnements. Pour en savoir
plus sur le renvoi automatique, consultez le Guide d'intégration de Paiements
sur site marchand.
Fonctionnement du PDT
Jean souhaite acheter un gadget logiciel chez Planète Gadgets.
Etape 1 : Jean se rend sur le site de Planète Gadgets, recherche le gadget qu'il souhaite acheter
et clique sur Acheter maintenant.
Guide d’intégration de la gestion des commandes Octobre 2006 19
Transfert des données de paiement
Fonctionnement du PDT
Etape 2 : Jean est dirigé vers une page Détails du paiement PayPal comportant les détails du
paiement qu'il est sur le point d'effectuer.
Etape 3 : Jean entre ses informations de compte PayPal dans les champs de connexion PayPal.
20 Octobre 2006 Guide d’intégration de la gestion des commandes
Transfert des données de paiement
Fonctionnement du PDT
Etape 4 : Jean est ensuite dirigé vers une page de confirmation contenant les détails de sa
sélection, des informations sur la façon dont ses paiements automatiques sont approvisionnés
et ses informations de livraison. Il clique sur Payer pour effectuer le paiement.
Guide d’intégration de la gestion des commandes Octobre 2006 21
Transfert des données de paiement
Fonctionnement du PDT
Etape 5 : Une page de confirmation de paiement s'affiche pour informer Jean que son
paiement a été effectué et qu'il va être redirigé vers le site de Planète Gadgets.
Etape 6 : Un jeton de transaction est transmis à l'URL de renvoi fournie par Planète Gadgets.
Planète Gadgets récupère le jeton de transaction et extrait les détails de la transaction à partir
du site PayPal via une commande HTTP POST. Cette commande HTTP POST contient le
jeton d'identité fourni par Planète Gadgets lors de l'activation du PDT.
Pour en savoir plus sur le jeton d'identité du PDT, reportez-vous à la section “Récupérer et
utiliser le jeton d'identité” on page 24. Pour en savoir plus sur la commande HTTP POST,
reportez-vous à la section “Synchroniser la notification PDT” on page 26.
Etape 7 : La page de remerciements de Planète Gadgets s'affiche. Elle informe à nouveau Jean
que sa transaction est terminée et qu'un avis de réception de son achat lui a été envoyé par
email. Cette page contient également un lien vers PayPal que Jean peut utiliser s'il souhaite
accéder aux informations sur la transaction, ainsi que des liens sur lesquels il peut cliquer s'il
veut poursuivre ses achats.
22 Octobre 2006 Guide d’intégration de la gestion des commandes
Transfert des données de paiement
Activer le transfert des données de paiement
Par exemple, comme on peut le voir dans la figure ci-dessous : Nous vous remercions de votre
paiement. La transaction est terminée et le reçu de cet achat vous a été envoyé par email. Pour
consulter les détails de cette transaction, connectez-vous à votre compte sur
Etape 8 : Jean reçoit un avis de réception par email pour la transaction, qui confirme son achat
et contient une copie des détails du paiement, les informations sur votre activité de Planète
Gadgets et la confirmation de son adresse de livraison.
www.paypal.fr.
Activer le transfert des données de paiement
Pour activer le PDT :
1. Cliquez sur l'onglet Mon compte.
2. Cliquez sur le sous-onglet Préférences.
Guide d’intégration de la gestion des commandes Octobre 2006 23
Transfert des données de paiement
Activer le transfert des données de paiement
3. Cliquez sur le lien Préférences de réception de paiements sur site marchand, comme
indiqué dans la capture d'écran ci-dessous.
La page Préférences de réception de paiements sur site marchand s'ouvre.
4. Cliquez sur le bouton radio Transfert des données de paiement Oui, comme indiqué dans
l'illustration suivante.
Pour utiliser le transfert des données de paiement, vous devez activer le renvoi
automatique. Le renvoi automatique peut également être activé à partir de la page
Préférences de réception de paiements sur site marchand.
5. Cliquez sur Enregistrer.
Récupérer et utiliser le jeton d'identité
Lorsque vous cliquez sur Enregistrer pour sauvegarder vos préférences PDT, un message
apparaît en haut de la page vous indiquant que vos préférences ont été correctement
enregistrées. Votre jeton d'identité apparaît également dans ce message.
24 Octobre 2006 Guide d’intégration de la gestion des commandes
Transfert des données de paiement
PDT et Compte PayPal facultatif
Vous devez transmettre ce jeton d'identité ainsi que le jeton de transaction à PayPal pour
recevoir les informations confirmant la fin d'un paiement.
Pour des raisons de sécurité, le jeton d'identité ne vous est pas envoyé ; toutefois, dès que le
PDT est activé, il apparaît en permanence en dessous des boutons radio Oui/Non du transfert
des données de paiement sur la page Préférences de réception de paiements sur site
marchand.
PDT et Compte PayPal facultatif
Grâce à la fonction Compte PayPal facultatif, les utilisateurs qui ne connaissent pas PayPal ne
doivent pas nécessairement créer un compte PayPal pour effectuer un achat. Le paiement
s'effectue via un autre système et ils ont la possibilité d'ouvrir un compte ultérieurement. Les
utilisateurs qui possèdent déjà un compte PayPal peuvent continuer à profiter des avantages de
leur compte, comme l'historique des paiements et l'intégration aux enchères eBay. Le système
de paiement reste le même pour eux.
La fonction Compte PayPal facultatif est disponible pour les boutons Acheter maintenant,
Dons et Panier, mais pas pour les boutons d'abonnement.
La fonction Compte PayPal facultatif est activée par défaut. Si le vendeur a activé le transfert
des données de paiement sans la désactiver, un nouvel utilisateur n’est pas dirigé
automatiquement vers le site marchand, mais se voit offrir la possibilité d’y aller. Lorsque
l'acheteur clique sur Continuer, le numéro de transaction associé à la transaction est envoyé.
Le vendeur renvoie le numéro de transaction accompagné de son jeton d'identité et PayPal
envoie alors les informations de paiement sur site marchand confirmant la fin du paiement.
L'acheteur est redirigé vers le site marchand qui affiche les informations sur la transaction.
Toutefois, si l'acheteur ne clique pas sur Continuer, il n'est pas redirigé vers le site marchand
et le PDT n'est pas initié.
Guide d’intégration de la gestion des commandes Octobre 2006 25
Transfert des données de paiement
Synchroniser la notification PDT
Synchroniser la notification PDT
Après avoir activé le PDT, chaque fois qu'un acheteur effectue un paiement sur site marchand
et est redirigé vers votre URL de renvoi, un jeton de transaction est envoyé via une variable
FORM GET vers cette URL de renvoi.
Pour utiliser correctement le PDT et indiquer à l'acheteur le détail de la transaction, vous
devez relever le jeton de transaction dans la variable tx et extraire le détail de la transaction à
partir du site PayPal en construisant une commande HTTPS POST renvoyant vers PayPal.
Cette opération s'appelle synchronisation d'une notification ou synchronisation.
Construire la commande POST
Pour construire la commande HTTPS POST du PDT renvoyant vers PayPal afin de
synchroniser une notification, procédez de la manière suivante :
1. Votre commande POST doit être envoyée à
2. Vous devez inclure la valeur _notify-synch dans la variable cmd :
cmd=_notify-synch
3. Vous devez inclure le jeton de transaction dans la variable tx et la valeur du jeton de
transaction reçue via la commande GET de PayPal :
valeur_du_jeton_de_transaction
tx=
4. Vous devez publier votre jeton d'identité à l'aide de la variable at ainsi que la valeur de
votre jeton d'identité PDT :
votre_jeton_d'identité
at=
Pour en savoir plus sur le jeton d'identité, voir “Récupérer et utiliser le jeton d'identité” on
page 24.
Réponse de PayPal à la commande POST
PayPal répond à la commande POST par un seul mot sur une seule ligne dans le corps de la
réponse : SUCCESS (réussite) ou FAIL (échec). Lorsque vous recevez une réponse SUCCESS,
le reste du corps de la réponse contient le détail de la transaction (un détail par ligne) au format
clé=valeur où clé et valeur sont des chaînes codées au format URL (URL-encoded). Ces
données doivent être analysées correctement, puis décodées.
https://www.paypal.com/fr/cgi-bin/webscr.
Exemple de réussite :
SUCCESS
first_name=Jean+Paul
last_name=Leroy
payment_status=Completed
payer_email=jeanpaulleroy%40hotmail.com
payment_gross=3,99
26 Octobre 2006 Guide d’intégration de la gestion des commandes
Transfert des données de paiement
Prévention de la fraude
mc_currency=EUR
custom=Pour+l+achat+du+livre+Ravages
...
Si la réponse est FAIL, PayPal vous recommande de vérifier que :
z le jeton de transaction est correct ;
z le jeton d'identité est correct ;
z les jetons ne sont pas arrivés à expiration.
PDT et renvoi automatique : envoi d'un message à l'acheteur
Lorsque le renvoi automatique est activé, la page affichée par l'URL de renvoi doit contenir un
message indiquant à l'acheteur que le paiement est terminé, que la transaction a été effectuée et
que les détails de cette transaction lui seront envoyés par email. Vous pouvez indiquer à votre
client tous les détails du paiement qui vous semblent appropriés ; toutefois, PayPal vous
recommande d'inclure les éléments suivants :
z Nom de l'objet
z Montant payé
z Email du payeur
z Adresse de livraison
Si vous utilisez le PDT pour savoir quand honorer automatiquement une commande, vérifiez
que la variable payment_status est égale à Completed car l'acheteur peut utiliser des
modes de paiement qui ne sont pas immédiatement compensés, tels que les chèques
électroniques.
Pour consulter la liste des variables du PDT, reportez-vous à la section l’Annexe A,
« Variables IPN et PDT ».”
Prévention de la fraude
Pour prévenir la fraude, PayPal recommande que vos programmes vérifient les éléments
suivants :
z txn_id ne doit pas être un doublon pour éviter qu'une personne puisse réutiliser une
ancienne transaction terminée ;
z receiver_email doit être une adresse email enregistrée dans votre compte PayPal pour
éviter que le paiement soit envoyé vers un compte frauduleux ;
z d'autres détails sur la transaction, tels que le numéro et le prix de l'objet, pour vérifier qu'ils
n'ont pas été modifiés.
Guide d’intégration de la gestion des commandes Octobre 2006 27
Transfert des données de paiement
Echantillons de code
Echantillons de code
PayPal met à votre disposition des échantillons de code que vous pouvez utiliser pour
configurer le PDT. Ces échantillons de code sont disponibles à l'adresse
https://www.paypal.com/fr/cgi-bin/webscr?cmd=p/xcl/rec/pdt-code.
Ce sont des échantillons de code adaptés aux environnements de développement suivants :
z ASP/VBScript
z ColdFusion
z PERL
z PHP
28 Octobre 2006 Guide d’intégration de la gestion des commandes
Notification instantanée de
3
paiement (IPN)
La notification instantanée de paiement (IPN) vous permet d'intégrer les paiements PayPal au
traitement de vos commandes. La notification instantanée de paiement vous informe
immédiatement des paiements PayPal reçus.
Le présent chapitre se compose des sections suivantes :
z « A propos des IPN » page 29
z « Configuration de l'IPN » page 30
z « Validation d'une IPN Prévention de la fraude » page 32
z « Utilisation de l'IPN dans plusieurs devises » page 35
z « Notification d'un litige et Historique téléchargeable des litiges » page 38
A propos des IPN
La Notification instantanée de paiement (IPN) comprend trois étapes :
1. Un client vous règle.
2. PayPal publie (POST) les variables FORM sur une URL que vous avez spécifiée exécutant
un programme de traitement des variables.
3. Vous validez la notification.
Guide d’intégration de la gestion des commandes Octobre 2006 29
Loading...