How it Works
PAYPAL
Loading...
Sites Marchands - 2006
User Manual [fr]
140 pgs4.04 Mb0
Table of contents
Loading...

PAYPAL Sites Marchands - 2006, Sites Marchands - 2012 User Manual [fr]

Guide d’intégration de Paiements sur site marchand
© 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 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é :

Sommaire

Préface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
Public ciblé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Conventions typographiques. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Problèmes relatifs à la documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Premiers pas : Centre d’intégration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Historique des révisions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Chapitre 1 Présentation des Paiements sur site marchand . . . . . . .17
Exemple de séquence de base de pages . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Recevoir votre paiement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Méthodes de notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Historique des transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Historique téléchargeable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Notification instantanée de paiement (NIP) . . . . . . . . . . . . . . . . . . . . . . . 23
Comment utiliser ce guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Autres produits et fonctions standard . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Premiers pas : Centre d’intégration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Informations connexes en ligne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Documentation technique complémentaire . . . . . . . . . . . . . . . . . . . . . . . . . 26
Chapitre 2 Utiliser les préférences et outils de votre compte
marchand . . . . . . . . . . . . . . . . . . . . . . . . . .29
Récapitulatif des Préférences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Informations personnelles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Informations financières . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Préférences des ventes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Correspondance entre les Préférences et les variables HTML . . . . . . . . . . . . . 30
Conserver l’apparence de votre boutique sur les pages de paiement PayPal . . . . . . . . 31
Utiliser la Personnalisation des pages de paiement . . . . . . . . . . . . . . . . . . . 32
Ajouter ou modifier un style de page . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Définir un style de page comme style principal . . . . . . . . . . . . . . . . . . . . . 35
Remplacer le style de page pour certaines transactions . . . . . . . . . . . . . . . . 35
Guide d’intégration de Paiements sur site marchand Août 2006 3
Sommaire
Simplifier les achats avec les Préférences de réception de paiements sur le site . . . . . . 36
Compte PayPal facultatif. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Renvoi automatique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Calcul automatique des frais d’expédition et de traitement . . . . . . . . . . . . . . . 45
Bloquer certains types de paiement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Bloquer les paiements effectués dans une devise que vous ne détenez pas . . . . . . 48
Bloquer les paiements initiés à partir du sous-onglet Envoi de paiement . . . . . . . . 49
Bloquer les paiements approvisionnés par carte bancaire lorsque l’expéditeur
possède un compte bancaire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Bloquer les paiements approvisionnés par chèques électroniques . . . . . . . . . . . 49
Ajouter le nom figurant sur le relevé de carte bancaire . . . . . . . . . . . . . . . . . . . 50
Obtenir les numéros de téléphone à contacter auprès de vos clients . . . . . . . . . . . . 50
Activer le Numéro de téléphone à contacter. . . . . . . . . . . . . . . . . . . . . . . 51
Choix de la langue de vos données . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Changer votre choix de langue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Parcours dans vos Préférences : choix de la langue . . . . . . . . . . . . . . . . . . 52
Changer la langue de votre site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Autres options de codage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Paramétrer le choix de la langue pour chaque transaction . . . . . . . . . . . . . . . 54
Accès multi-utilisateur à votre compte PayPal . . . . . . . . . . . . . . . . . . . . . . . . 55
Devises acceptées par PayPal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Accepter ou rejeter les paiements multi-devises. . . . . . . . . . . . . . . . . . . . . . . 57
Gérer les soldes en devise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Chapitre 3 Payer un seul objet : Boutons Acheter maintenant
et Dons . . . . . . . . . . . . . . . . . . . . . . . . . . .59
Utiliser l’Assistant pour création de boutons Acheter maintenant ou Dons . . . . . . . . . 59
Ajouter d’autres informations à votre bouton . . . . . . . . . . . . . . . . . . . . . . 61
Copier/coller le code HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Echantillon de code HTML d’un bouton Acheter maintenant et d’un lien hypertexte . . . . 64
Chapitre 4 Payer plusieurs objets : le Panier . . . . . . . . . . . . . .67
Fonctionnement du panier hébergé par PayPal . . . . . . . . . . . . . . . . . . . . . . . 67
Ce qui apparaît à l’écran de votre client . . . . . . . . . . . . . . . . . . . . . . . . . 68
Assistant pour création de boutons pour le panier hébergé par PayPal . . . . . . . . . . . 73
Ajouter d’autres informations à votre bouton . . . . . . . . . . . . . . . . . . . . . . 74
Copier et coller le code HTML du panier . . . . . . . . . . . . . . . . . . . . . . . . 76
Exemple de code HTML pour le panier hébergé par PayPal . . . . . . . . . . . . . . . . 77
4 Août 2006 Guide d’intégration de Paiements sur site marchand
Fonctionnement du panier tiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Ce qui apparaît à l’écran de votre client . . . . . . . . . . . . . . . . . . . . . . . . . 78
Ce que vous voyez à l’écran. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Ajouter PayPal à votre panier tiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Variables de votre panier tiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Transmettre les informations relatives à chaque objet à PayPal . . . . . . . . . . . . 84
Appliquer la TVA au panier dans son ensemble . . . . . . . . . . . . . . . . . . . 85
Transmettre le montant total du panier à PayPal . . . . . . . . . . . . . . . . . . . . 86
Chapitre 5 Utiliser la fonction Autorisation et collecte avec
Paiements sur site marchand . . . . . . . . . . . . . . . .87
Procédure d’autorisation de base . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Période de validité du paiement et Période d’autorisation. . . . . . . . . . . . . . . . 88
Produits de paiement PayPal acceptés . . . . . . . . . . . . . . . . . . . . . . . . . 89
Scénarios de la fonction Autorisation et collecte de base . . . . . . . . . . . . . . . . . . 90
Collecter une autorisation unique . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Collecter par lots plusieurs autorisations . . . . . . . . . . . . . . . . . . . . . . . . 90
Annuler une autorisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Collecter dans les 3 jours . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Collecter entre le 4ème et 29ème jour. . . . . . . . . . . . . . . . . . . . . . . . . . 92
Une autorisation, plusieurs collectes et un remboursement . . . . . . . . . . . . . . . 93
Diminuer le montant collecté. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Collecter jusqu’à 115 % . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Expiration de l’autorisation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Annuler. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Tenter à nouveau une collecte. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Sommaire
Recommandations d’utilisation Autorisation et collecte . . . . . . . . . . . . . . . . . . . 99
Collecter des fonds faisant l’objet d’autorisations de base . . . . . . . . . . . . . . . 99
Approbation de l’acheteur pour les autorisations de base. . . . . . . . . . . . . . . . 99
Annuler les autorisations de base . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Chapitre 6 Effectuer des remboursements . . . . . . . . . . . . . . 101
Remboursement dans un délai de 60 jours à compter de la réception du paiement . . . .101
Remboursement après 60 jours . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102
Guide d’intégration de Paiements sur site marchand Août 2006 5
Sommaire
Chapitre 7 Paiements sur site marchand cryptés . . . . . . . . . . . 103
Conditions requises pour l’utilisation des Paiements sur site marchand cryptés . . . . . .104
Présentation du cryptage à clé publique . . . . . . . . . . . . . . . . . . . . . . . . . . .104
Configurer les certificats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104
Créer votre clé privée avec OpenSSL . . . . . . . . . . . . . . . . . . . . . . . . . .105
Créer votre certificat public avec OpenSSL . . . . . . . . . . . . . . . . . . . . . . .105
Télécharger le certificat public de PayPal . . . . . . . . . . . . . . . . . . . . . . . .106
Supprimer votre certificat public . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106
Crypter votre code HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107
Bloquer les Paiements sur site marchand non cryptés . . . . . . . . . . . . . . . . . . .108
Chapitre 8 Utiliser l’Environnement de test PayPal . . . . . . . . . . 109
Chapitre 9 Bases du code HTML FORM de Paiements sur
site marchand . . . . . . . . . . . . . . . . . . . . . . . 111
Attributs FORM : ACTION et METHOD . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Variables d’entrée cachées . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Spécifier le produit Paiements sur site marchand : cmd . . . . . . . . . . . . . . . . . . .112
Variantes des variables de base . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Inviter à saisir la quantité avec Acheter maintenant ou Dons : undefined_quantity . . .112
Tenue de compte avec variables de transit . . . . . . . . . . . . . . . . . . . . . . . 113
Définir le jeu de caractères : charset . . . . . . . . . . . . . . . . . . . . . . . . . .113
Définir l’URL de renvoi pour chaque transaction . . . . . . . . . . . . . . . . . . . .114
Devise souhaitée pour chaque transaction . . . . . . . . . . . . . . . . . . . . . . . 114
Valeurs des variables de codage URL. . . . . . . . . . . . . . . . . . . . . . . . . . 114
Pré-saisie des formulaires FORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Exemple de code HTML pour la pré-saisie des formulaires FORM . . . . . . . . . . . 115
Remplacer les adresses enregistrées auprès de PayPal . . . . . . . . . . . . . . . . . . 115
Exemple de code HTML de remplacement des adresses de livraison
enregistrées chez PayPal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Notification instantanée de paiement : notify_url. . . . . . . . . . . . . . . . . . . . . . . 116
Annexe A Variables HTML de Paiements sur site marchand . . . . . 119
Annexe B Codes pays . . . . . . . . . . . . . . . . . . . . . . . . 131
Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
6 Août 2006 Guide d’intégration de Paiements sur site marchand

