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
Utiliser les préférences et outils de votre compte marchand

Conserver l’apparence de votre boutique sur les pages de paiement PayPal

Conserver l’apparence de votre boutique sur les pages de paiement PayPal
Grâce à notre fonction Personnalisation des pages de paiement, vous pouvez personnaliser vos pages de paiement PayPal pour les adapter au style de votre site. La Personnalisation des pages de paiement s’applique à tous les boutons de Paiements sur site marchand PayPal et à la fonction Compte PayPal facultatif.
Vous pouvez ajouter jusqu’à 3 styles de page personnalisées. Les images de cette section illustrent les types de personnalisation que vous pouvez
ajouter à vos boutons de paiement sur site marchand. La Figure 2.9, « Page de paiement non
personnalisée avec le style de page standard PayPal », montre une page de paiement sans
aucune personnalisation.
FIGURE 2.9 Page de paiement non personnalisée avec le style de page standard
PayPal
La Figure 2.10, « Effectuer la personnalisation du style des pages de paiement », indique tous les types de personnalisation que vous pouvez effectuer.
Guide d’intégration de Paiements sur site marchand Août 2006 31
Utiliser les préférences et outils de votre compte marchand
Conserver l’apparence de votre boutique sur les pages de paiement PayPal
FIGURE 2.10 Effectuer la personnalisation du style des pages de paiement

Utiliser la Personnalisation des pages de paiement

1. Connectez-vous à votre compte PayPal à l’adresse https://www.paypal.fr.
2. Cliquez sur le sous-onglet Préférences.
3. Dans la colonne Préférences des ventes, cliquez sur Personnalisation des pages de paiement.
La page de personnalisation présentée à la Figure 2.11, « Page Modifier un style de page », apparaît.
32 Août 2006 Guide d’intégration de Paiements sur site marchand
Utiliser les préférences et outils de votre compte marchand
Conserver l’apparence de votre boutique sur les pages de paiement PayPal
FIGURE 2.11 Page Modifier un style de page
A partir de cette page, vous pouvez ajouter, modifier, prévisualiser et supprimer des styles de page, mais aussi définir n’importe quel style de page comme style principal.

Ajouter ou modifier un style de page

Les paramètres décrits dans cette section peuvent également être définis à partir des variables HTML d’entrée FORM définies au moment de la transaction. Pour en savoir plus, reportez-vous au Tableau A.17, « Variables HTML : informations sur l’affichage » page 121.
Pour ajouter un style de page :
1. Commencez à la page Personnalisation des pages de paiement.
2. Cliquez sur Ajouter ou Modifier.
Guide d’intégration de Paiements sur site marchand Août 2006 33
Utiliser les préférences et outils de votre compte marchand
Conserver l’apparence de votre boutique sur les pages de paiement PayPal
3. Entrez vos préférences de style de page :
Nom du style de page (obligatoire)
Entrez un nom n’excédant pas 30 caractères. Ce nom peut contenir des lettres, des chiffres et des tirets bas, mais aucun autre symbole ni espace. Le nom du style de page sera utilisé pour faire référence au style de la page sur votre compte PayPal et dans la variable site marchand.
URL de l’image d’en-tête (facultative)
Entrez l’URL de l’image que vous souhaitez voir apparaître en haut à gauche de la page de paiement. La taille maximale de l’image est de 750 pixels de large et 90 pixels de haut ; les images plus grandes sont réduites à cette taille. L’image doit avoir un format graphique correct tel que gif, jpg, ou png.
IMPORTANT :PayPal recommande d’entrer une URL d’image uniquement si celle-ci est
Couleur d’arrière-plan de l’en-tête (facultative)
Entrez la couleur d’arrière-plan de l’en-tête en code hexadécimal HTML. Le code couleur doit être composé de six chiffres et ne doit pas comporter le symbole #. Si l’URL de l’image d’en-tête est présente, l’en-tête est constitué d’un espace de 750 pixels de large sur 90 pixels de haut situé en haut de la page de paiement. Si l’URL de l’image d’en-tête n’est pas présente, la taille de l’en-tête sera réduite à 45 pixels de haut.
Couleur de bordure de l’en-tête (facultative)
Entrez la couleur de bordure de l’en-tête en code hexadécimal HTML. Le code couleur doit être composé de six chiffres et ne doit pas comporter le symbole #. La bordure est un périmètre de deux pixels autour de l’espace d’en-tête.
Couleur d’arrière-plan (facultative)
Entrez la couleur d’arrière-plan de la page de paiement en code hexadécimal HTML. Le code couleur doit être composé de six chiffres et ne doit pas comporter le symbole #.
page_style de votre formulaire HTML pour votre bouton de Paiement sur
stockée sur un serveur sécurisé (https). Dans le cas contraire, le navigateur Internet de votre client affiche un message indiquant que la page de paiement contient des éléments non sécurisés.
4. Cliquez sur Prévisualiser pour prévisualiser votre style de page ou sur Enregistrer pour l’enregistrer.
Couleurs non autorisées
Etant donné que le système de messages d’erreur PayPal surligne les erreurs en rouge, PayPal n’autorise pas certaines couleurs d’arrière-plan qui rendraient ces messages illisibles.
S’il est possible de prévisualiser la page de paiement avec la couleur d’arrière-plan choisie, elle est autorisée. Si vous recevez un message d’erreur relatif à la couleur d’arrière-plan, cela signifie que cette couleur n’est pas autorisée.
A propos de la couleur des polices
PayPal change la couleur de la police du noir au blanc de façon dynamique en fonction de la couleur d’arrière-plan. Pour vous assurer que ces changements respectent vos choix de couleur de police, vous devez tester vos paramètres de couleur dans PayPal.
34 Août 2006 Guide d’intégration de Paiements sur site marchand
Utiliser les préférences et outils de votre compte marchand
Conserver l’apparence de votre boutique sur les pages de paiement PayPal

Définir un style de page comme style principal

Lorsque vous choisissez un style de page pour en faire le style principal, il est appliqué à toutes vos pages de paiement, sauf indication contraire de votre part.
REMARQUE : Si vous ne désignez aucun style de page par défaut, le style de page PayPal
est utilisé.
Pour définir un style de page comme style principal :
1. Commencez à la page Personnalisation des pages de paiement Figure 2.11, « Page
Modifier un style de page » page 33.
2. Cliquez sur le bouton radio situé à côté du style de page que vous souhaitez définir comme style principal.
3. Cliquez sur Par défaut.
4. Cliquez sur Par défaut pour confirmer votre choix.

Remplacer le style de page pour certaines transactions

Votre style de page principal s’applique à toutes les pages de paiement, sauf spécification contraire de votre part. Vous pouvez remplacer ce style en spécifiant des variables de style de page personnalisées pour certaines transactions.
Pour modifier le style de page d’un bouton déjà créé, remplacez la valeur de la variable page_style par le nom du style de page que vous souhaitez utiliser. Lors du prochain clic sur le bouton, les pages de paiement associées s’afficheront dans le nouveau style.
Lorsque vous spécifiez des variables de personnalisation des pages de paiement pour certaines transactions, ces variables priment sur le style défini dans vos Préférences ou sur la variable page_style. Les variables de personnalisation s’appliquent dans l’ordre ci-après :
TABLEAU 2.5 Ordre des variables de personnalisation
Option de personnalisation Description
1 Variables de personnalisation des pages
de paiement pour chaque transaction
2 Style de page principal pour certaines
transactions
3 Style de page principal dans les
Préférences
Reportez-vous au
Tableau A.17, « Variables
HTML : informations sur l’affichage » page 121
Avec la variable page_style variable, vous pouvez spécifier un style de page pour chaque transaction et qui prévaudra sur les styles de page définis dans vos Préférences.
Il est possible de créer et de définir le style de page principal dans vos Préférences.
.
4 Style de page PayPal par défaut dans les
Préférences
Guide d’intégration de Paiements sur site marchand Août 2006 35
Le style de page par défaut est utilisé lorsqu’aucun autre style n’est sélectionné et désigné comme principal.
Utiliser les préférences et outils de votre compte marchand

Simplifier les achats avec les Préférences de réception de paiements sur le site

Simplifier les achats avec les Préférences de réception de paiements sur le site
Vous pouvez accélérer les achats de vos clients à l’aide de trois paramètres dans vos Préférences :
z Compte PayPal facultatif z Renvoi automatique z Calcul automatique des frais d’expédition et de traitement
Ces paramètres sont réglables dans les Préférences de réception de paiements sur le site sous l’onglet Préférences, dans la colonne Préférences des ventes.
FIGURE 2.12 Préférences de réception de paiements sur le site à la page Récapitulatif
des Préférences
36 Août 2006 Guide d’intégration de Paiements sur site marchand
Simplifier les achats avec les Préférences de réception de paiements sur le site

Compte PayPal facultatif

Compte PayPal facultatif est un paramètre des Préférences permettant aux clients qui ne connaissent pas PayPal de vous régler par carte bancaire sans ouvrir de compte PayPal, ce qui représente un moindre effort et un gain de temps.
Les détenteurs de compte PayPal parcourent la même séquence de pages des Paiements sur site marchand indiquée à la Figure 1.1, « Séquence de base de pages parcourues lors de
l’utilisation de Paiements sur site marchand » page 17. Les clients qui ne connaissent pas
PayPal parcourent une séquence de pages qui n’exige pas l’ouverture de compte PayPal, avec la possibilité d’ouvrir un compte une fois le paiement effectué.
FIGURE 2.13 Séquence de pages parcourues avec le Compte PayPal facultatif
Utiliser les préférences et outils de votre compte marchand
Guide d’intégration de Paiements sur site marchand Août 2006 37
Utiliser les préférences et outils de votre compte marchand
Simplifier les achats avec les Préférences de réception de paiements sur le site
Activer/Désactiver le Compte PayPal facultatif
1. Connectez-vous à votre compte PayPal à l’adresse https://www.paypal.fr.
2. Cliquez sur le sous-onglet Préférences.
3. Cliquez sur le lien Préférences de réception de paiements sur le site dans la colonne Préférences des ventes. Reportez-vous à la Figure 2.12, « Préférences de réception de
paiements sur le site à la page Récapitulatif des Préférences » page 36.
4. Faites défiler la page jusqu’à la section Compte PayPal facultatif.
5. Sélectionnez Oui pour activer le Compte PayPal facultatif ou sur Non pour le désactiver et
utiliser la procédure de Paiements sur site marchand classique.
6. Cliquez sur Enregistrer pour enregistrer vos préférences.
Parcours de votre client lorsque vous avez activé le Compte PayPal facultatif
Etape 1 : Jean se rend sur le site de DesignerFotos et clique sur Acheter maintenant.
38 Août 2006 Guide d’intégration de Paiements sur site marchand
Utiliser les préférences et outils de votre compte marchand
Simplifier les achats avec les Préférences de réception de paiements sur le site
Etape 2 : Comme Jean ne connaît pas PayPal, il est renvoyé sur une page d’informations sur la facturation. S’il avait un compte PayPal, il pourrait s’y connecter à ce moment-là pour accéder aux informations déjà enregistrées. Comme il n’est pas utilisateur PayPal, il passe la section Paiement PayPal, saisit ses informations et clique sur Continuer.
Guide d’intégration de Paiements sur site marchand Août 2006 39
Utiliser les préférences et outils de votre compte marchand
Simplifier les achats avec les Préférences de réception de paiements sur le site
Etape 3 : Jean est invité à entrer les informations sur la livraison de son achat.
Jean clique sur Continuer et est renvoyé sur la page indiquée à l’Etape 4.
REMARQUE : Si vos Préférences de réception de paiements sont définies de façon à n’accepter
que les paiements provenant de clients dont l’adresse a été confirmée, l’acheteur ne voit pas cet écran d’informations sur la livraison et passe directement aux informations relatives à la facturation décrites à l’Etape 4.
40 Août 2006 Guide d’intégration de Paiements sur site marchand
Utiliser les préférences et outils de votre compte marchand
Simplifier les achats avec les Préférences de réception de paiements sur le site
Etape 4 : Jean est renvoyé sur une page de vérification des informations qu’il a saisies. Il clique sur Payer pour effectuer son achat.
Guide d’intégration de Paiements sur site marchand Août 2006 41
Utiliser les préférences et outils de votre compte marchand
Simplifier les achats avec les Préférences de réception de paiements sur le site
Etape 5 : Jean est dirigé vers une page de fin de paiement et reçoit par email un avis de réception.
Etant donné que Jean n’est pas utilisateur PayPal, il peut choisir d’ouvrir un compte PayPal sur cette page en saisissant son adresse email, en sélectionnant un mot de passe, puis en cliquant sur Ouvrir un compte.
Etape 6 : Une page s’affiche confirmant à Jean la création de son compte.
42 Août 2006 Guide d’intégration de Paiements sur site marchand
Utiliser les préférences et outils de votre compte marchand
Simplifier les achats avec les Préférences de réception de paiements sur le site
S’il clique sur Retour chez le marchand, il est redirigé sur le site du marchand. Etape 7 : Jean reçoit un avis de réception par email relatif à cette transaction, confirmant
son paiement et comprenant une copie des détails du paiement pour cette transaction.