Liste des tableaux

Tableau P.1 Historique des révisions . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Tableau 1.2 Comment utiliser ce guide . . . . . . . . . . . . . . . . . . . . . . . . . 24
Tableau 1.3 Liens hypertexte sur les tarifs, la sécurité, les Conditions d’utilisation,
les règlements, l’Aide en ligne et le Service clientèle . . . . . . . . . . . 25
Tableau 1.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Tableau 2.5 Ordre des variables de personnalisation . . . . . . . . . . . . . . . . . . 35
Tableau 2.6 Devises acceptées par PayPal, codes des devises et montants
maximum des transactions . . . . . . . . . . . . . . . . . . . . . . . . . 56
Tableau 4.7 Variables de votre panier tiers . . . . . . . . . . . . . . . . . . . . . . . 84
Tableau 5.8 Produits PayPal acceptant Autorisation et collecte . . . . . . . . . . . . 89
Tableau 7.9 Fonctionnement des paiements sur site marchand cryptés . . . . . . . .103
Tableau 7.10 Syntaxe pour la ligne de commande du logiciel PayPal de
Paiements sur site marchand cryptés . . . . . . . . . . . . . . . . . . .107
Tableau 7.11 Description des arguments pour les commandes de Paiements
sur site marchand cryptés . . . . . . . . . . . . . . . . . . . . . . . . .108
Tableau 9.12 Valeurs autorisées pour la variable cmd . . . . . . . . . . . . . . . . . .112
Tableau 9.13 Codages et jeux de caractères pris en charge par PayPal . . . . . . . . 113
Tableau A.14 Valeurs autorisées pour la variable cmd . . . . . . . . . . . . . . . . . . 119
Tableau A.15 Variables HTML : Contrôle de la notification instantanée de
paiement avec notify_url . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Tableau A.16 Variables HTML : Informations sur l’objet . . . . . . . . . . . . . . . . . 119
Tableau A.17 Variables HTML : informations sur l’affichage . . . . . . . . . . . . . . .121
Tableau A.18 Variables HTML : Informations sur la transaction . . . . . . . . . . . . .124
Tableau A.19 Variables HTML spécifiques aux paniers . . . . . . . . . . . . . . . . .126
Tableau A.20 Variables HTML : pour chaque objet des paniers tiers . . . . . . . . . . .126
Tableau A.21 Variables HTML : Pré-saisie des formulaires FORM PayPal ou
remplacement de l’adresse . . . . . . . . . . . . . . . . . . . . . . . .127
Tableau A.22 Variables HTML : Pré-saisie pour l’ouverture d’un compte Business . . .128
Guide d’intégration de Paiements sur site marchand Août 2006 7
Liste des tableaux
8 Août 2006 Guide d’intégration de Paiements sur site marchand

Liste des figures

Figure 1.1 Séquence de base de pages parcourues lors de
l’utilisation de Paiements sur site marchand . . . . . . . . . 17
Figure 1.2 Début de la séquence de base de pages sur votre site . . . . 18
Figure 1.3 Le client se connecte à PayPal . . . . . . . . . . . . . . . . 19
Figure 1.4 Le client vérifie les détails du paiement . . . . . . . . . . . 20
Figure 1.5 Confirmation du paiement ou page PayPal
« Votre paiement a été effectué » . . . . . . . . . . . . . . 21
Figure 1.6 Le client retourne sur votre site . . . . . . . . . . . . . . . 21
Figure 1.7 Historique du compte : Activité récente . . . . . . . . . . . 22
Figure 2.8 Récapitulatif des Préférences . . . . . . . . . . . . . . . . 29
Figure 2.9 Page de paiement non personnalisée avec le style de
page standard PayPal . . . . . . . . . . . . . . . . . . . . 31
Figure 2.10 Effectuer la personnalisation du style des pages
de paiement . . . . . . . . . . . . . . . . . . . . . . . . 32
Figure 2.11 Page Modifier un style de page . . . . . . . . . . . . . . . 33
Figure 2.12 Préférences de réception de paiements sur le site
à la page Récapitulatif des Préférences . . . . . . . . . . . . 36
Figure 2.13 Séquence de pages parcourues avec le
Compte PayPal facultatif . . . . . . . . . . . . . . . . . . 37
Figure 2.14 Page momentanée « Votre paiement a été effectué »
avec le Renvoi automatique activé . . . . . . . . . . . . . . 44
Figure 2.15 Préférences de réception de paiements . . . . . . . . . . . 48
Figure 2.16 Ajouter le nom figurant sur le relevé de carte bancaire . . . . 50
Figure 2.17 Inviter le client à saisir le Numéro de téléphone
à contacter . . . . . . . . . . . . . . . . . . . . . . . . . 51
Figure 2.18 Préférences du vendeur : choix de la langue . . . . . . . . . 52
Figure 2.19 Paramètres du Choix de la langue : choix de base . . . . . . 53
Figure 2.20 Préférence de langue du site . . . . . . . . . . . . . . . . 53
Figure 2.21 Autres options de codage de la langue . . . . . . . . . . . . 54
Figure 2.22 Lien Accès multi-utilisateur dans le récapitulatif des
Préférences . . . . . . . . . . . . . . . . . . . . . . . . 55
Figure 2.23 Accès multi-utilisateur : Ajouter un utilisateur . . . . . . . . 56
Figure 2.24 Accepter ou rejeter les paiements multi-devises. . . . . . . . 57
Figure 4.25 Exemple de panier hébergé par PayPal : Ajouter
au panier . . . . . . . . . . . . . . . . . . . . . . . . . 68
Guide d’intégration de Paiements sur site marchand Août 2006 9
Liste des figures
Figure 4.26 Exemple de panier hébergé par PayPal : sur le site
Figure 4.27 Exemple de panier hébergé par PayPal : saisie des
Figure 4.28 Exemple de panier hébergé par PayPal : page
Figure 4.29 Exemple de panier hébergé par PayPal : page de
Figure 4.30 Exemple de panier hébergé par PayPal : avis de réception
Figure 4.31 Exemple de panier tiers : Ajouter au panier . . . . . . . . . 78
Figure 4.32 Exemple de panier tiers : Passer au paiement . . . . . . . . 79
Figure 4.33 Exemple de panier tiers : Entrer les informations
Figure 4.34 Exemple de panier tiers : Page récapitulative . . . . . . . . . 81
Figure 4.35 Exemple de panier : page de remerciement après
Figure 4.36 Exemple : Avis de réception par email . . . . . . . . . . . . 83
de PayPal . . . . . . . . . . . . . . . . . . . . . . . . . 69
informations de facturation . . . . . . . . . . . . . . . . . 70
récapitulative . . . . . . . . . . . . . . . . . . . . . . . 71
remerciement après le paiement . . . . . . . . . . . . . . 72
par email . . . . . . . . . . . . . . . . . . . . . . . . . 73
de facturation ou se connecter à son compte PayPal . . . . . 80
le paiement . . . . . . . . . . . . . . . . . . . . . . . . 82
Figure 4.37 Exemple : Avis de réception par email du vendeur . . . . . . 83
Figure 5.38 Procédure Autorisation et collecte de base . . . . . . . . . . 88
Figure 5.39 Détails de la transaction : Terminée . . . . . . . . . . . . . 92
Figure 5.40 Détails de la transaction : nouvelle autorisation,
collecte finale . . . . . . . . . . . . . . . . . . . . . . . 93
Figure 5.41 Détails de la transaction : collecte partielle, nouvelle
autorisation, remboursement . . . . . . . . . . . . . . . . 94
Figure 5.42 Détails de la transaction : collecte partielle,
transaction annulée . . . . . . . . . . . . . . . . . . . . . 95
Figure 5.43 Détails de la transaction : Collecter jusqu’à 115 % . . . . . . 95
Figure 5.44 Détails de la transaction : autorisation expirée . . . . . . . . 96
Figure 5.45 Historique : transaction annulée . . . . . . . . . . . . . . . 97
Figure 5.46 Erreur lors de la collecte . . . . . . . . . . . . . . . . . . 98
Figure 7.47 Publier un certificat public pour les Paiements sur
site marchand cryptés . . . . . . . . . . . . . . . . . . . 105
Figure 7.48 Télécharger le certificat public de PayPal pour les
Paiements sur site marchand cryptés . . . . . . . . . . . . 106
Figure 9.49 Fonctionnement de la notification instantanée de paiement :
Trois étapes principales . . . . . . . . . . . . . . . . . . . 117
10 Août 2006 Guide d’intégration de Paiements sur site marchand