Renvoi automatique

Avec le Renvoi automatique pour les paiements sur site marchand, vous pouvez éviter à vos clients de cliquer sur un bouton supplémentaire avant de revenir à votre site, une fois le paiement effectué. Le renvoi automatique s’applique à tous les paiements sur site marchand, y compris aux fonctions Acheter maintenant, Dons, Panier et Abonnements.
Parcours de votre client lorsque vous avez activé le Renvoi automatique
Avec le Renvoi automatique activé, au lieu de cliquer sur un bouton dans la page Vo tr e paiement a été effectué (qui correspond au numéro 3 de la Figure 1.1 et est également
illustrée à la Figure 1.5), le client obtient une page de confirmation de paiement pendant quelques secondes avant d’être redirigé votre site, tel qu’indiqué à la Figure 2.14, « Page
momentanée « Votre paiement a été effectué » avec le Renvoi automatique activé ».
Guide d’intégration de Paiements sur site marchand Août 2006 43
Utiliser les préférences et outils de votre compte marchand
Simplifier les achats avec les Préférences de réception de paiements sur le site
FIGURE 2.14 Page momentanée « Votre paiement a été effectué » avec le Renvoi
automatique activé
Activer le Renvoi automatique
Pour activer le Renvoi automatique :
1. Connectez-vous à votre compte PayPal à l’adresse https://www.paypal.fr
.
2. Cliquez sur le sous-onglet Préférences.
3. Dans la colonne Préférences des ventes, cliquez sur Préférences de réception de paiements sur le site. Reportez-vous à la Figure 2.12, « Préférences de réception de
paiements sur le site à la page Récapitulatif des Préférences » page 36.
4. Sous Renvoi automatique pour les paiements sur site marchand, cliquez sur le bouton radio Oui pour activer le renvoi automatique.
44 Août 2006 Guide d’intégration de Paiements sur site marchand
Utiliser les préférences et outils de votre compte marchand
Simplifier les achats avec les Préférences de réception de paiements sur le site
5. Dans le champ de l’URL de renvoi, entrez l’URL vers laquelle vous souhaitez rediriger vos acheteurs une fois leur paiement effectué.
REMARQUE : Si l’URL de renvoi indiquée n’est pas correcte, PayPal affiche la page Vot re
paiement a été effectué une fois le paiement effectué.
6. Cliquez sur Enregistrer.
Paramétrer l’URL de renvoi pour chaque transaction
Lorsque le Renvoi automatique est activé dans vos Préférences, vous pouvez définir la valeur de l’URL de renvoi pour chaque transaction, remplaçant la valeur enregistrée pour votre compte PayPal. Par exemple, si vous souhaitez rediriger le navigateur d’un client vers une URL de votre site spécifique à ce client, vous pouvez utiliser un identifiant de session ou d’autres données liées à une transaction dans l’URL.
Afin de définir l’URL de renvoi pour une transaction donnée, incluez la variable return dans le formulaire HTML FORM :
<INPUT TYPE=”hidden” NAME=”return” value=”URLspecificToThisTransaction”>
Gestion des mots de passe d’abonnements et renvoi automatique
Si vous utilisez la gestion des mots de passe d’abonnements ou si vous envisagez de l’utiliser, il vous faut désactiver le renvoi automatique pour afficher l’identifiant et le mot de passe générés par PayPal pour l’acheteur.
REMARQUE : Vous pouvez utiliser le renvoi automatique avec inscription, qui constitue une
fonction distincte de la Gestion des mots de passe d’abonnements. Pour en savoir plus sur les abonnements, consultez le Guide d’utilisation des Abonnements et paiements récurrents, disponible sur le site PayPal.

Calcul automatique des frais d’expédition et de traitement

Vous pouvez configurer votre compte PayPal pour calculer et imputer automatiquement les frais d’expédition et de livraison et la TVA (Taxe sur la Valeur Ajoutée).
Vous pouvez définir votre compte PayPal de sorte qu’il calcule et impute automatiquement les frais d’expédition et de livraison.
Pour afficher et/ou modifier les frais d’expédition et de livraison ou la TVA :
1. Connectez-vous à votre compte PayPal à l’adresse https://www.paypal.fr
2. Cliquez sur le sous-onglet Préférences de l’onglet Mon compte.
3. Dans la colonne Préférences des ventes, cliquez sur Tax es /T VA ou frais d’expédition et de livraison.
.
Guide d’intégration de Paiements sur site marchand Août 2006 45
Utiliser les préférences et outils de votre compte marchand
Simplifier les achats avec les Préférences de réception de paiements sur le site
Collecte de la TVA
Pour appliquer la TVA à vos clients, choisissez un Pays ou un Etat dans les menus déroulants, puis entrez le taux de TVA applicable dans le champ prévu à cet effet. Chacun des clients résidant dans le pays ou l’état sélectionné se verra automatiquement appliquer le taux de TVA choisi.
Les boutons radio vous permettent de taxer un objet uniquement, ou de lui appliquer une taxe ainsi que des frais d’expédition et de traitement.
Cliquez sur Enregistrer pour enregistrer vos modifications.
Annuler le paramètre de taxe pour chaque transaction
Quel que soit le lieu de résidence du client, vous pouvez définir un montant forfaitaire sur chaque transaction ou objet de la transaction. Pour en savoir plus, reportez-vous à la section
« Appliquer la TVA au panier dans son ensemble » page 85.
Calcul des frais d’expédition et de livraison
Indiquez si vous souhaitez imputer des frais d’expédition et de livraison forfaitaires ou un pourcentage du montant total des achats.
Montant forfaitaire. Un montant forfaitaire est calculé en fonction du sous-total de l’achat.
Cliquez sur le bouton radio Montant forfaitaire (accompagné du symbole €) et entrez un montant forfaitaire pour chaque montant incrémentiel. Cliquez sur Enregistrer pour enregistrer vos modifications.
EXEMPLE 2.1 Calcul de frais d’expédition et de livraison forfaitaires
Supposons que le montant forfaitaire soit le suivant : De €0,00 EUR à €49,99 EUR= €3 EUR €50.00+ = €6.00 Si le sous-total est de €36,50 EUR, votre client est débité €3,00 EUR pour l’expédition et
la livraison et le montant total de son achat est de €39,50. Si le sous-total est de €66,50 EUR, votre client est débité €6,00 EUR pour l’expédition et
la livraison et le montant total de son achat est de €72,50.
46 Août 2006 Guide d’intégration de Paiements sur site marchand
Utiliser les préférences et outils de votre compte marchand
Simplifier les achats avec les Préférences de réception de paiements sur le site
Pourcentage. Le pourcentage est calculé en fonction du sous-total de l’achat. Cliquez sur
le bouton radio Pourcentage (accompagné du signe %) et entrez un pourcentage pour chaque montant incrémentiel. Cliquez sur Enregistrer pour enregistrer vos modifications.
EXEMPLE 2.2 Calcul des frais d’expédition et de livraison sous la forme d’un
pourcentage
Supposons que le paramètre de pourcentage soit réglé comme suit : De €0,00 EUR à €49,99 EUR = 5 % €50.00+ = 4% Si le sous-total est de €36,50,LEUR, votre client est débité 5% x €36,50 = €1,83 EUR pour
l’expédition et la livraison et le montant total de son achat est de €38,33. Si le sous-total est de €66,LEUR, votre client est débité 4% x €66,50 = €2,66 EUR pour
l’expédition et la livraison et le montant total de son achat est de €69,16.
Annuler le paramètre de calcul des frais d’expédition et de livraison pour chaque transaction
Vous souhaiterez peut-être définir des frais d’expédition et de livraison propres à un objet (par exemple, pour un objet particulièrement lourd, dont la livraison est plus onéreuse, ou pour un service, qui n’implique aucun frais d’expédition et de livraison). Pour facturer des frais d’expédition et de livraison différents pour un objet, incluez ces frais dans le formulaire HTML FORM du bouton à l’aide des variables shipping et handling_cart.
Vous devez spécifier dans vos Préférences que les paramètres spécifiques à chaque transaction remplacent les paramètres de calcul des frais d’expédition et de livraison définis au départ :
1. Accédez à la page calcul des frais d’expédition et de livraison dans vos Préférences.
2. Cochez la case Cliquez ici pour autoriser le remplacement des paramètres des Préférences répertoriées ci-dessus par les valeurs de livraison correspondant aux transactions (si les paramètres en question sont activés dans les Préférences).
3. Cliquez sur Enregistrer.
Guide d’intégration de Paiements sur site marchand Août 2006 47
Utiliser les préférences et outils de votre compte marchand

Bloquer certains types de paiement

Bloquer certains types de paiement
Les Préférences de réception de paiements vous permettent de bloquer les types de paiements reçus.
FIGURE 2.15 Préférences de réception de paiements

Bloquer les paiements effectués dans une devise que vous ne détenez pas

Lorsque vous recevez un paiement dans une devise que vous ne détenez pas, PayPal vous invite à ouvrir un solde dans cette devise, à la convertir dans la devise de votre compte principal ou à refuser le paiement. Les paiements effectués dans des devises pour lesquelles vous avez déjà un solde sont affectés au solde correspondant. Vous verrez un récapitulatif de chaque solde en devise dans votre Aperçu du compte. Pour en savoir plus sur la gestion des soldes en devise, reportez-vous à la section « Devises acceptées par PayPal » à la page 56.
Trois options sont possibles :
z Oui : Acceptez le paiement quelle que soit la devise dans laquelle il est effectué. z Non, les accepter et les convertir Euro : Acceptez les paiements mais convertissez-les
automatiquement Euro.
z Me demander : Vous pouvez accepter ou refuser un paiement effectué dans une devise
que vous ne détenez pas et ce, transaction par transaction. Si vous acceptez le paiement, la transaction est terminée. Si vous le rejetez, l’expéditeur du paiement sera averti que le paiement est refusé et se verra créditer du montant correspondant. PayPal ne débite pas de frais pour les paiements rejetés.
48 Août 2006 Guide d’intégration de Paiements sur site marchand
Utiliser les préférences et outils de votre compte marchand
Bloquer certains types de paiement

Bloquer les paiements initiés à partir du sous-onglet Envoi de paiement

Vous pouvez décider d’accepter ou non des paiements initiés à partir du sous-onglet Envoi de paiement accessible à partir de l’onglet Paiement du site PayPal. La sélection de cette option
vous permet de mieux gérer votre compte, car tous les paiements PayPal que vous recevez sont associés à un objet ou à une transaction spécifiques que vous avez préalablement définis.
Si vous décidez de bloquer ces paiements, les seuls paiements acceptés seront ceux initiés via les fonctions Acheter maintenant, Dons, Panier PayPal, Abonnements et paiements récurrents, Notification au meilleur enchérisseur, Paiements groupés, Demande de paiement, Contact simplifié eBay ou les logos malins.

Bloquer les paiements approvisionnés par carte bancaire lorsque l’expéditeur possède un compte bancaire

Vous pouvez obliger les clients à vous payer, s’ils le peuvent, avec un compte bancaire ou des fonds PayPal. Cependant, s’ils ne le peuvent pas, ils ont toujours la possibilité de payer par carte bancaire.
Cette préférence peut également vous aider à réduire les risques de rejets de débit. Les utilisateurs Vérifiés possèdent des comptes bancaires confirmés ou ont été vérifiés par PayPal. La plupart des utilisateurs Vérifiés ayant la possibilité de payer avec leurs comptes bancaires (via un chèque électronique ou un virement immédiat), le fait de choisir cette préférence n’empêche pas les utilisateurs de vous envoyer de l’argent. Lorsqu’ils vous paient avec le virement immédiat de PayPal, vous recevez le paiement instantanément, comme s’ils payaient avec une carte bancaire. Les utilisateurs ne possédant pas de comptes bancaires confirmés avec PayPal ont toujours la possibilité de vous payer en utilisant des cartes bancaires.