Liste des exemples

Exemple 2.1 Calcul de frais d’expédition et de livraison forfaitaires . . . . . . . . . . . 46
Exemple 2.2 Calcul des frais d’expédition et de livraison sous la forme
d’un pourcentage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Exemple 3.3 HTML pour bouton Acheter maintenant . . . . . . . . . . . . . . . . . . 64
Exemple 4.4 Code HTML du bouton Ajouter au panier d’un panier
hébergé par PayPal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Exemple 4.5 Code HTML pour transmettre les informations relatives à chaque objet
à PayPal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Exemple 4.6 Code HTML pour rassembler sous un panier global les informations
transmises à PayPal . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Exemple 9.7 Code HTML pour la pré-saisie des formulaires FORM . . . . . . . . . . .115
Exemple 9.8 Code HTML de remplacement d’une adresse enregistrée chez PayPal . .116
Guide d’intégration de Paiements sur site marchand Août 2006 11
Liste des exemples
12 Août 2006 Guide d’intégration de Paiements sur site marchand

Préface

P

Public ciblé

Ce document a été rédigé pour les marchands dont les sites utilisent les fonctions PayPal afin d’obtenir des paiements.

Conventions typographiques

Différents types de caractères sont utilisés dans ce document pour identifier les caractéristiques du texte. Ces types de caractères et leurs caractéristiques sont décrits ci-dessous :
Type de caractère
italique sérif Titre de document.
police à espacement constant
Utilisation
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.
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.
Guide d’intégration de Paiements sur site marchand Août 2006 13
Préface

Problèmes relatifs à la documentation

Type de caractère
gras sérif Noms d’interfaces utilisateur, tels que les noms de fenêtres ou les options de menus.
oblique san-sérif
Utilisation
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
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 découvrez des erreurs ou rencontrez des problèmes dans 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 d’assistance des développeurs au sujet des problèmes liés à la documentation :
1. Connectez-vous à votre compte à l’adresse adresse email et votre mot de passe dans la zone Connexion sécurisée.
2. Cliquez sur Aide en bas à droite de la page.
3. Cliquez sur Email PayPal Technical Support.
Complétez le formulaire.
https://developer.paypal.com/ en entrant votre
14 Août 2006 Guide d’intégration de Paiements sur site marchand

Premiers pas : Centre d’intégration

Le Centre d’intégration PayPal accessible sur https://www.paypal.com/integration vous guide pas à pas dans l’utilisation des kits PayPal pour développeurs (SDK), Paiements Express, Paiements Standard, Autorisation et collecte, de la Notification instantanée de Paiement et de bien d’autres fonctions encore.
Rendez-vous dans le Centre d’intégration sur :
https://www.paypal.com/integration

Historique des révisions

Historique des révisions du Guide d’intégration de Paiements sur site marchand.
TABLEAU P.1 Historique des révisions
Préface
Premiers pas : Centre d’intégration
Date Description
Août 2006 Nouvelle variable pour le panier PayPal : shopping_url
La valeur _ext-enter de la variable (FORM) n’est plus nécessaire.
Juillet 2006 Nouveau chapitre sur l’Autorisation et la collecte lors de l’utilisation de
Paiements sur site marchand, comprenant les autorisations pour les collectes par lots sur https://www.paypal.fr/
Mars 2006 Différentes corrections mineures.
Description plus détaillée de la création de boutons cryptés pour les Paiements sur site marchand.
. Différentes mises à jour.
cmd pour la pré-saisie du formulaire
Guide d’intégration de Paiements sur site marchand Août 2006 15
Préface
Historique des révisions
16 Août 2006 Guide d’intégration de Paiements sur site marchand
1

Présentation des Paiements sur site marchand

Le Guide d’intégration de Paiements sur site marchand décrit l’utilisation de Paiements sur site marchand. Paiements sur site marchand consiste en formulaires HTML (FORM) sur votre site qui renvoient le navigateur de votre client sur le site PayPal à l’adresse permettre de vous payer, puis le redirigent ensuite vers votre site. La Figure 1.1, « Séquence de base
de pages parcourues lors de l’utilisation de Paiements sur site marchand » illustre la séquence de
base de pages parcourues lorsqu’un client vous paie avec Paiements sur site marchand.
FIGURE 1.1 Séquence de base de pages parcourues lors de l’utilisation de Paiements
sur site marchand
http://www.paypal.fr pour lui
Toutes les fonctions de Paiements sur site marchand sont des variantes de cette séquence de base. Pour modifier cette séquence de base, vous pouvez utiliser les variables HTML FORM et les Préférences de votre compte PayPal.
Guide d’intégration de Paiements sur site marchand Août 2006 17
Présentation des Paiements sur site marchand

Exemple de séquence de base de pages

Voici un exemple de séquence de base de pages parcourues lors de l’utilisation de Paiements sur site marchand. Comme pour tous les exemples de pages de ce guide, celui-ci est basé sur une illustration d’intégration PayPal, indiquant comment PayPal a été intégré à une boutique en ligne fictive désignée sous le nom de « DesignerFotos ».
DEBUT. Le client choisit de payer avec PayPal sur votre site.
FIGURE 1.2 Début de la séquence de base de pages sur votre site
Cet exemple illustre l’utilisation de la fonction PayPal Acheter maintenant, présentée plus en détail au Chapitre 3, « Payer un seul objet : Boutons Acheter maintenant et Dons ».
18 Août 2006 Guide d’intégration de Paiements sur site marchand
Présentation des Paiements sur site marchand
Etape 1 : Le client se connecte à PayPal.
FIGURE 1.3 Le client se connecte à PayPal
Si le client ne détient pas de compte PayPal, il ou elle peut effectuer son paiement en cliquant sur le lien Cliquer ici
.
Guide d’intégration de Paiements sur site marchand Août 2006 19
Présentation des Paiements sur site marchand
Etape 2 : Sur cette page PayPal, le client vérifie les détails du paiement et effectue son paiement en cliquant sur Payer.
FIGURE 1.4 Le client vérifie les détails du paiement
A ce moment précis, le client peut choisir parmi les adresses de livraison associées à son compte PayPal. Cet exemple n’affiche pas les pages relatives à cette option.
20 Août 2006 Guide d’intégration de Paiements sur site marchand
Présentation des Paiements sur site marchand
Etape 3 : Le client obtient une page PayPal de confirmation du paiement et clique sur Retour chez le marchand.
FIGURE 1.5 Confirmation du paiement ou page PayPal « Votre paiement a été
effectué »
FIN. Le client est redirigé sur votre site.
FIGURE 1.6 Le client retourne sur votre site
Guide d’intégration de Paiements sur site marchand Août 2006 21
Présentation des Paiements sur site marchand