Bloquer les paiements approvisionnés par chèques électroniques

Vous pouvez bloquer des paiements par chèque électronique. Les paiements par chèque électronique prenant trois ou quatre jours ouvrés pour les vérifications, il se peut que vous souhaitiez bloquer ce type de paiement pour les boutons Règlement instantané et Acheter maintenant.
Si vous choisissez de bloquer ces paiements, les utilisateurs qui tentent de payer en utilisant un chèque électronique sont invités à ajouter une carte bancaire sur leur compte avant d’effectuer la transaction.
Si vous choisissez de ne pas bloquer ces paiements, vous pouvez recevoir des paiements par chèque électronique via les paiements sur site marchand ou par logo d’enchère. Les paiements sont indiqués comme étant « En attente » et ne sont pas crédités sur votre compte PayPal avant trois à quatre jours ouvrés.
Guide d’intégration de Paiements sur site marchand Août 2006 49
Utiliser les préférences et outils de votre compte marchand

Ajouter le nom figurant sur le relevé de carte bancaire

Ajouter le nom figurant sur le relevé de carte bancaire
Sur la page Préférences de réception de paiements, vous pouvez indiquer le nom qui apparaîtra sur les relevés de carte bancaire de vos clients.
FIGURE 2.16 Ajouter le nom figurant sur le relevé de carte bancaire
Lorsqu’un acheteur vous règle par carte bancaire, votre nom s’affiche avec le mot PAYPAL* à côté du montant débité sur le relevé (par ex. PAYPAL*MONNOM). Ce nom peut être constitué d’un maximum de 11 caractères, espaces compris et ne peut contenir de caractères spéciaux (par ex. &, #, _, etc.). Il est par la suite entièrement converti en majuscules et peut être tronqué par certains processeurs de cartes bancaires.
Le nom figurant sur le relevé de carte bancaire doit refléter avec exactitude votre raison sociale ou nom légal.

Obtenir les numéros de téléphone à contacter auprès de vos clients

Le champ Numéro de téléphone à contacter fournit le numéro de téléphone permettant de contacter votre client. Lorsque vous activez cette option, vos clients sont obligés d’inclure, dans les informations relatives au paiement, le numéro de téléphone de la personne à contacter.
IMPORTANT :Conformément aux Conditions d’utilisation de PayPal, vous ne pouvez
utiliser ce numéro de téléphone que pour communiquer avec l’acheteur en rapport avec l’achat en question. Vous ne pouvez pas utiliser ce numéro pour des messages commerciaux non sollicités.
Vous pouvez rendre le numéro de téléphone à contacter facultatif, obligatoire ou bien le désactiver. Il est recommandé, par défaut, de le désactiver, car les acheteurs attachent de l’importance au respect de leur vie privée et préfèrent réduire le nombre de communications non sollicitées au strict minimum.
50 Août 2006 Guide d’intégration de Paiements sur site marchand
Utiliser les préférences et outils de votre compte marchand
Lorsque vous demandez à l’acheteur de vous communiquer un numéro de téléphone où vous pourrez le contacter, l’acheteur voit les informations suivantes :
FIGURE 2.17 Inviter le client à saisir le Numéro de téléphone à contacter

Activer le Numéro de téléphone à contacter

Suivez les étapes ci-dessous pour activer l’option Numéro de téléphone à contacter :

Choix de la langue de vos données

1. Connectez-vous à votre compte PayPal à l’adresse https://www.paypal.fr
2. Cliquez sur l’onglet Mon compte.
3. Cliquez sur le lien Préférences.
4. Cliquez sur le lien Préférences de réception de paiement sur le site.
5. Sélectionnez une option : Oui (champ facultatif), Oui (champ obligatoire) ou Non (recommandé).
6. Terminez vos sélections sur la page.
7. Cliquez sur Enregistrer.
Choix de la langue de vos données
Les sites Web qui utilisent PayPal dans différentes parties du monde utilisent des langues distinctes. En informatique, les langues sont représentées par le jeu de caractères et le codage de caractères.
Un jeu de caractères est une représentation informatique de toutes les formes de lettres et symboles d’une langue donnée. Le code ASCII (American Standard Code for Information Interchange), par exemple, est un jeu de caractères standard utilisé depuis plusieurs dizaines années pour représenter les formes de lettres, les nombres, la ponctuation et les symboles de l’anglais américain. Big 5, l’un des jeux de caractères chinois les plus généralement implémentés, est un autre exemple de jeu de caractères. Le codage des caractères, quant à lui, indique comment un caractère donné est représenté pour le traitement interne des données, c’est-à-dire comment chaque caractère est stocké et utilisé. Il existe différentes sortes de codage de caractères. Un codage peut, par exemple, allouer 7, 8 ou 16 bits informatiques pour un seul caractère.
PayPal réunit ces deux termes sous le nom de codage de la langue.
.
Guide d’intégration de Paiements sur site marchand Août 2006 51
Utiliser les préférences et outils de votre compte marchand
Choix de la langue de vos données

Changer votre choix de langue

En paramétrant votre Choix de la langue dans vos Préférences, vous pouvez contrôler avec précision le codage des données attendues par PayPal en provenance de votre site après utilisation d’un bouton de paiement PayPal, ainsi que contrôler le codage des données que votre site attend de PayPal.
Lorsque vous créez un compte Business PayPal, ce dernier détermine votre jeu de caractères et son codage en fonction de votre pays d’origine tel que vous l’avez indiqué lors de l’inscription. Si, par exemple, votre adresse postale indique la France, la langue par défaut de vos Préférences des ventes est Langues européennes occidentales.

Parcours dans vos Préférences : choix de la langue

Afin de définir la langue par défaut de votre compte Business PayPal, connectez-vous à votre compte, puis cliquez sur l’onglet Préférences. Dans la colonne Préférences des ventes, cliquez sur Choix de la langue.
FIGURE 2.18 Préférences du vendeur : choix de la langue

Changer la langue de votre site

La page Choix de la langue affiche le paramètre de langue de votre site, comme le montre l’illustration ci-après. Vous pouvez modifier ce paramètre avec le menu déroulant Langue de votre site Web.
52 Août 2006 Guide d’intégration de Paiements sur site marchand
Utiliser les préférences et outils de votre compte marchand
Choix de la langue de vos données
FIGURE 2.19 Paramètres du Choix de la langue : choix de base
Pour modifier la langue des données que PayPal reçoit de votre site, cliquez sur le menu déroulant Langue de votre site, comme le montre la Figure 2.20, « Préférence de
langue du site ».
FIGURE 2.20 Préférence de langue du site
Cliquez sur Enregistrer pour enregistrer votre sélection ou Annuler pour laisser le paramètre tel quel.
Guide d’intégration de Paiements sur site marchand Août 2006 53
Utiliser les préférences et outils de votre compte marchand
Choix de la langue de vos données

Autres options de codage

Si vous connaissez le nom standard exact du codage de caractères de votre site et que vous souhaitez le préciser, cliquez sur Autres options sur la page Choix de la langue afin d’ouvrir la page Autres options de codage comme illustré à la Figure 2.21, « Autres options de codage
de la langue ».
La page Autres options de codage vous permet de préciser le codage des caractères que PayPal doit recevoir de votre site et le codage des données que PayPal envoie à votre site.
FIGURE 2.21 Autres options de codage de la langue
Le codage sélectionné dans le menu déroulant Codage est défini en fonction du pays d’origine indiqué lors de votre inscription.
Pour changer le codage sélectionné, cliquez sur le menu déroulant Codage et sélectionnez l’un des codages disponibles. Pour la liste complète des codages pris en charge, reportez-vous au
Tableau 9.13, « Codages et jeux de caractères pris en charge par PayPal » page 113.
Il vous est possible de conserver ce codage ou de spécifier un autre codage pour les données que vous recevez de PayPal. Pour utiliser le même codage que pour votre site, cliquez sur le bouton radio Oui. Pour utiliser un codage différent, cliquez sur le bouton radio Non, puis sélectionnez le codage souhaité dans le menu déroulant associé.

Paramétrer le choix de la langue pour chaque transaction

Vous pouvez paramétrer le choix de la langue pour chaque transaction à l’aide de la variable charset. Reportez-vous à la section « Définir le jeu de caractères : charset » page 113.
54 Août 2006 Guide d’intégration de Paiements sur site marchand
Utiliser les préférences et outils de votre compte marchand

Accès multi-utilisateur à votre compte PayPal

Accès multi-utilisateur à votre compte PayPal
Avec l’Accès multi-utilisateur, vous pouvez configurer plusieurs noms de connexion avec différents niveaux d’accès à votre compte PayPal, de sorte que vos employés, par exemple, n’aient accès qu’aux parties du compte dont ils ont besoin pour effectuer leur travail. Ainsi, vous pouvez fournir aux représentants du service clientèle leur propre nom de connexion avec un niveau de permission limité, de sorte qu’ils soient uniquement en mesure d’afficher les soldes et d’effectuer des remboursements, sans pouvoir modifier les Préférences, ni envoyer de l’argent ni effectuer de virement.
Vous pouvez ajouter jusqu’à sept noms de connexion à votre compte. Vous souhaitez peut-être définir un identifiant distinct pour chacun des employés et leur accorder le minimum de permissions nécessaires. Lorsqu’un employé oublie ou perd son mot de passe, vous pouvez toujours vous connecter et le reconfigurer.
REMARQUE :Pensez à révoquer les privilèges de tout employé quittant votre société.
Pour utiliser la fonction Accès multi-utilisateur :
1. Connectez-vous à votre compte Business PayPal.
2. Accédez à vos Préférences
3. Cliquez sur Accès multi-utilisateur.
FIGURE 2.22 Lien Accès multi-utilisateur dans le récapitulatif des Préférences
4. Indiquez l’adresse email du Contact Administratif. Il s’agit de l’adresse email qui recevra les notifications relatives à l’activité de votre compte.
REMARQUE :Vous devez confirmer cet adresse email avant de pouvoir continuer.
5. Pour chaque nom de connexion, spécifiez une Adresse email et un mot de passe, puis indiquez les privilèges que vous souhaitez accorder à l’utilisateur.
Guide d’intégration de Paiements sur site marchand Août 2006 55
Utiliser les préférences et outils de votre compte marchand

Devises acceptées par PayPal

FIGURE 2.23 Accès multi-utilisateur : Ajouter un utilisateur
Devises acceptées par PayPal
Les devises suivantes sont acceptées par PayPal.
TABLEAU 2.6 Devises acceptées par PayPal, codes des devises et montants
maximum des transactions
Code Devise Montant maximum des transactions
AUD Dollar australien 12 500 AUD
CAD Dollar canadien 12 500 CAD
EUR Euro 8 000 EUR
56 Août 2006 Guide d’intégration de Paiements sur site marchand
Utiliser les préférences et outils de votre compte marchand

Accepter ou rejeter les paiements multi-devises

T
ABLEAU 2.6 Devises acceptées par PayPal, codes des devises et montants
maximum des transactions
Code Devise Montant maximum des transactions
GBP Livre sterling 5 500 GBP
JPY Yen japonais 1 000 000 JPY
USD Dollar américain 10 000 USD
Accepter ou rejeter les paiements multi-devises
PayPal vous permet de choisir les devises que vous acceptez et la façon dont vous les acceptez. Vous pouvez définir vos Préférences de réception de paiements pour le traitement des paiements multi-devises. Reportez-vous à la section « Bloquer certains types de paiement »
page 48.
Lorsqu’un client effectue un paiement dans une devise que vous possédez, les fonds apparaissent automatiquement sur votre compte dans le solde de la devise en question. Si un client vous règle dans une devise pour laquelle vous ne détenez aucun solde, vous pouvez accepter ou de rejeter le paiement.
FIGURE 2.24 Accepter ou rejeter les paiements multi-devises.
Des commissions sur la réception sont appliquées dans la devise dans laquelle les fonds sont envoyés. Les paiements convertis dans votre devise principale utilisent un taux de change avantageux.
Guide d’intégration de Paiements sur site marchand Août 2006 57
Utiliser les préférences et outils de votre compte marchand

Gérer les soldes en devise

Gérer les soldes en devise
Pour gérer les soldes en devises, utilisez la section Soldes en devise de vos Préférences :
z Sélectionnez votre devise principale. z Ouvrez ou clôturez un solde en devise. z Procédez à un virement de fonds entre des soldes en devises différentes. Les fonds
transférés d’un solde en devise à un autre sont convertis selon un taux de change avantageux.
58 Août 2006 Guide d’intégration de Paiements sur site marchand
3

Payer un seul objet : Boutons Acheter maintenant et Dons

Les boutons Acheter maintenant ou Dons conviennent parfaitement au paiement d’un seul objet. Un bouton Acheter maintenant permet de vendre plusieurs exemplaires du même objet. Cependant, pour vendre différents objets, vous devez créer des boutons Acheter maintenant distincts ou utiliser le panier PayPal. Vous pouvez utiliser un bouton Dons pour collecter un montant prédéfini ou vous pouvez laisser aux donateurs le choix du montant de leur don. L’« Exemple de séquence de base de
pages » page 18 présente les boutons Acheter maintenant ou Dons.
Vous pouvez créer un bouton Acheter maintenant ou Dons de deux manières :
z Utilisez l’Assistant pour création de boutons Acheter maintenant ou Dons en vue de créer
un formulaire HTML FORM à copier sur votre site ou dans un email.
z Utilisez les outils Web de votre choix, concevez votre propre formulaire HTML FORM à
partir de l’exemple de la section « Echantillon de code HTML d’un bouton Acheter
maintenant et d’un lien hypertexte » page 64 et les descriptions de variables indiquées à
l’Annexe A, « Variables HTML de Paiements sur site marchand ».

Utiliser l’Assistant pour création de boutons Acheter maintenant ou Dons

Que ce soit pour les boutons Acheter maintenant ou pour les boutons Dons, l’assistant fonctionne exactement de la même manière, excepté qu’il requiert des informations légèrement différentes. Nous allons vous spécifier ces différences.
Pour créer du code HTML avec l’Assistant pour création de boutons Acheter maintenant ou Dons :
1. Connectez-vous à votre compte PayPal à l’adresse
2. Cliquez sur l’onglet Outils marchands.
3. Cliquez sur Boutons Acheter maintenant ou Dons.
4. Entrez les informations sur votre objet. Tous les champs sont facultatifs.
Champs des boutons Acheter maintenant
Service/Nom de l’objet : Entrez le nom de l’objet ou du service que vous souhaitez
vendre. Si vous laissez ce champ vide, vos clients peuvent le compléter au moment de l’achat. PayPal vous recommande toutefois d’entrer un nom d’objet afin de faciliter l’envoi de la commande.
Nº/ID de l’objet : Si vous possédez un ID ou un numéro de suivi pour votre objet,
entrez-le ici. Ce champ n’est pas disponible pour vos clients au moment du paiement, en revanche, il apparaîtra dans les détails de leur transaction sur le site PayPal.
Prix de l’objet : Entrez le prix de l’objet que vous souhaitez vendre. Si vous laissez ce
champ vide, vos clients peuvent le compléter. PayPal vous recommande toutefois d’entrer un prix afin de récupérer plus facilement le montant correct de la transaction.
https://www.paypal.fr.
Guide d’intégration de Paiements sur site marchand Août 2006 59
Payer un seul objet : Boutons Acheter maintenant et Dons
Utiliser l’Assistant pour création de boutons Acheter maintenant ou Dons
Champs des boutons Dons
Service/Nom du don : Entrez ici le motif du paiement ou le nom de votre organisation
ou de votre association caritative. Si vous laissez ce champ vide, vos donateurs pourront le compléter.
Numéro/Identification du don : Ce champ vous permet de différencier les paiements
(par exemple d’entrer le nom d’une campagne). Ce champ n’est pas disponible pour vos donateurs au moment du paiement, en revanche, il apparaîtra dans les détails de leur transaction sur le site PayPal.
Montant du don : Si vous souhaitez collecter un montant prédéfini, vous pouvez l’entrer
dans le champ Montant du don. Si vous préférez laisser la possibilité aux donateurs de fixer le montant de leurs dons, laissez ce champ vide. Les utilisateurs seront invités à entrer un montant au moment du paiement.
Champs communs
Devise : Choisissez la devise dans laquelle vous souhaitez que ce paiement soit libellé.
Ce champ contiendra par défaut la devise de votre compte principal.
Pays de l’acheteur : Pour afficher la page de connexion ou d’ouverture de compte
PayPal dans une langue donnée, sélectionnez un pays dans lequel cette langue est parlée dans le menu déroulant.
5. Choisissez l’image à associer à votre bouton. Si vous envisagez de recevoir les paiements ou les dons depuis votre site, choisissez
l’image du bouton sur lequel les clients doivent cliquer pour effectuer leur achat. Pour afficher votre propre image, entrez l’URL de son emplacement dans le champ URL.
REMARQUE : PayPal recommande d’entrer une URL d’image uniquement si celle-ci est
stockée sur un serveur sécurisé (https). Dans le cas contraire, le navigateur Internet de votre client affiche un message indiquant que la page de paiement contient des éléments non sécurisés.
Si vous souhaitez créer un lien dans un email, reportez-vous à la section « Ajouter d’autres
informations à votre bouton » page 61.
6. Paramètres de sécurité PayPal offre la possibilité de crypter le code HTML de votre bouton. Le cryptage permet
de garantir que le prix d’un objet ou toute autre information ne peut pas être modifié par un tiers, assurant ainsi une meilleure sécurité de vos transactions. Sélectionnez Oui pour crypter votre code, ou Non pour qu’il reste modifiable.
PayPal vous recommande vivement decrypter votre bouton. Cependant, trois restrictions sont à prendre en compte :
– Le code HTML du bouton crypté n’est pas modifiable. Si vous souhaitez modifier
vous-même le code de vos boutons, sélectionnez Non.
– Vous ne pouvez pas crypter votre bouton s’il contient du code généré dynamiquement
à partir de la page Ajouter d’autres options, tel que des champs d’option déroulants (voir étape 5). Si vous souhaitez utiliser des champs d’option pour vos produits, sélectionnez Non pour désactiver le cryptage.
– Vous ne pourrez pas créer de lien d’email si vous choisissez de crypter votre bouton.
60 Août 2006 Guide d’intégration de Paiements sur site marchand
Payer un seul objet : Boutons Acheter maintenant et Dons
Utiliser l’Assistant pour création de boutons Acheter maintenant ou Dons

Ajouter d’autres informations à votre bouton

Si vous n’avez pas d’autres détails à ajouter à votre bouton (tels que la TVA, les frais d’expédition et de livraison ou votre logo), cliquez sur Créer le bouton et reportez-vous à la section « Copier/coller le code HTML » page 63. Dans le cas contraire, cliquez sur Ajouter d’autres options.
Si vous souhaitez ajouter des informations à votre bouton, procédez comme suit :
1. Pour ajouter les frais d’expédition et de livraisons et la TVA aux boutons Acheter maintenant
Calcul des frais d’expédition et de livraison : Si vous avez déjà indiqué les tarifs
d’expédition dans vos Préférences, ils sont répertoriés ici.
Calcul de la TVA : Si vous avez déjà indiqué le taux de la TVA dans vos Préférences,
il s’affiche ici. Pour en savoir plus, reportez-vous à la section « Calcul automatique des
frais d’expédition et de traitement » page 45.
2. Pour créer des champs d’option dans les boutons Acheter maintenant
En créant un champ d’option, vous offrez la possibilité à vos clients d’indiquer des informations sur leurs achats. Ces champs d’option peuvent vous servir à mentionner par exemple la couleur, la taille ou l’emballage pour les cadeaux. Ces options ne doivent pas entraîner une modification du prix de l’objet. Elles vous permettent de collecter des informations supplémentaires sur votre client tout en évitant d’avoir à communiquer par email. Chaque bouton Acheter maintenant peut disposer de deux champs d’option au maximum et collecter les informations soit par le biais d’un menu déroulant, soit par le biais d’une zone de texte.
Cependant, vous ne pouvez actuellement pas utiliser les champs d’option et le cryptage des boutons si vous créez un lien dans un email. Si vous souhaitez tout de même envoyer les liens Acheter maintenant dans vos emails, vous pouvez essayer d’envoyer un email HTML, contenant un lien vers le bouton Acheter maintenant (avec les champs d’option) de votre site, ou de demander à l’utilisateur d’inclure l’information facultative dans le champ Remarque.
Type de champ d’option : Choisissez le type de champ d’option : menu déroulant ou
zone de texte. Si vous choisissez le menu déroulant, vous entrez les différentes propositions. Si vous optez pour la zone de texte, c’est votre client qui indique son choix.
Nom de l’option : Entrez le nom de votre option. Le champ Nom de l’option ne doit pas
dépasser 60 caractères.
Choix du menu déroulant : Si vous utilisez un menu déroulant, entrez vos choix.
Chaque choix est limité à 30 caractères et vous pouvez entrer un maximum de 10 choix. Séparez chaque choix à l’aide d’un retour chariot (appuyez sur ENTREE) pour séparer chaque choix.
Guide d’intégration de Paiements sur site marchand Août 2006 61
Payer un seul objet : Boutons Acheter maintenant et Dons
Utiliser l’Assistant pour création de boutons Acheter maintenant ou Dons
3. Personnalisez vos pages de paiement
Style de pages de paiement : Offrez à vos clients une procédure de paiement fluide grâce
à la personnalisation des pages de paiement de PayPal, le style de ces pages correspondant ainsi à celui de votre site. Si vous avez déjà ajouté des styles de pages de paiement personnalisées à vos Préférences, ils seront répertoriés ici. Choisissez le style de page qui doit s’afficher lorsque votre client clique sur le bouton Acheter maintenant. Pour en savoir plus sur la création des styles de page, reportez-vous à la section « Conserver l’apparence
de votre boutique sur les pages de paiement PayPal » page 31.
4. Personnalisez le parcours de votre client
URL en cas de réussite du paiement : Entrez l’URL de la page vers laquelle vous
souhaitez que votre client soit redirigé une fois le paiement effectué. A moins que vous n’ayez activé le Renvoi automatique, le client obtient une page de fin de paiement dans laquelle il peut cliquer sur Continuer et retourner à l’URL de la page Paiement réussi que vous avez spécifiée. En l’absence d’URL, les clients qui cliquent sur ce lien seront renvoyés vers une page Web PayPal.
URL en cas d’échec du paiement : Entrez l’URL vers laquelle vous souhaitez que
les clients qui annulent leur paiement au cours de la procédure de paiement Acheter maintenant soient renvoyés. En l’absence d’URL, les clients qui cliquent sur ce lien sont renvoyés vers une page PayPal.
5. Options diverses
Quantité : Si vous souhaitez que vos clients achètent plusieurs objets ou services,
sélectionnez Oui pour les inviter à saisir la quantité qu’ils désirent. Si vous optez pour Non, la quantité est fixée à 1 et vos clients ne pourront acheter qu’un seul objet par paiement.
Adresse de livraison : Si vous souhaitez que vos clients soient invités à fournir une
adresse de livraison, choisissez Oui. Si vous optez pour Non, vos clients n’auront pas la possibilité de fournir une adresse de livraison à cet endroit.
6. Collectez des informations supplémentaires sur vos clients.
Remarque : Sélectionnez Oui si vous souhaitez autoriser vos clients à inclure une
remarque à votre intention avec leur paiement. Si vous sélectionnez Non, vos clients ne peuvent pas inclure de remarque.
Titre de la remarque : Si vous autorisez les clients à joindre un commentaire à leur
paiement, vous devez choisir un titre pour le champ Remarque. Le titre vous permet d’inviter les clients à entrer des informations spécifiques, comme un code client, ou des instructions particulières. Il est limité à 40 caractères. Si vous n’indiquez pas de titre, le titre Instructions spéciales (facultatif) s’affichera pour le champ Remarque.
7. Choisissez une adresse email pour la réception des paiements.
Si vous disposez de plusieurs adresses email confirmées, vous avez la possibilité de spécifier l’adresse à laquelle recevoir les notifications de paiement lors du règlement de vos clients.
62 Août 2006 Guide d’intégration de Paiements sur site marchand
Payer un seul objet : Boutons Acheter maintenant et Dons
Utiliser l’Assistant pour création de boutons Acheter maintenant ou Dons

Copier/coller le code HTML

Lorsque vous avez rempli le formulaire de l’Assistant pour création de boutons Acheter maintenant, cliquez sur Créer le bouton.
Si vos clients paient sur votre site :
1. Copiez le code de la zone de texte Code HTML pour les sites en mettant l’intégralité
du texte en surbrillance, puis en appuyant sur la combinaison de touches Ctrl+C ou en choisissant Copier dans le menu contextuel qui s’affiche lorsque vous cliquez avec le bouton droit de la souris sur le texte sélectionné.
2. Ouvrez la page Web à partir de laquelle vous souhaitez collecter un paiement.
3. Collez le code que vous venez de copier dans le fichier de la page Web à chaque
emplacement où doit apparaître l’image, généralement à côté de la description de l’objet ou du service. Pour ce faire, appuyez sur Ctrl+V ou sélectionnez l’option Coller dans le menu contextuel qui s’affiche après avoir cliqué avec le bouton droitdelasouris.
Si vos clients vous règlent par email :
REMARQUE : Si vous utilisez les Paiements sur site marchand cryptés, vous ne pourrez pas
créer de lien dans un email.
1. Copiez le code de la zone de texte Pour les emails en mettant l’intégralité du texte en surbrillance, puis en appuyant sur la combinaison de touches Ctrl+C ou en choisissant Copier lorsque vous cliquez avec le bouton droit de la souris sur le texte sélectionné.
2. Ouvrez l’email que vous souhaitez envoyer.
3. Collez-y le code que vous venez de copier en appuyant sur Ctrl+V ou en cliquant avec le bouton droit de la souris et en sélectionnant l’option Coller.
4. Lorsque vos clients reçoivent l’email, le code apparaît sous forme de lien. En cliquant
dessus, ils sont renvoyés vers votre page de paiement PayPal.
Astuce concernant le code HTML : Assurez-vous que le code HTML de votre page Web correspond exactement au code copié à partir du site PayPal. Certains éditeurs HTML sont susceptibles de modifier certains caractères de votre code. Par ailleurs, assurez-vous que vous copiez le code dans un champ qui accepte le HTML. Si vous collez le code dans une zone de texte standard, le code est traité comme texte à afficher.
Guide d’intégration de Paiements sur site marchand Août 2006 63
Payer un seul objet : Boutons Acheter maintenant et Dons

Echantillon de code HTML d’un bouton Acheter maintenant et d’un lien hypertexte

Echantillon de code HTML d’un bouton Acheter maintenant et d’un lien hypertexte
Le code HTML d’un bouton Acheter maintenant ressemble à celui-ci : Plusieurs champs facultatifs sont représentés.
EXEMPLE 3.3 HTML pour bouton Acheter maintenant
IMPORTANT :Vous pouvez modifier les valeurs de n’importe quelle variable, à l’exception
des deux premières lignes.
<form target="paypal" action="https://www.paypal.com/fr/cgi-bin/webscr" method="post">
<!-- pour spécifier un bouton Acheter maintenant, utilisez la commande _xclick --> <input type=”hidden” name=”cmd” value=”_xclick”> <input type=”hidden” name=”business” value=”seller@designerfotos.com”> <!-- Permet au client de saisir la quantité souhaitée --> <input type=”hidden” name=”undefined_quantity” value=”1”> <input type=”hidden” name=”item_name” value=”Casquette baseball”> <input type=”hidden” name=”item_number” value=”123”> <!—Aucune variable currency_code n’a été spécifiée, donc le montant est supposé être en USD --> <input type=”hidden” name=”amount” value=”5.95”> <! Variables de transit pour le suivi des commandes, par exemple --> <input type=”hidden” name=”custom” value=”merchant_custom_value”> <input type=”hidden” name=”invoice” value=”merchant_invoice_12345”> <input type=”hidden” name=”charset” value=”utf-8”> <input type=”hidden” name=”no_shipping” value=”1”> <input type=”hidden” name=”image_url” value=”https://www.designerfotos.com/logo.gif”> <input type=”hidden” name=”return” value=”http://www.designerfotos.com/thankyou.htm”> <input type=”hidden” name=”cancel_return” value=”http://www.designerfotos.com/cancel.htm”> <!-- N’invite pas le client à ajouter une remarque à son achat --> <input type=”hidden” name=”no_note” value=”1”> <table>
<tr>
<td>
<!-- Permet au client de choisir des options du produit --> <input type=”hidden” name=”on0” value=”Color?”>Color? <select name=”os0”>
<option value=”Red”>Red <option value=”Green”>Green <option value=”Blue”>Blue</select>
</td>
</tr> </table> <input type=”image” src=”http://images.paypal.com/images/x-click-but01.gif” name=”submit” alt=”Effectuez vos paiements via PayPal : une solution rapide, gratuite et sécurisée”> </form>
64 Août 2006 Guide d’intégration de Paiements sur site marchand
Payer un seul objet : Boutons Acheter maintenant et Dons
Echantillon de code HTML d’un bouton Acheter maintenant et d’un lien hypertexte
Le code ci-dessus génère le lien hypertexte ci-dessous. Cet exemple inclut plusieurs champs facultatifs et le texte est encodé dans l’URL.
https://www.paypal.com/fr/xclick/business=vendeur@votresite.com&undefined_quantity=1& item_name=Casquette+Base­ball&item_number=123&amount=5.95&no_shipping=1&return=http%3A//www.votresite.com/merc i.htm&cancel_return=http%3A//www.votresite.com/cancel.htm¤cy_code=USD
Guide d’intégration de Paiements sur site marchand Août 2006 65
Payer un seul objet : Boutons Acheter maintenant et Dons
Echantillon de code HTML d’un bouton Acheter maintenant et d’un lien hypertexte
66 Août 2006 Guide d’intégration de Paiements sur site marchand
4

Payer plusieurs objets : le Panier

Avec le Panier PayPal, vos clients peuvent acheter plusieurs objets en une seule fois, parcourir la liste complète des objets que vous proposez et visualiser la liste récapitulative des objets qu’ils ont sélectionnés avant d’effectuer leur achat.
Le panier se présente sous deux formes de base :
1. Panier hébergé sur le site de PayPal,
2. Variables d’entrée HTML à utiliser dans les paniers tiers.
La principale distinction entre le panier hébergé par PayPal et le panier tiers réside dans les variables HTML suivantes :
z add ou display : ces variables indiquent le panier hébergé par PayPal. z upload : cette variable indique qu’un panier tiers est utilisé.
https://www.paypal.fr/.

Fonctionnement du panier hébergé par PayPal

Cet exemple montre comment le panier hébergé par PayPal peut utiliser les fonctions suivantes :
z La fonction Compte PayPal facultatif est désactivée. Dans cet exemple, pour payer avec
PayPal, le client doit déjà détenir un compte PayPal. Pour en savoir plus, reportez-vous à la section « Compte PayPal facultatif » page 37.
z La fonction Renvoi automatique est activée. A la fin de la transaction, le navigateur du
client est automatiquement redirigé vers votre site. Pour en savoir plus, reportez-vous à la section « Renvoi automatique » page 43.
Guide d’intégration de Paiements sur site marchand Août 2006 67
Payer plusieurs objets : le Panier

Ce qui apparaît à l’écran de votre client

Jean, qui détient un compte PayPal, fait des achats sur DesignerFotos. Il sélectionne un cadre photo en cliquant sur Ajouter au panier.
FIGURE 4.25 Exemple de panier hébergé par PayPal : Ajouter au panier
La boutique DesignerFotos utilise un bouton Ajouter au panier générique créé à l’aide de l’Assistant pour création de boutons pour le panier PayPal décrit à la section « Assistant pour
création de boutons pour le panier hébergé par PayPal » page 73. Le code HTML de ce bouton
est détaillé à la section « Exemple de code HTML pour le panier hébergé par PayPal » page 77.
68 Août 2006 Guide d’intégration de Paiements sur site marchand
Payer plusieurs objets : le Panier
Jean est dirigé vers le site de PayPal où il peut consulter les objets contenus dans son panier et effectuer des changements, au besoin. Pour accéder à la page d’informations sur la facturation, Jean clique sur Passer au paiement.
FIGURE 4.26 Exemple de panier hébergé par PayPal : sur le site de PayPal
Dans la page d’informations sur la facturation, Jean entre son identifiant et son mot de passe PayPal, puis clique sur Connexion.
Guide d’intégration de Paiements sur site marchand Août 2006 69
Payer plusieurs objets : le Panier
FIGURE 4.27 Exemple de panier hébergé par PayPal : saisie des informations
de facturation
70 Août 2006 Guide d’intégration de Paiements sur site marchand
Payer plusieurs objets : le Panier
Jean est dirigé vers une page récapitulative contenant les détails de son paiement.
FIGURE 4.28 Exemple de panier hébergé par PayPal : page récapitulative
Etant donné que DesignerFotos n’a pas activé vos préférences en matière de livraison, aucun frais d’expédition et de livraison n’est ajouté à la commande. Pour en savoir plus sur le calcul des frais d’expédition et de livraison, reportez-vous à la section « Calcul automatique des frais
d’expédition et de traitement » page 45.
Jean clique sur Payer pour effectuer le paiement.
Guide d’intégration de Paiements sur site marchand Août 2006 71
Payer plusieurs objets : le Panier
Jean est dirigé vers une page de remerciement à la fin du paiement. S’il ne dispose pas encore d’un compte PayPal, il peut choisir d’en ouvrir un sur cette page en
sélectionnant un mot de passe et en cliquant sur Ouvrir un compte.
FIGURE 4.29 Exemple de panier hébergé par PayPal : page de remerciement après le
paiement
Jean reçoit un avis de réception par email pour cette transaction qui confirme le paiement et les détails correspondants.
72 Août 2006 Guide d’intégration de Paiements sur site marchand
Payer plusieurs objets : le Panier

Assistant pour création de boutons pour le panier hébergé par PayPal

FIGURE 4.30 Exemple de panier hébergé par PayPal : avis de réception par email
Assistant pour création de boutons pour le panier hébergé par PayPal
Le panier hébergé par PayPal permet aux clients d’effectuer un seul paiement pour plusieurs objets. Notre Assistant pour création de boutons pour le panier vous permet de créer un bouton Ajouter au panier distinct pour chaque objet et d’insérer le code HTML généré automatiquement pour ce bouton sur votre site à côté de l’objet.
Suivez les étapes ci-après pour créer un bouton de panier, ou si vous maîtrisez le code HTML, vous pouvez utiliser les variables décrites à l’Annexe pour coder vos propres boutons.
1. Connectez-vous à votre compte PayPal à l’adresse
2. Entrez l’URL suivante :
https://www.paypal.com/fr/cgi-bin/webscr?cmd=_cart-factory
3. Entrez les détails de l’objet.
Service/Nom de l’objet (obligatoire) : Entrez le nom de l’objet ou du service que vous
souhaitez vendre.
Nº/ID de l’objet : Si vous possédez un ID ou un numéro de suivi pour votre objet, entrez-
le ici. Ce champ deviendra accessible à vos clients au moment du paiement et apparaîtra dans les détails de la transaction des vendeurs et acheteurs sur le site PayPal.
Prix de l’objet (obligatoire) : Entrez le prix de l’objet que vous souhaitez vendre.
https://www.paypal.fr.
Guide d’intégration de Paiements sur site marchand Août 2006 73
Payer plusieurs objets : le Panier
Assistant pour création de boutons pour le panier hébergé par PayPal
Devise (obligatoire) : Choisissez la devise dans laquelle vous souhaitez que ce paiement
soit libellé. Ce champ contiendra par défaut la devise de votre compte principal.
Pays de l’acheteur : Pour afficher la page de connexion ou d’ouverture de compte
PayPal dans une langue donnée, sélectionnez un pays dans lequel cette langue est parlée dans le menu déroulant.
4. Sélectionnez l’image à associer à votre bouton.
Si vous envisagez de recevoir les paiements depuis votre site, choisissez l’image du bouton sur lequel les clients doivent cliquer pour effectuer leur achat. Pour afficher votre propre image, entrez l’URL de son emplacement dans le champ URL.
REMARQUE : Tous les objets ajoutés à un Panier PayPal doivent avoir la même devise,
laquelle est déterminée par la devise du premier objet ajouté au panier ou par la variable currency_code. Dès qu’ils ont ajouté un objet à leur panier, les acheteurs ne peuvent plus ajouter d’objets dont le montant est libellé dans une autre devise. Pour modifier la devise, les clients doivent payer les objets choisis dans la première devise ou supprimer tous les objets de leur panier et ajouter les objets dont le montant est exprimé dans une autre devise. La solution recommandée consiste à répertorier tous les objets dans la même devise.

Ajouter d’autres informations à votre bouton

Si vous n’avez pas d’autres détails à ajouter à votre bouton (tels que la TVA, les frais d’expédition et de livraison ou votre logo), cliquez sur Créer le bouton et passez à la section « Copier et coller
le code HTML du panier » page 76. Dans le cas contraire, cliquez sur Ajouter d’autres
options.
1. Calculez les frais d’expédition et de livraison et la TVA.
Si vous avez spécifié des frais de livraison ou un calcul de la TVA dans vos Préférences, ils s’affichent sous Calcul des frais d’expédition et de livraison et Calcul de la TVA. Pour en savoir plus, reportez-vous à la section « Calcul automatique des frais d’expédition et de
traitement » page 45.
2. Ajoutez des champs d’option à votre bouton.
En créant un champ d’option, vous offrez la possibilité à vos clients d’indiquer des informations sur leurs achats. Ces champs d’option vous permettent de spécifier des informations telles que la couleur, la taille ou l’emballage pour les cadeaux. Les options ne doivent pas modifier le prix d’un objet. Chaque bouton du Panier peut comporter deux champs d’option ; vous pouvez collecter les informations soit par le biais d’un menu déroulant, soit par le biais d’une zone de texte.
Type de champ d’option : Choisissez le type de champ d’option : menu déroulant ou zone
de texte. Si vous choisissez le menu déroulant, vous entrerez les différentes propositions.
Si vous optez pour la zone de texte, c’est votre client qui indiquera son choix. – Nom de l’option : Entrez le nom de votre option. Ce champ est limité à 60 caractères.Choix du menu déroulant : Si vous utilisez un menu déroulant, entrez vos choix. Chaque
choix est limité à 30 caractères et vous pouvez entrer un maximum de 10 choix. Séparez
chaque choix à l’aide d’un retour chariot (appuyez sur Entrée).
74 Août 2006 Guide d’intégration de Paiements sur site marchand
Payer plusieurs objets : le Panier
Assistant pour création de boutons pour le panier hébergé par PayPal
3. Sélectionnez un bouton Afficher le panier.
Choisissez l’image du bouton sur lequel vos clients doivent cliquer pour payer et terminer leurs achats. Pour afficher votre propre image, entrez l’URL de son emplacement dans le champ URL.
4. Personnalisez vos pages de paiement.
Style de pages de paiement : Offrez à vos clients une procédure de paiement fluide
grâce à la personnalisation des pages de paiement de PayPal ; le style de ces pages
correspond ainsi à celui de votre site. Si vous avez déjà ajouté des styles de pages de
paiement personnalisées à vos Préférences, ils seront répertoriés ici. Choisissez le style
de page qui doit s’afficher lorsque votre client clique sur le bouton Panier. Pour en savoir
plus sur l’ajout, la sélection ou la modification de styles de pages personnalisées,
reportez-vous à la section « Conserver l’apparence de votre boutique sur les pages de
paiement PayPal » page 31.
5. Personnalisez le parcours de votre client
URL en cas de réussite du paiement : Entrez l’URL vers laquelle renvoyer vos clients
une fois le paiement terminé. Lorsque le client a terminé, une page de confirmation de
paiement s’affiche. En cliquant sur Continuer dans cette page, il sera renvoyé vers l’URL
que vous avez spécifiée. En l’absence d’URL, les clients qui cliquent sur ce lien seront
renvoyés vers une page PayPal. – URL en cas d’échec de paiement : Entrez l’URL vers laquelle vous souhaitez renvoyer
les clients qui annulent leur paiement à n’importe quel moment de la procédure de
paiement via le Panier PayPal. En l’absence d’URL, les clients qui cliquent sur ce lien
seront renvoyés vers une page PayPal.
6. Sélectionnez d’autres options.
Adresse de livraison : Si vous souhaitez que vos clients soient invités à fournir une
adresse de livraison, choisissez Oui. Dans le cas contraire, choisissez Non.
7. Collectez des informations supplémentaires sur vos clients. – Remarque : Sélectionnez Oui si vous souhaitez autoriser vos clients à inclure une
remarque à votre intention avec leur paiement. Si vous choisissez Non, vos clients n’en auront pas la possibilité.
Titre du commentaire : Vous pouvez choisir un titre pour le champ de commentaire.
Le titre vous permet d’inviter les clients à entrer des informations spécifiques (comme le code utilisateur) ou des instructions particulières. Si vous n’indiquez pas de titre, le titre
Instructions spéciales (facultatif) s’affiche pour le champ de la remarque.
8. Choisissez l’adresse email à laquelle recevoir le paiement.
Si vous disposez de plusieurs adresses email confirmées pour votre compte PayPal, vous avez la possibilité de spécifier l’adresse à laquelle vous souhaitez recevoir les notifications de paiement lors du règlement de vos clients.
Guide d’intégration de Paiements sur site marchand Août 2006 75
Payer plusieurs objets : le Panier
Assistant pour création de boutons pour le panier hébergé par PayPal

Copier et coller le code HTML du panier

Une fois le formulaire de l’Assistant pour création de boutons Panier PayPal rempli, cliquez sur Continuer.
z Copiez le code de la zone de texte Code HTML pour les sites en mettant l’intégralité
du texte en surbrillance puis en appuyant sur la combinaison de touches Ctrl+C ou en choisissant Copier dans le menu contextuel qui s’affiche lorsque vous cliquez avec le bouton droit de la souris sur le texte sélectionné.
z Ouvrez le fichier de la page Web dans lequel vous souhaitez ajouter votre bouton Panier. z Collez le code que vous venez de copier dans le fichier de la page Web à chaque
emplacement où doit apparaître le bouton (généralement, à côté de la description de l’objet ou du service). Pour ce faire, appuyez sur Ctrl+V ou sélectionnez l’option Coller dans le menu contextuel après avoir cliqué avec le bouton droit de la souris.
Astuce concernant le code HTML : Assurez-vous que le code HTML de votre page Web correspond exactement au code copié à partir du site PayPal. Certains éditeurs HTML sont susceptibles de modifier certains caractères de votre code. Par ailleurs, assurez-vous que vous copiez le code dans un champ qui accepte le format HTML. Si vous collez le code dans une zone de texte standard, le code est traité comme texte à afficher.
Créer des boutons Ajouter au panier pour tous les objets.
Cliquez sur Créer un autre bouton pour créer d’autres boutons Ajouter au panier dans les précédentes étapes.
Copiez le code HTML du bouton Afficher le panier.
Après avoir placé vos boutons Ajouter au panier sur votre site, vous devez insérer les boutons Afficher le panier pour que vos clients puissent rapidement payer leurs achats.
– Copiez le code de la zone de texte Code HTML pour les sites en mettant l’intégralité
du texte en surbrillance puis en appuyant sur la combinaison de touches Ctrl+C ou en choisissant Copier dans le menu contextuel qui s’affiche lorsque vous cliquez avec le bouton droit de la souris sur le texte sélectionné.
– Ouvrez chacune des pages Web à partir desquelles vous souhaitez que vos clients
puissent accéder à leurs Paniers PayPal.
– Collez le code que vous venez de copier dans le fichier de la page Web à chaque
emplacement où doit apparaître le bouton Afficher le panier. Pour ce faire, appuyez sur Ctrl+V ou sélectionnez l’option Coller. dans le menu contextuel après avoir cliqué avec le bouton droit de la souris.
76 Août 2006 Guide d’intégration de Paiements sur site marchand
Payer plusieurs objets : le Panier

Exemple de code HTML pour le panier hébergé par PayPal

Exemple de code HTML pour le panier hébergé par PayPal
Le code HTML ci-après est celui d’un bouton Ajouter au panier générique créé à l’aide de l’Assistant pour création de boutons pour le panier PayPal. Plusieurs champs facultatifs sont représentés.
EXEMPLE 4.4 Code HTML du bouton Ajouter au panier d’un panier hébergé
par PayPal
IMPORTANT :Vous pouvez modifier les valeurs de n’importe quelle variable, à l’exception
des deux premières lignes.
<form target="paypal" action="https://www.paypal.com/cgi-bin/webscr" method="post">
<!-- Le panier PayPal est spécifié à l’aide de la commande _cart --> <input type="hidden" name="cmd" value="_cart"> <input type="hidden" name="business" value="seller@designerfotos.com”> <!—Ajoute l’objet au panier hébergé par PayPal --> <input type=”hidden” name=”add” value=”1”> <input type="hidden" name="item_name" value="Baseball Hat"> <input type="hidden" name="item_number" value="12345"> <!—Pas de variable currency_code spécifiée, donc le montant est supposé être en USD -
-> <input type="hidden" name="amount" value="12.95"> <table>
<tr> <td> <!-- Permet au client de choisir des options du produit --> <input type="hidden" name="on0" value="Color?">Color? <select name="os0">
<option value="Red">Red <option value="Green">Green
<option value="Blue">Blue </select> </td> </tr>
</table> <input type="image" src="https://www.paypal.com/images/x-click-but22.gif" border="0" name="submit" alt="Effectuez vos paiements via PayPal : une solution rapide, gratuite et sécurisée"> </form>
Au lieu de créer un bouton distinct pour chacun des objets que vous souhaitez vendre avec le panier hébergé par PayPal, vous pouvez modifier le code HTML pour créer différents boutons Ajouter au panier.
Guide d’intégration de Paiements sur site marchand Août 2006 77
Payer plusieurs objets : le Panier
Exemple de code HTML pour le panier hébergé par PayPal

Fonctionnement du panier tiers

Cet exemple montre comment PayPal peut intégrer un panier tiers, ainsi que les fonctionnalités suivantes :
z La fonction Compte PayPal facultatif est désactivée. Dans cet exemple, pour payer avec
PayPal, le client doit déjà détenir un compte PayPal. Pour en savoir plus, reportez-vous àlasection « Compte PayPal facultatif » page 37.
z La fonction de Renvoi automatique est activée. A la fin de la transaction, le navigateur
du client est automatiquement redirigé vers le site marchand. Pour en savoir plus, reportez-vous à la section « Renvoi automatique » page 43.

Ce qui apparaît à l’écran de votre client

Jean, qui détient un compte PayPal, achète des photos à DesignerFotos. Il sélectionne plusieurs photos en cliquant sur Ajouter au panier.
FIGURE 4.31 Exemple de panier tiers : Ajouter au panier
78 Août 2006 Guide d’intégration de Paiements sur site marchand
Payer plusieurs objets : le Panier
Exemple de code HTML pour le panier hébergé par PayPal
Dans cet exemple d’intégration, le contenu du panier s’affiche à chaque fois qu’un objet est ajouté au panier.
FIGURE 4.32 Exemple de panier tiers : Passer au paiement
Après avoir sélectionné tous les objets de son choix, Jean clique sur Passer au paiement. Le navigateur de Jean est redirigé vers le site PayPal. Si Jean possède un compte PayPal,
il entre son adresse email et son mot de passe, puis clique sur Connexion pour accéder aux informations enregistrées sur son compte. Jean n’ayant pas de compte PayPal, il saisit ses informations de facturation et clique sur Continuer.
Guide d’intégration de Paiements sur site marchand Août 2006 79
Payer plusieurs objets : le Panier
Exemple de code HTML pour le panier hébergé par PayPal
FIGURE 4.33 Exemple de panier tiers : Entrer les informations de facturation ou se
connecter à son compte PayPal
80 Août 2006 Guide d’intégration de Paiements sur site marchand
Payer plusieurs objets : le Panier
Exemple de code HTML pour le panier hébergé par PayPal
Jean est dirigé vers une page récapitulative contenant les détails de son paiement.
FIGURE 4.34 Exemple de panier tiers : Page récapitulative
Etant donné que DesignerFotos a activé ses préférences en matière de livraison pour l’ensemble de ses transactions, les frais d’expédition et de livraison sont ajoutés à la commande. Pour en savoir plus sur le calcul des frais d’expédition et de livraison, reportez-vous à la section « Calcul
automatique des frais d’expédition et de traitement » page 45.
Jean clique sur Payer pour effectuer le paiement.
Guide d’intégration de Paiements sur site marchand Août 2006 81
Payer plusieurs objets : le Panier
Exemple de code HTML pour le panier hébergé par PayPal
Jean est dirigé vers une page de remerciement. Comme Jean n’a pas encore de compte PayPal, il peut choisir d’en ouvrir un sur cette page en
entrant son adresse email, puis en sélectionnant un mot de passe et enfin en cliquant sur Ouvrir un compte.
FIGURE 4.35 Exemple de panier : page de remerciement après le paiement
Jean reçoit un avis de réception par email relatif à cette transaction, confirmant son paiement et comprenant une copie des détails du paiement.
82 Août 2006 Guide d’intégration de Paiements sur site marchand
Payer plusieurs objets : le Panier
Exemple de code HTML pour le panier hébergé par PayPal
FIGURE 4.36 Exemple : Avis de réception par email

Ce que vous voyez à l’écran

DesignerFotos reçoit une notification par email du paiement de Jean.
FIGURE 4.37 Exemple : Avis de réception par email du vendeur
DesignerFotos (le vendeur de l’utilisateur@designerfotos.com) peut également visualiser le paiement dans l’Historique du compte PayPal.
Guide d’intégration de Paiements sur site marchand Août 2006 83
Payer plusieurs objets : le Panier

Ajouter PayPal à votre panier tiers

Ajouter PayPal à votre panier tiers
Au lieu d’utiliser le Panier PayPal, certains développeurs souhaitent intégrer la procédure de paiement à leur propre panier tiers. Cette section contient les informations requises pour permettre à vos acheteurs de payer avec PayPal lorsqu’ils ont ajouté tous leurs objets à votre panier tiers et qu’ils sont prêts à payer.

Variables de votre panier tiers

Votre formulaire FORM requiert au minimum les variables cachées suivantes. Pour obtenir la liste complète des variables, reportez-vous à l’Annexe A, « Variables HTML de Paiements sur
site marchand ».
TABLEAU 4.7 Variables de votre panier tiers
Nom Description
amount_1 Prix de l’objet ou prix total de tous les objets du panier
business Adresse email associée à votre compte PayPal
item_name_1 Nom de l’objet ou nom du panier
upload Indique l’utilisation d’un panier tiers
Il existe deux manières d’intégrer votre panier tiers à la procédure de paiement PayPal :
z transmettre les informations relatives à chaque objet ; z transmettre le montant total du panier, plutôt que celui de chaque objet.

Transmettre les informations relatives à chaque objet à PayPal

Si vous pouvez configurer votre panier tiers pour transmettre les caractéristiques de chaque objet à PayPal, les informations sur les objets seront incluses dans l’historique des transactions, ainsi que dans les notifications de l’acheteur et du vendeur.
1. Définissez la variable cmd sur _cart.
2. Ajoutez la variable upload :
<input type="hidden" name="upload" value="1">
3. Définissez les détails de chaque objet présent dans le panier.
84 Août 2006 Guide d’intégration de Paiements sur site marchand
Payer plusieurs objets : le Panier
Ajouter PayPal à votre panier tiers
Spécifiez les variables obligatoires et toute variable facultative répertoriée(s) dans le
Tableau A.20, « Variables HTML : pour chaque objet des paniers tiers » page 126. Ajoutez _
au nom de la variable, où d’une unité pour chaque objet ajouté au panier. Le premier objet du panier doit être défini avec des variables se terminant par _1, telles que item_name_1, amount_1 et quantity_1 ; le deuxième objet avec des variables telles que item_name_2, amount_2 et quantity_2 ; le troisième objet avec des variables telles que item_name_3, amount_3 et quantity_3 ; etc.
IMPORTANT :Les valeurs _x doivent être incrémentées d’une unité de manière continue
pour être reconnues. Si vous passez directement de l’objet 1 à l’objet 3 sans définir d’objet 2, le troisième objet est ignoré.
Le code HTML minimum requis pour votre publication sur PayPal se présente comme suit :
EXEMPLE 4.5 Code HTML pour transmettre les informations relatives à chaque objet
à PayPal
<form action=”https://www.paypal.com/fr/cgi-bin/webscr” method=”post”>
<input type=”hidden” name=”cmd” value=”_cart”> <input type=”hidden” name=”upload” value=”1”> <input type=”hidden” name=”business” value=”seller@designerfotos.com”> <input type=”hidden” name=”item_name_1” value=”Item Name 1”> <input type=”hidden” name=”amount_1” value=”1.00”> <input type=”hidden” name=”item_name_2” value=”Item Name 2”> <input type=”hidden” name=”amount_2” value=”2.00”> <input type=”submit” value=”PayPal”>
</form>
x est le numéro de l’objet, commençant par 1 et s’incrémentant
x
Définir la devise du panier
Toutes les variables monétaires (amount_x., shipping_x., shipping2_x, handling_x,
x et tax_cart) sont interprétées dans la devise définie par la variable currency_code
tax_
publiée avec le paiement. La variable currency_code n’étant pas spécifique à l’objet, il n’est pas nécessaire de lui ajouter un _
x. Si aucune variable currency_code n’est publiée,
toutes les valeurs monétaires sont par défaut en Dollars USD.
Appliquer la TVA à chaque objet
Utilisez la variable tax_x pour spécifier la TVA applicable à cet objet en particulier dans le panier. Par exemple, la ligne suivante spécifie que la TVA appliquée à l’objet 2 du panier est de 15 cents :
<INPUT TYPE=”hidden” name=”tax_2” value=”.15”>

Appliquer la TVA au panier dans son ensemble

Utilisez la variable tax_cart pour spécifier la TVA qui s’applique à l’intégralité du panier plutôt qu’à chaque objet. La variable tax_cart remplace toute taxe relative à chaque objet spécifiée par tax_
x.
Guide d’intégration de Paiements sur site marchand Août 2006 85
Payer plusieurs objets : le Panier
Ajouter PayPal à votre panier tiers

Transmettre le montant total du panier à PayPal

Vous pouvez regrouper le contenu de votre panier et transmettre le montant total à PayPal. Vous devez publier une seule variable item_name_1 pour le panier entier ou le prix total du contenu du panier avec amount_1 comme s’il s’agissait de l’achat d’un seul objet.
REMARQUE : L’un des inconvénients de cette méthode est que vos acheteurs ne verront pas
les différents objets présents dans leur panier. De plus, vous ne pouvez pas modifier les noms de variable et vous ne pouvez pas ajouter vos propres noms de variable.
Le code HTML suivant est identique à celui de la section « Code HTML pour transmettre les
informations relatives à chaque objet à PayPal » page 85, excepté que les montants et les noms
des différents objets ont été rassemblés en un seul objet et un seul montant.
EXEMPLE 4.6 Code HTML pour rassembler sous un panier global les informations
transmises à PayPal
<form action=”https://www.paypal.com/fr/cgi-bin/webscr” method=”post”>
<input type=”hidden” name=”cmd” value=”_cart”> <input type=”hidden” name=”upload” value=”1”> <input type=”hidden” name=”business” value=”seller@designerfotos.com”> <input type=”hidden” name=”item_name_1” value=”Aggregated items”> <input type=”hidden” name=”amount_1” value=”3.00”> <input type=”submit” value=”PayPal”>
</form>
86 Août 2006 Guide d’intégration de Paiements sur site marchand
5

Utiliser la fonction Autorisation et collecte avec Paiements sur site marchand

Autorisation et collecte PayPal est une solution de règlement offrant aux marchands davantage de flexibilité pour obtenir le paiement de leurs acheteurs. Lors d’un achat classique via PayPal, l’autorisation et la collecte sont effectuées simultanément. Autorisation et collecte PayPal sépare l’autorisation de paiement de la collecte du paiement autorisé.
Autorisation et collecte s’adresse aux marchands dont le traitement des commandes est différé et qui prélèvent en général €1 pour l’autorisation lors du paiement. Cette opération permet aux marchands de modifier le montant dû associé à l’autorisation initiale afin d’appliquer les changements effectués après la commande initiale (tels que les taxes, les frais d’expédition ou la disponibilité de l’objet). Ce chapitre vous guide tout au long des étapes d’autorisation, de collecte, de nouvelle autorisation et d’annulation de fonds.
Il existe deux manière d’utiliser Autorisation et collecte :
1. Créer une commande ou une autorisation avec Paiements sur site marchand HTML et collecter ou annuler l’autorisation sur le site PayPal (
https://www.paypal.fr/).
2. Utiliser l’API (Application Programming Interface) Autorisation et collecte. Pour en savoir plus sur l’API Autorisation et collecte, reportez vous au Guide d’intégration de Paiements sur site marchand.
Guide d’intégration de Paiements sur site marchand Août 2006 87
Utiliser la fonction Autorisation et collecte avec Paiements sur site marchand

Procédure d’autorisation de base

Procédure d’autorisation de base
La procédure d’autorisation et de collecte de base se déroule comme suit.
FIGURE 5.38 Procédure Autorisation et collecte de base
Autorisation et collecte commence lorsque l’acheteur autorise un montant de paiement lors du paiement.
1. Par exemple, vous pouvez envoyer votre acheteur vers la procédure de Paiements sur site marchand, transférant la variable paymentaction réglée sur authorization ou order.
2. Une fois que votre acheteur a effectué la procédure de paiement, vous pouvez utiliser le numéro de transaction Autorisation et collecte sur le site de PayPal ( Vous pouvez :
z collecter un montant partiel ou le montant total de l’autorisation ; z autoriser un montant plus élevé, jusqu’à 115 % du montant autorisé à l’origine (dans la
limite de l’équivalent de $75 USD en plus) ;
z annuler une autorisation antérieure.

Période de validité du paiement et Période d’autorisation

Lorsque votre acheteur approuve une autorisation, son solde peut être bloqué pendant 29 jours pour garantir la disponibilité du montant autorisé pour la collecte. Vous pouvez autoriser à nouveau une transaction une seule fois, jusqu’à 115 % du montant autorisé initialement (dans la limite de l’équivalent de $75 USD en plus).
Après une nouvelle autorisation réussie, PayPal honore 100 % des fonds autorisés pendant trois jours. Cette période démarre avec le jour calendaire au cours duquel l’autorisation ou la nouvelle autorisation a été accordée (de midi à 23 h 50, heure Pacifique).
https://www.paypal.fr).
88 Août 2006 Guide d’intégration de Paiements sur site marchand
Utiliser la fonction Autorisation et collecte avec Paiements sur site marchand
Vous pouvez effectuer un règlement sans nouvelle autorisation du jour 4 au jour 29 de la période d’autorisation, mais PayPal ne peut pas garantir que 100 % des fonds seront disponibles après la période de trois jours de validité du paiement. Cependant, PayPal ne vous permet pas de collecter des fonds si le compte de l’acheteur est restreint, bloqué, fait l’objet d’un dossier signalant une fraude, ou si votre compte est restreint à un degré élevé. Vous pouvez utiliser la fonction Autorisation et collecte uniquement si votre compte est restreint à un faible degré.
La période de validité du paiement et la période d’autorisation sont définies comme suit : Si vous tentez de collecter des fonds en dehors de la période de validité du paiement, PayPal
s’efforce de les collecter pour vous. Cependant, il se peut que ces fonds ne soient pas disponibles à ce moment précis.
Les comptes de l’acheteur et du vendeur ne peuvent pas être clôturés si une autorisation est en attente (règlement non effectué).

Produits de paiement PayPal acceptés

Vous pouvez utiliser la fonction Autorisation et collecte avec les produits PayPal répertoriés dans le Tableau 5.8, « Produits PayPal acceptant Autorisation et collecte ».
Procédure d’autorisation de base
Par défaut, ces produits supposent qu’une transaction est une vente finale. Vous devez spécifier explicitement si une transaction est une autorisation de base ou de commande.
REMARQUE : Vous devez capturer et annuler les commandes et les autorisations de
commande à l’aide des API de la fonction Autorisation et collecte. Autrement dit, vous ne pouvez procéder à des autorisations de commande sur le site PayPal (
https://www.paypal.fr). Le site PayPal ne prend en charge que les autorisations
de base, pas les autorisations de commande.
TABLEAU 5.8 Produits PayPal acceptant Autorisation et collecte
Produit Utilisation type
Paiements sur site marchand
Acheter maintenant
Dons
Paniers
paymentaction=”authorization”
paymentaction=”authorization”
paymentaction=”authorization”
paymentaction=”authorization”
Guide d’intégration de Paiements sur site marchand Août 2006 89
Utiliser la fonction Autorisation et collecte avec Paiements sur site marchand

Scénarios de la fonction Autorisation et collecte de base

Scénarios de la fonction Autorisation et collecte de base
A titre d’exemple, quelques scénarios fréquents que vous pouvez expérimenter lors de l’intégration des autorisations et collectes de base.

Collecter une autorisation unique

Si vous avez autorisé une transaction, vous devez collecter les fonds pour recevoir le paiement.
REMARQUE : PayPal vous recommande de collecter les paiements dans les trois jours suivant
l’autorisation initiale.
Pour initier une collecte :
1. Accédez à l’Historique de votre compte sur
2. Cliquez sur le bouton Collecter associé à la transaction en question.
3. Vérifiez les informations sur la page Collecter des fonds, saisissez le montant à collecter,
puis cliquez sur Collecter des fonds.
Les fonds sont transférés sur votre compte.

Collecter par lots plusieurs autorisations

Sur https://www.paypal.fr, vous pouvez initier simultanément la collecte d’un groupe entier de transactions autorisées. Cette fonction est désignée sous le nom de collecte par lots.
Pour collecter un lot de transactions autorisées :
1. Accédez à l’Historique de votre compte sur
2. Cliquez sur le bouton Collecter associé à la transaction en question.
https://www.paypal.fr.
https://www.paypal.fr.
3. Sur la page qui apparaît, cliquez sur Collecte par lots dans le paragraphe d’introduction.
90 Août 2006 Guide d’intégration de Paiements sur site marchand
Utiliser la fonction Autorisation et collecte avec Paiements sur site marchand
Scénarios de la fonction Autorisation et collecte de base
4. Sur la page qui apparaît, sélectionnez une date définie ou une période dans le menu déroulant, ou saisissez-en une dans les champs prévus à cet effet.
5. Sur la page à l’écran, vérifiez les autorisations que vous souhaitez collecter, définissez le montant à collecter, déterminez si vous envisagez une collecte supplémentaire ultérieurement et entrez le cas échéant une remarque à l’attention de l’acheteur.
6. Vérifiez les transactions à collecter, effectuez les modifications souhaitées et soumettez-les à la procédure de collecte.

Annuler une autorisation

Si vous avez initié une autorisation et que vous désirez à présent rembourser le client, vous devez annuler l’autorisation. Une fois l’autorisation annulée, vous ne pouvez collecter aucun fond associé à cette autorisation et les fonds sont retransmis au client.
REMARQUE : L’annulation d’une autorisation porte sur le montant total de l’autorisation
ouverte.
Vous pouvez initier une annulation dans les cas suivants :
z l’autorisation est en attente ; z le montant autorisé a été collecté à moins de 100 %.
Guide d’intégration de Paiements sur site marchand Août 2006 91
Utiliser la fonction Autorisation et collecte avec Paiements sur site marchand
Scénarios de la fonction Autorisation et collecte de base
Pour annuler une autorisation :
1. Cliquez sur le bouton Annuler associé à l’autorisation.
2. Confirmez les détails de l’annulation dans la page Annulation d’autorisation et cliquez
sur Annuler.
REMARQUE : PayPal vous recommande d’expliquer chaque cas particulier à votre acheteur
dans le champ Remarque.
PayPal envoie un email contenant les détails de l’annulation à votre client.

Collecter dans les 3 jours

1. Votre acheteur commande un appareil photo sur votre site.
2. Votre acheteur entre les informations de paiement et autorise le paiement.
3. Vous renvoyez votre acheteur sur le site PayPal en spécifiant
paymentaction=authorization.
4. PayPal initie l’autorisation.
5. Le jour 3, vous expédiez l’appareil photo et collectez les fonds.
Une fois les fonds collectés, les Détails de la transaction indiquent que celle-ci est Terminée.
FIGURE 5.39 Détails de la transaction : Terminée

Collecter entre le 4ème et 29ème jour

1. Votre acheteur commande un lecteur de DVD sur votre site.
2. Vous renvoyez votre acheteur sur le site PayPal en spécifiant
paymentaction=authorization.
3. Votre acheteur entre les informations de paiement et autorise le paiement.
92 Août 2006 Guide d’intégration de Paiements sur site marchand
Utiliser la fonction Autorisation et collecte avec Paiements sur site marchand
Scénarios de la fonction Autorisation et collecte de base
4. PayPal initie l’autorisation.
5. Le lecteur de DVD n’est plus disponible. Vous commandez un lecteur de DVD différent à
votre fournisseur et notifiez votre acheteur de ce changement.
6. Le jour 14, le lecteur de DVD arrive de chez votre fournisseur. Etant donné que la période de validité du paiement est terminée, vous effectuez une nouvelle autorisation pour le paiement. Vous expédiez le lecteur de DVD et effectuez la collecte finale.
Les Détails de la transaction indiquent que la transaction est Terminée.
FIGURE 5.40 Détails de la transaction : nouvelle autorisation, collecte finale

Une autorisation, plusieurs collectes et un remboursement

1. Votre acheteur commande deux manuels et un clavier sur votre site.
2. Votre acheteur entre les informations de paiement et autorise le paiement.
3. Vous renvoyez votre acheteur sur le site PayPal en spécifiant
paymentaction=authorization.
4. PayPal initie l’autorisation.
5. L’un des manuels et le clavier sont en rupture de stock. Vous les commandez auprès de vos
fournisseurs. Vous expédiez le manuel en stock et effectuez la première collecte partielle le jour 6.
6. Vous recevez le second manuel de votre fournisseur. Vous expédiez le second manuel et effectuez la deuxième collecte partielle le jour 11.
7. Vous recevez le clavier de votre fournisseur. Vous effectuez une nouvelle autorisation le jour 19.
8. Votre acheteur dépose une réclamation indiquant que le manuel du premier colis est endommagé. Vous effectuez un remboursement partiel de la première collecte.
Guide d’intégration de Paiements sur site marchand Août 2006 93
Utiliser la fonction Autorisation et collecte avec Paiements sur site marchand
Scénarios de la fonction Autorisation et collecte de base
Les Détails de la transaction indiquent les informations suivantes :
FIGURE 5.41 Détails de la transaction : collecte partielle, nouvelle autorisation,
remboursement

Diminuer le montant collecté

1. Votre acheteur commande une imprimante laser et un câble USB sur votre site.
2. Votre acheteur entre les informations de paiement et autorise le paiement.
3. Vous renvoyez votre acheteur sur le site PayPal en spécifiant
paymentaction=authorization.
4. PayPal initie l’autorisation.
5. Avant d’effectuer la transaction, votre acheteur vous contacte et vous demande d’annuler la
commande du câble USB.
6. Le jour 6, vous expédiez l’imprimante laser et effectuez une collecte partielle d’un montant inférieur au montant autorisé initialement.
7. Vous annulez les fonds autorisés restants.
94 Août 2006 Guide d’intégration de Paiements sur site marchand
Utiliser la fonction Autorisation et collecte avec Paiements sur site marchand
Les Détails de la transaction indiquent les informations suivantes :
FIGURE 5.42 Détails de la transaction : collecte partielle, transaction annulée

Collecter jusqu’à 115 %

Scénarios de la fonction Autorisation et collecte de base
1. Votre acheteur effectue une commande sur votre site.
2. Votre acheteur entre les informations de paiement et autorise le paiement.
3. Vous renvoyez votre acheteur sur le site PayPal en spécifiant
paymentaction=authorization.
4. PayPal initie l’autorisation.
5. Vous ajoutez les frais d’expédition et de livraison à votre commande et collectez les
fonds le jour 1.
Les Détails de la transaction indiquent que celle-ci est Terminée. Au total, la collecte ne dépasse pas 115 % du montant autorisé initialement.
FIGURE 5.43 Détails de la transaction : Collecter jusqu’à 115 %
Guide d’intégration de Paiements sur site marchand Août 2006 95
Utiliser la fonction Autorisation et collecte avec Paiements sur site marchand
Scénarios de la fonction Autorisation et collecte de base

Expiration de l’autorisation

1. Votre acheteur commande un ordinateur de bureau sur votre site.
2. Votre acheteur entre les informations de paiement et autorise le paiement.
3. Vous renvoyez votre acheteur sur le site PayPal en spécifiant
paymentaction=authorization.
4. PayPal initie l’autorisation.
5. Avant d’effectuer la transaction, votre acheteur vous contacte et vous demande d’annuler la
commande.
6. Vous ne collectez pas les fonds pour la transaction.
7. L’autorisation arrive à expiration.
Les Détails de la transaction indiquent « Expirée ».
FIGURE 5.44 Détails de la transaction : autorisation expirée

Annuler

1. Votre acheteur commande un appareil stéréo sur votre site.
2. Votre acheteur entre les informations de paiement et autorise le paiement.
3. Vous renvoyez votre acheteur sur le site PayPal en spécifiant
paymentaction=authorization.
4. PayPal initie l’autorisation.
5. Avant d’effectuer la transaction, votre acheteur vous contacte et vous demande d’annuler la
commande.
6. Vous annulez la transaction.
96 Août 2006 Guide d’intégration de Paiements sur site marchand
Utiliser la fonction Autorisation et collecte avec Paiements sur site marchand
Scénarios de la fonction Autorisation et collecte de base
Votre Historique indique que la transaction est Annulée.
FIGURE 5.45 Historique : transaction annulée

Tenter à nouveau une collecte

1. Votre acheteur commande deux sweatshirts sur votre site.
2. Votre acheteur entre les informations de paiement et autorise le paiement.
3. Vous renvoyez votre acheteur sur le site PayPal en spécifiant
paymentaction=authorization.
4. PayPal initie l’autorisation.
Guide d’intégration de Paiements sur site marchand Août 2006 97
Utiliser la fonction Autorisation et collecte avec Paiements sur site marchand
Scénarios de la fonction Autorisation et collecte de base
5. Le jour 3, vous tentez de collecter les fonds, mais la collecte échoue. Vous recevez un message d’erreur tel que le suivant :
FIGURE 5.46 Erreur lors de la collecte
6. Le compte de l’acheteur a été restreint. Vous contactez l’acheteur pour résoudre le problème.
7. Votre acheteur résout le problème sur son compte.
8. Vous tentez à nouveau la collecte et réussissez à collecter les fonds. Vous expédiez
la commande à votre acheteur.
REMARQUE : Le scénario de nouvelle autorisation est similaire à celui de la nouvelle tentative
de collecte détaillé ci-dessus.
98 Août 2006 Guide d’intégration de Paiements sur site marchand
Utiliser la fonction Autorisation et collecte avec Paiements sur site marchand

Recommandations d’utilisation Autorisation et collecte

Recommandations d’utilisation Autorisation et collecte
Cette section propose des recommandations pour garantir la meilleure utilisation possible par vos clients et optimiser la procédure d’Autorisation et collecte.

Collecter des fonds faisant l’objet d’autorisations de base

PayPal vous recommande de collecter les fonds dans les trois jours suivant la transaction, car il s’agit de la période de validité du paiement au cours de laquelle PayPal garantit les fonds après une autorisation de base. Si vous tentez de collecter les fonds après ces trois jours et que l’autorisation échoue, votre demande de collecte de fonds peut être rejetée.
Après le jour 4 de la période d’autorisation, vous pouvez initier une nouvelle autorisation, qui démarrera une nouvelle période de validité du paiement de trois jours. Cependant, cette opération n’étendra pas la période d’autorisation initiale une fois ses 29 jours écoulés. Par exemple, si vous réussissez à effectuer une nouvelle autorisation le jour 29 de la période d’autorisation, les fonds ne seront honorés que jusqu’à la fin du jour 29.
Il est vivement recommandé de collecter les fonds dans les 24 heures suivant l’expédition de la commande de votre acheteur.

Approbation de l’acheteur pour les autorisations de base

Une autorisation initiée par un acheteur vous permet de collecter les fonds du compte de l’acheteur jusqu’à 115 % du montant autorisé initialement (ne devant pas dépasser une augmentation de l’équivalent de $75 USD) et jusqu’à $10 000 USD.
IMPORTANT :Si vous souhaitez mettre à jour n’importe quel détail de l’achat susceptible
de modifier le montant autorisé initialement, PayPal vous demande d’obtenir le consentement de l’acheteur au moment de l’achat ou au moment de la collecte.

Annuler les autorisations de base

Si vous pensez qu’une autorisation ou une nouvelle autorisation ne sera pas utilisée, nous vous recommandons vivement de l’annuler. L’annulation de l’autorisation débloque les sources d’approvisionnement de votre acheteur temporairement bloquées.
Guide d’intégration de Paiements sur site marchand Août 2006 99
Utiliser la fonction Autorisation et collecte avec Paiements sur site marchand
Recommandations d’utilisation Autorisation et collecte
100 Août 2006 Guide d’intégration de Paiements sur site marchand
Loading...