Recevoir votre paiement

Recevoir votre paiement
Une fois que votre client a effectué son paiement, votre compte PayPal répertorie ce paiement dans l’Historique, tel qu’indiqué ci-dessous.
FIGURE 1.7 Historique du compte : Activité récente

Méthodes de notification

Vous pouvez être notifié des paiements de quatre manières : par email, dans l’Historique, dans l’Historique téléchargeable et par la Notification instantanée de paiement (NIP).

Email

Vous recevez un email de notification dans les cas suivants :
z Paiement réussi z Paiement en attente z Paiement annulé
Si vous ne souhaitez pas recevoir de notification 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écochez la case Réception de paiement et règlement instantané sur le site PayPal.
4. Cliquez sur Enregistrer.
22 Août 2006 Guide d’intégration de Paiements sur site marchand

Historique des transactions

Votre historique des transactions (désigné sous le nom d’ « Historique ») fournit les informations liées à vos paiements. Chaque paiement peut présenter l’un des états suivants :
z Terminée : la transaction a réussi et l’argent a été crédité sur votre compte z Compensée : le paiement a compensé le compte de l’expéditeur et a été crédité sur
votre compte
z Non compensée : le paiement n’a pas encore compensé le compte de l’expéditeur

Historique téléchargeable

Vous pouvez télécharger des copies de l’historique de vos transactions sur votre ordinateur. Vous pouvez spécifier la période sur laquelle faire porter les transactions et le format du fichier à télécharger. Ce fichier contient la liste de vos transactions.
Pour en savoir plus sur l’Historique téléchargeable, consultez le Guide d’intégration de la gestion des commandes.
Présentation des Paiements sur site marchand

Comment utiliser ce guide

Notification instantanée de paiement (NIP)

La Notification instantanée de paiement vous permet de recevoir des informations sur les transactions. La NIP publie les informations liées aux différentes transactions sur une URL de votre site programmée pour traiter ces données entrantes. Pour utiliser la NIP, vous devez l’activer, car par défaut elle est désactivée.
Si la NIP est activée, vous recevrez une notification dans les cas suivants :
z un paiement a été envoyé, indiquant que le paiement est Terminé ou En attente ; z un paiement a été compensé, a échoué ou a été refusé dans le cas où il était en attente.
Pour en savoir plus sur la Notification instantanée de paiement (NIP), consultez la sectio
« Notification instantanée de paiement : notify_url » page 116 et le
gestion des commandes
.
Comment utiliser ce guide
Paiements sur site marchand comprend deux composants principaux : les boutons Acheter maintenant ou Dons et le Panier. Ces derniers sont conçus à partir du même ensemble de base de variables HTML FORM. Vous pouvez modifier leur comportement et apparence dans les Préférences de votre compte PayPal et en ajoutant des variables FORM.
n
Guide d’intégration de la
Le tableau suivant synthétise le contenu de ce guide.
Guide d’intégration de Paiements sur site marchand Août 2006 23
Présentation des Paiements sur site marchand
Comment utiliser ce guide
TABLEAU 1.2 Comment utiliser ce guide
Fonction Description Voir aussi
Acheter maintenant ou Dons Pour payer séparément des objets sur votre site.
Panier Pour payer plusieurs objets sur votre site. Il peut
prendre deux formes : un panier hébergé sur le site PayPal et des variables HTML utiliser dans votre propre panier.
Autorisation et collecte Permet d’autoriser un paiement et de le collecter
ultérieurement sur le site PayPal.
Personnaliser les pages de paiement
« Compte PayPal facultatif » ou Paiements express sur site marchand
Renvoi automatique Paramètre dans les Préférences de votre compte
Paramètres réglables dans les Préférences de votre compte qui vous permettent d’afficher les pages PayPal avec vos propres couleurs et images.
Paramètres dans les Préférences de votre compte qui permet à un client de vous payer par carte bancaire sans détenir de compte PayPal.
qui élimine la page PayPal d’avis de réception du paiement
Figure 1.1, « Séquence de base de
FORM à
pages parcourues lors de l’utilisation de Paiements sur site marchand »
.
Chapitre 3, « Payer un seul objet : Boutons Acheter maintenant et Dons »
Chapitre 4, « Payer plusieurs objets : le Panier »
Chapitre 5, « Utiliser la fonction Autorisation et collecte avec Paiements sur site marchand »
« Conserver l’apparence de votre boutique sur les pages de paiement PayPal » page 31
« Compte PayPal facultatif » page 37
« Renvoi automatique » page 43
Calcul automatique des frais d’expédition et de livraison, des frais de dossier et des taxes
Numéro de téléphone à contacter
Accès multi-utilisateur Paramètre dans les Préférences de votre compte
Paiements sur site marchand cryptés
24 Août 2006 Guide d’intégration de Paiements sur site marchand
Paramètre dans les Préférences de votre compte qui calcule pour vous les frais d’expédition et de livraison, les frais de dossier et les taxes.
Paramètre dans les Préférences de votre compte qui vous envoie le numéro de téléphone à contacter auprès de votre client.
qui permet de partager l’accès à votre compte Business avec plusieurs adresses email (jusqu’à sept).
Permet de crypter les informations de paiement avant de les envoyer à PayPal pour protéger les données de votre client.
« Calcul automatique des frais d’expédition et de traitement » page 45
« Obtenir les numéros de téléphone à contacter auprès de vos clients » page 50
« Accès multi-utilisateur à votre compte PayPal » page 55
Chapitre 7, « Paiements sur site marchand cryptés »
Présentation des Paiements sur site marchand

Autres produits et fonctions standard

Paiements sur site marchand comprend également d’autres produits et fonctions non détaillés dans ce guide :
z La Notification instantanée de paiement (NIP) et le Transfert des données de paiement
(TDP) sont des systèmes basés sur les variables HTML FORM permettant d’envoyer des informations sur les paiements aux programmes de votre site. NIP et TDP sont décrits dans le Guide d’intégration sur la gestion des commandes.
z La fonction Abonnements et paiements récurrents, décrite dans le Guide d’utilisation
d’Abonnements et paiements récurrents.

Premiers pas : Centre d’intégration

Le Centre d’intégration PayPal accessible sur https://www.paypal.com/integration vous guide pas à pas dans l’utilisation des kits de développement PayPal (SDK), Paiements Express, Paiements Standard, Autorisation et collecte, de la Notification Instantanée de Paiement et de bien d’autres fonctions encore.
Premiers pas : Centre d’intégration
Rendez-vous dans le Centre d’intégration sur :
https://www.paypal.com/integration

Informations connexes en ligne

Pour en savoir plus sur les tarifs PayPal, la sécurité en ligne, les Conditions d’utilisation et les règlements associés, l’Aide en ligne et le Service clientèle, rendez-vous sur les URL ci-dessous :
TABLEAU 1.3 Liens hypertexte sur les tarifs, la sécurité, les Conditions d’utilisation,
les règlements, l’Aide en ligne et le Service clientèle
Informations URL
Tarifs https://www.paypal.com/fr/fees
Sécurité en ligne https://www.paypal.com/fr/security
Conditions d’utilisation et règlements
Aide en ligne https://www.paypal.com/fr/help
https://www.paypal.com/fr/cgi-bin/webscr?cmd=p/gen/ua/ua-outside
Service clientèle https://www.paypal.com/fr/wf
Guide d’intégration de Paiements sur site marchand Août 2006 25
Présentation des Paiements sur site marchand

Documentation technique complémentaire

Documentation technique complémentaire
Cette liste répertorie toute la documentation technique PayPal. La description de chaque guide indique le sujet et la documentation à lire au préalable pour utiliser le guide en question de manière efficace.
Documentation technique PayPal
T
ABLEAU 1.4
Titre du guide Description A lire au préalable
Guide d’intégration de Paiements express PayPal
Guide d’intégration de la gestion des commandes
Guide d’utilisation du kit de développement PayPal Java
Guide d’utilisation du kit de développement PayPal .NET
Guide d’utilisation du kit de développement PayPal ASP classique
Guide d’utilisation du kit de développement PayPal PHP
Détaille l’utilisation de l’API Paiement express PayPal Positionnement de PayPal sur les sites marchands et règles métier associées.
https://www.paypal.com/fr_FR/FR/pdf/PP_ExpressCheckout_Integr ationGuide.pdf
Détaille la Notification instantanée de paiement (NIP) et le Transfert des données de paiement (TDP) pour la réception automatique des informations de paiement une fois le paiement effectué. Détaille les variables HTML également des informations relatives à l’Historique téléchargeable.
https://www.paypal.com/fr_FR/FR/pdf/PP_OrderManagement_Integ rationGuide.pdf
Détaille l’utilisation des kits de développement PayPal Java, Microsoft .NET, Microsoft Classic ASP et PHP afin de simplifier l’emploi des services Web PayPal.
https://www.paypal.com/fr_FR/FR/pdf/PP_SDK_Java_Guide.pdf
https://www.paypal.com/fr_FR/FR/pdf/PP_SDK_NET_Guide.pdf
https://www.paypal.com/fr_FR/FR/pdf/PP_SDK_ClassicASP_Guide.pdf
https://www.paypal.com/fr_FR/FR/pdf/PP_SDK_PHP_Guide.pdf
FORM de la NIP et leur signification. Comprend
Guide d’intégration de Paiements sur site marchand
Guide d’intégration de Paiements sur site marchand
Guide d’intégration de Paiements sur site marchand
Guide d’intégration d’Autorisation et collecte
Guide d’utilisation de l’Environnement de test
Guide de référence des API
Guide d’utilisation de l’Environnement de test
26 Août 2006 Guide d’intégration de Paiements sur site marchand
Décrit l’Environnement de test de PayPal pour vérifier le fonctionnement des API Paiements sur site marchands et services Web. Détaille la procédure de récupération de certificats numériques pour API PayPal.
https://www.paypal.com/fr_FR/FR/pdf/PP_Sandbox_UserGuide.pdf
Tous les autres guides PayPal pour une bonne compréhension du produit.
Présentation des Paiements sur site marchand
Documentation technique complémentaire
T
ABLEAU 1.4
Titre du guide Description A lire au préalable
Guide de référence des API
Guide d’utilisation des Abonnements et paiements récurrents
Description des champs de toutes les API PayPal, de leur structure SOAP et des messages d’erreur éventuels. Emplacement des fichiers PayPal WSDL et XSD.
https://www.paypal.com/fr_FR/FR/pdf/PP_APIReference.pdf
Décrit les variables HTML PayPal pour le paiement d’abonnements à des biens et services.
https://www.paypal.com/fr_FR/FR/pdf/subscriptions.pdf
FORM nécessaires à l’utilisation de
N/A
Guide d’intégration de Paiements sur site marchand
Guide d’intégration de Paiements sur site marchand Août 2006 27
Présentation des Paiements sur site marchand
Documentation technique complémentaire
28 Août 2006 Guide d’intégration de Paiements sur site marchand
Utiliser les préférences et outils
2
de votre compte marchand
Ce chapitre détaille l’utilisation des Préférences de votre compte et autres outils sur le site PayPal ayant un impact sur la procédure de paiement.

Récapitulatif des Préférences

Utilisez les Préférences de votre compte PayPal pour en gérer le paramétrage. Pour accéder à vos Préférences, connectez-vous à votre compte PayPal et cliquez sur le sous-onglet Préférences de l’onglet Mon compte. Les Préférences comprennent trois sections : Informations personnelles, Informations financières et Préférences des ventes.
FIGURE 2.8 Récapitulatif des Préférences

Informations personnelles

Utilisez la colonne Informations personnelles pour effectuer la maintenance ordinaire de votre compte, consistant par exemple à mettre à jour votre mot de passe, à ajouter et confirmer une ou plusieurs adresses email ou à gérer vos informations professionnelles et (pour les comptes Business) à configurer l’accès multi-utilisateur à votre compte PayPal.
Guide d’intégration de Paiements sur site marchand Août 2006 29
Utiliser les préférences et outils de votre compte marchand
Récapitulatif des Préférences

Informations financières

La colonne Informations financières vous permet d’organiser et de gérer l’ensemble des instruments financiers associés à votre compte PayPal : vous pouvez gérer vos cartes et comptes bancaires, maintenir les soldes en plusieurs devises et visualiser vos relevés de compte mensuels.

Préférences des ventes

Utilisez la colonne Préférences des ventes pour organiser vos ventes via votre compte PayPal de la manière suivante :
z conserver l’apparence de votre boutique sur les pages de paiement PayPal ; z accélérer les achats grâce aux Préférences de Paiements sur site marchand :
– Compte PayPal facultatif – Renvoi automatique – Calcul automatique des frais d’expédition et de livraison, des frais de dossier et des taxes
z établir des préférences pour la réception de paiement permettant de bloquer certains types
de paiement ;
z récupérer les numéros de téléphone à contacter chez les clients ; z choisir utilisée la langue pour le codage de vos données.
La plus grande partie de ce chapitre porte sur les Préférences des ventes.

Correspondance entre les Préférences et les variables HTML

De nombreux paramètres réglables dans les Préférences ont une variable HTML FORM équivalente permettant de contrôler le comportement des différentes transactions. Une fois que vous avez activé un paramètre dans vos Préférences, vous pouvez inclure des variables FORM dans une transaction pour lui appliquer ce paramètre. Pour en savoir plus, reportez-vous aux sections suivantes :
z « Remplacer le style de page pour certaines transactions » page 35 z « Annuler le paramètre de taxe pour chaque transaction » page 46 z « Annuler le paramètre de calcul des frais d’expédition et de livraison pour chaque
transaction » page 47
z « Définir le jeu de caractères : charset » page 113 z « Définir l’URL de renvoi pour chaque transaction » page 114 z « Devise souhaitée pour chaque transaction » page 114
30 Août 2006 Guide d’intégration de Paiements sur site marchand
Loading...
+ 110 hidden pages
Buy Points How it Works FAQ Contact Us Questions and Suggestions Privacy Policy Cookie Policy Terms of Use