Sites Marchands 2006 | Mode d'emploi | PayPal Sites Marchands 2012 Manuel utilisateur
Ajouter à Mes manuels140 Des pages
▼
Scroll to page 2
of
140
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é : PayPal Inc. fournit les informations de ce manuel en l’état. PayPal Inc. ne fournit de quelque manière que ce soit (expresse, tacite ou légale) aucune garantie résultant de ces informations. PayPal, Inc. n’assume aucune responsabilité en cas d’erreurs ou d’omissions pour tous dommages (directs ou indirects), résultant de l’utilisation de ce manuel ou des informations qu’il contient ou résultant de l’application ou de l’utilisation du produit ou du service décrit dans ce document. PayPal Inc. se réserve le droit de modifier les informations de ce manuel sans préavis. PayPal Inc. ne garantit pas que les fonctionnalités décrites dans ce manuel seront annoncées ou mises à disposition de tous à l’avenir. 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 Sommaire 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 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 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 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 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 . . . . . . . . . . . . 89 . . . . . . . . 113 . . . . . . . . . . . . . . . . .126 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 Figure 1.3 Le client se connecte à PayPal . . . . . . . . . . . . . . . . 19 Figure 1.4 Le client vérifie les détails du paiement 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 Figure 2.8 Récapitulatif des Préférences 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 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 Figure 2.16 Ajouter le nom figurant sur le relevé de carte bancaire 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 Figure 2.20 Préférence de langue du site 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 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 . . . . 18 . . . . . . . . . . . 20 . . . . . . . . . . . 22 . . . . . . . . . . . . . . . . 29 . . . . . . . . . . . . . . . 33 . . . . . . . . . . . 48 . . . . 50 . . . . . . 53 . . . . . . . . . . . . . . . . 53 . . . . . . . . 56 9 Liste des figures 10 Figure 4.26 Exemple de panier hébergé par PayPal : sur le site de PayPal . . . . . . . . . . . . . . . . . . . . . . . . . 69 Figure 4.27 Exemple de panier hébergé par PayPal : saisie des informations de facturation . . . . . . . . . . . . . . . . . 70 Figure 4.28 Exemple de panier hébergé par PayPal : page récapitulative . . . . . . . . . . . . . . . . . . . . . . . 71 Figure 4.29 Exemple de panier hébergé par PayPal : page de remerciement après le paiement . . . . . . . . . . . . . . 72 Figure 4.30 Exemple de panier hébergé par PayPal : avis de réception par email . . . . . . . . . . . . . . . . . . . . . . . . . 73 Figure 4.31 Exemple de panier tiers : Ajouter au panier Figure 4.32 Exemple de panier tiers : Passer au paiement Figure 4.33 Exemple de panier tiers : Entrer les informations de facturation ou se connecter à son compte PayPal Figure 4.34 Exemple de panier tiers : Page récapitulative . . . . . . . . . 81 Figure 4.35 Exemple de panier : page de remerciement après le paiement . . . . . . . . . . . . . . . . . . . . . . . . 82 Figure 4.36 Exemple : Avis de réception par email . . . . . . . . . . . . 83 Figure 4.37 Exemple : Avis de réception par email du vendeur 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 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 Août 2006 . . . . . . . . . 78 . . . . . . . . 79 . . . . . 80 . . . . . . 83 . . . . . . . . . . . . . . . . . . 98 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 P Préface 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 Utilisation italique sérif Titre de document. Terme traité ou défini Exemple : Un fichier est un flux de données sous forme de caractères lisibles ou inscriptibles. Valeurs booléennes (pas les mots-clés). Exemple : La fonction renvoie la valeur true si une erreur se produit. police à espacement constant Chemins d’accès aux fichiers ou noms de fichier apparaissant dans le corps du texte. Noms associés au code apparaissant dans le corps du texte. Ces noms sont utilisés pour les fonctions, les rappels, les arguments, les structures de données et les champs. Exemple : AbstractResponseType est le type de réponse SOAP sur lequel sont basés tous les modes de réponse API de PayPal. Composants de requêtes et de réponses de protocole Internet, tels que les variables HTTPS et FORM. Exemple : Le système PayPal utilise une requête method=POST pour renvoyer les variables d’état NIP relatives aux abonnements, telles que txn_type. Guide d’intégration de Paiements sur site marchand Août 2006 13 Préface Problèmes relatifs à la documentation Type de caractère Utilisation gras sérif Noms d’interfaces utilisateur, tels que les noms de fenêtres ou les options de menus. Exemple : Dans la page Préférences, cliquez sur Email pour confirmer votre adresse email. oblique san-sérif Espaces réservés utilisés dans le contexte d’un format, ou norme de programmation, ou descriptions formelles de la syntaxe du système PayPal. Les espaces réservés indiquent les valeurs ou les noms que l’utilisateur doit fournir. Exemple : Par exemple, amount est la variable d’un panier contenant un seul objet, mais amount_X est le nom de la variable d’un panier contenant plusieurs objets. amount_3 est le montant du troisième objet dans un panier contenant plusieurs objets. Outre les types de caractères décrits ci-dessus, les mots et les phrases de ce document peuvent également apparaître en gras ou soulignés, auquel cas ils donnent des informations supplémentaires. Ces informations sont décrites ci-dessous : Attribut du texte Utilisation xxxxxx Lien hypertexte vers une page du document actuel ou vers un autre document de l’ensemble. xxxxxx Lien hypertexte vers une URL ou démarrant une action Web, telle que l’envoi d’un email. Problèmes relatifs à la documentation Si vous 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 https://developer.paypal.com/ en entrant votre 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. 14 Août 2006 Guide d’intégration de Paiements sur site marchand Préface Premiers pas : Centre d’intégration 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 Date Description Août 2006 Nouvelle variable pour le panier PayPal : shopping_url La valeur _ext-enter de la variable cmd pour la pré-saisie du formulaire (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/. Différentes mises à jour. 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. 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 http://www.paypal.fr pour lui 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 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 R e c e v o i r v o t r e pa i e m e n t 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 Présentation des Paiements sur site marchand Comment utiliser ce guide 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 z z Terminée : la transaction a réussi et l’argent a été crédité sur votre compte Compensée : le paiement a compensé le compte de l’expéditeur et a été crédité sur votre compte 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. 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 section « Notification instantanée de paiement : notify_url » page 116 et le Guide d’intégration de la 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. 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. Chapitre 3, « Payer un seul objet : Boutons Acheter maintenant et Dons » 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 FORM à utiliser dans votre propre panier. Chapitre 4, « Payer plusieurs objets : le Panier » Autorisation et collecte Permet d’autoriser un paiement et de le collecter ultérieurement sur le site PayPal. Chapitre 5, « Utiliser la fonction Autorisation et collecte avec Paiements sur site marchand » Personnaliser les pages de paiement 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. « Conserver l’apparence de votre boutique sur les pages de paiement PayPal » page 31 « Compte PayPal facultatif » ou Paiements express sur site marchand 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. « Compte PayPal facultatif » page 37 Renvoi automatique Paramètre dans les Préférences de votre compte qui élimine la page PayPal d’avis de réception du paiement Figure 1.1, « Séquence de base de « Renvoi automatique » page 43 Calcul automatique des frais d’expédition et de livraison, des frais de dossier et des taxes 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. « Calcul automatique des frais d’expédition et de traitement » page 45 Numéro de téléphone à contacter 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. « Obtenir les numéros de téléphone à contacter auprès de vos clients » page 50 Accès multi-utilisateur Paramètre dans les Préférences de votre compte qui permet de partager l’accès à votre compte Business avec plusieurs adresses email (jusqu’à sept). « Accès multi-utilisateur à votre compte PayPal » page 55 Paiements sur site marchand cryptés Permet de crypter les informations de paiement avant de les envoyer à PayPal pour protéger les données de votre client. Chapitre 7, « Paiements sur site marchand cryptés » pages parcourues lors de l’utilisation de Paiements sur site marchand ». 24 Août 2006 Guide d’intégration de Paiements sur site marchand Présentation des Paiements sur site marchand Premiers pas : Centre d’intégration Autres produits et fonctions standard Paiements sur site marchand comprend également d’autres produits et fonctions non détaillés dans ce guide : z 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. 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. 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 https://www.paypal.com/fr/cgi-bin/webscr?cmd=p/gen/ua/ua-outside Aide en ligne https://www.paypal.com/fr/help 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 TABLEAU 1.4 Titre du guide Description A lire au préalable Guide d’intégration de Paiements express PayPal 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 Guide d’intégration de Paiements sur site marchand Guide d’intégration de la gestion des commandes 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 FORM de la NIP et leur signification. Comprend également des informations relatives à l’Historique téléchargeable. https://www.paypal.com/fr_FR/FR/pdf/PP_OrderManagement_Integ rationGuide.pdf Guide d’intégration de Paiements sur site marchand 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 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 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 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 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 Août 2006 Tous les autres guides PayPal pour une bonne compréhension du produit. Guide d’intégration de Paiements sur site marchand Présentation des Paiements sur site marchand Documentation technique complémentaire TABLEAU 1.4 Titre du guide Description A lire au préalable Guide de référence des API 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 N/A Guide d’utilisation des Abonnements et paiements récurrents Décrit les variables HTML FORM nécessaires à l’utilisation de PayPal pour le paiement d’abonnements à des biens et services. https://www.paypal.com/fr_FR/FR/pdf/subscriptions.pdf 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 2 Utiliser les préférences et outils 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 30 « 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 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 page_style de votre formulaire HTML pour votre bouton de Paiement sur 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. IMPO RTANT : 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. – 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 #. 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. R E M A R Q U E : 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 Variables de personnalisation des pages de paiement pour chaque transaction Reportez-vous au Tableau A.17, « Variables 2 Style de page principal pour certaines transactions 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. 3 Style de page principal dans les 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 Le style de page par défaut est utilisé lorsqu’aucun autre style n’est sélectionné et désigné comme principal. 1 Guide d’intégration de Paiements sur site marchand HTML : informations sur l’affichage » page 121. Août 2006 35 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 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 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 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. R E M A R Q U E : 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 Votre 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é. R E M A R Q U E : Si l’URL de renvoi indiquée n’est pas correcte, PayPal affiche la page Votre 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. R E M A R Q U E : 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 Taxes/TVA 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 z z 48 Oui : Acceptez le paiement quelle que soit la devise dans laquelle il est effectué. Non, les accepter et les convertir Euro : Acceptez les paiements mais convertissez-les automatiquement Euro. 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. 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. IMPO RTANT : 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 Choix de la langue de vos données 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 : 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. R EMARQUE : 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. R EMARQUE : 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 56 Code Devise Montant maximum des transactions AUD Dollar australien 12 500 AUD CAD Dollar canadien 12 500 CAD EUR Euro 8 000 EUR 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 TABLEAU 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 58 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. 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 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. 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 https://www.paypal.fr. 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. 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. R E M A R Q U E : 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 droit de la souris. Si vos clients vous règlent par email : R E M A R Q U E : 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 IMPO RTANT : 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+Baseball&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&currency_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, https://www.paypal.fr/. 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é. Fonctionnement du panier hébergé par PayPal Cet exemple montre comment le panier hébergé par PayPal peut utiliser les fonctions suivantes : z 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. 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 https://www.paypal.fr. 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, entrezle 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. 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. R E M A R Q U E : 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 z 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é. Ouvrez le fichier de la page Web dans lequel vous souhaitez ajouter votre bouton Panier. 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 IMPO RTANT : 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 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. 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 _x au nom de la variable, où x est le numéro de l’objet, commençant par 1 et s’incrémentant 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. IMPO RTANT : 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> Définir la devise du panier Toutes les variables monétaires (amount_x., shipping_x., shipping2_x, handling_x, tax_x et tax_cart) sont interprétées dans la devise définie par la variable currency_code 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. R E M A R Q U E : 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 (https://www.paypal.fr). Vous pouvez : z z z collecter un montant partiel ou le montant total de l’autorisation ; autoriser un montant plus élevé, jusqu’à 115 % du montant autorisé à l’origine (dans la limite de l’équivalent de $75 USD en plus) ; annuler une autorisation antérieure. Période de validité du paiement et Période d’autorisation Lorsque votre acheteur approuve une autorisation, son solde peut être bloqué pendant 29 jours pour garantir la disponibilité du montant autorisé pour la collecte. Vous pouvez autoriser à 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). 88 Août 2006 Guide d’intégration de Paiements sur site marchand Utiliser la fonction Autorisation et collecte avec Paiements sur site marchand Procédure d’autorisation de base 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 ». Par défaut, ces produits supposent qu’une transaction est une vente finale. Vous devez spécifier explicitement si une transaction est une autorisation de base ou de commande. R E M A R Q U E : Vous devez capturer et annuler les commandes et les autorisations de commande à l’aide des API de la fonction Autorisation et collecte. Autrement dit, vous ne pouvez procéder à des autorisations de commande sur le site PayPal (https://www.paypal.fr). Le site PayPal ne prend en charge que les autorisations de base, pas les autorisations de commande. TABLEAU 5.8 Produits PayPal acceptant Autorisation et collecte Produit Utilisation type Paiements sur site marchand paymentaction=”authorization” Acheter maintenant paymentaction=”authorization” Dons paymentaction=”authorization” Paniers paymentaction=”authorization” 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. R E M A R Q U E : 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 https://www.paypal.fr. 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 https://www.paypal.fr. 2. Cliquez sur le bouton Collecter associé à la transaction en question. 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. R E M A R Q U E : 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. R E M A R Q U E : 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 Scénarios de la fonction Autorisation et collecte de base 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 % 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. R E M A R Q U E : 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. IMPO RTANT : Si vous souhaitez mettre à jour n’importe quel détail de l’achat susceptible de modifier le montant autorisé initialement, PayPal vous demande d’obtenir le consentement de l’acheteur au moment de l’achat ou au moment de la collecte. Annuler les autorisations de base Si vous pensez qu’une autorisation ou une nouvelle autorisation ne sera pas utilisée, nous vous recommandons vivement de l’annuler. L’annulation de l’autorisation débloque les sources d’approvisionnement de votre acheteur temporairement bloquées. 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 6 Effectuer des remboursements Lors d’un remboursement, le montant hors taxe du remboursement est envoyé à votre client. Le montant brut équivaut au montant net de la transaction initiale plus la commission remboursée par PayPal. Montant brut = Montant net + Commission remboursée Remboursement dans un délai de 60 jours à compter de la réception du paiement Vous pouvez rembourser le montant de tout ou partie d’une transaction. Si vous effectuez un remboursement dans les 60 jours, la commission sur la transaction initiale prélevée pour la réception du paiement est créditée sur votre compte. Pour les remboursements partiels, vous êtes crédités un pourcentage de la commission sur la transaction initiale calculé à partir du montant remboursé. Pour effectuer un remboursement dans un délai de 60 jours : 1. Connectez-vous à votre compte PayPal. 2. Cliquez sur le sous-onglet Historique. 3. Recherchez le paiement que vous souhaitez rembourser. 4. Cliquez sur le lien Détails sur la ligne de la transaction en question. 5. Cliquez sur le lien Rembourser le paiement dans la page Détails de la transaction. 6. Saisissez le montant du remboursement et cliquez sur Soumettre. 7. Vérifiez le montant du remboursement partiel et cliquez sur Procéder au remboursement. Si vous remboursez un paiement par chèque électronique en attente, aucun frais n’est débité car le paiement en attente est effectivement annulé. Guide d’intégration de Paiements sur site marchand Août 2006 101 Effectuer des remboursements Remboursement après 60 jours Remboursement après 60 jours Si vous effectuez un remboursement après 60 jours, la commission sur la transaction initiale prélevée pour la réception du paiement n’est pas créditée sur votre compte. Pour effectuer un remboursement après 60 jours : 1. Connectez-vous à votre compte PayPal. 2. Cliquez sur l’onglet Paiement. 3. Saisissez les informations requises. 4. Cliquez sur Continuer. 5. Vérifiez les informations sur la page de confirmation et cliquez sur Effectuer un paiement pour terminer le remboursement. 102 Août 2006 Guide d’intégration de Paiements sur site marchand 7 Paiements sur site marchand cryptés Pour une plus grande sécurité des paiements en ligne, vous pouvez créer des codes de bouton de Paiements sur site marchand cryptés à l’aide d’une clé de cryptage publique standard. Avec les clés publiques et privées, vous pouvez crypter de manière dynamique les informations de paiement avant de les envoyer à PayPal. Les paiements sur site marchand cryptés fonctionnent de la manière suivante. TABLEAU 7.9 Fonctionnement des paiements sur site marchand cryptés Le marchand Le client PayPal Clique sur le bouton « Payer », ce qui envoie les données du formulaire FORM signé et crypté vers l’URL de PayPal. Vérifie l’authenticité des données à l’aide de la clé publique téléchargée par le site marchand. 1. Crée une clé publique et la publie sur le site PayPal. Télécharge le certificat public de PayPal. 2. Crée des paires nom et valeur représentant les paramètres du formulaire HTML FORM à envoyer à PayPal lorsqu’un client clique sur l’un des boutons du site. 3. Crypte les paramètres du bouton avec la clé publique de PayPal et signe les données encryptées avec sa propre clé privée. 4. Publie le formulaire FORM signé et crypté sur son site avec un bouton « Payer ». Décrypte les données à l’aide de la clé privée de PayPal. Dirige le navigateur de l’acheteur vers la procédure de paiement PayPal indiquée dans les paramètres du bouton. Guide d’intégration de Paiements sur site marchand Août 2006 103 Paiements sur site marchand cryptés Conditions requises pour l’utilisation des Paiements sur site marchand cryptés Conditions requises pour l’utilisation des Paiements sur site marchand cryptés Cette section vous explique comment créer vos clés publiques et privées pour les Paiements sur site marchand cryptés, publier votre clé publique sur le site PayPal et télécharger une copie de la clé publique de PayPal : z générer une clé privée ; z générer un certificat public ; z publier votre certificat public sur le site PayPal https://www.paypal.com/fr/cgi-bin/webscr?cmd=_profile-website-cert ; z télécharger le certificat public de PayPal à partir du site https://www.paypal.com/fr/cgi-bin/webscr?cmd=_profile-website-cert. Présentation du cryptage à clé publique Le cryptage à clé publique (cryptage asymétrique) améliore la sécurité et simplifie l’utilisation en permettant aux émetteurs et aux bénéficiaires d’obtenir des clés de cryptage publiques et privées distinctes. z Clé publique : On appelle clé publique la partie d’une clé de cryptage asymétrique que les bénéficiaires envoient aux émetteurs qui souhaitent envoyer des informations encryptées. z Clé privée : On appelle clé privée la partie d’une clé de cryptage asymétrique que les bénéficiaires gardent secrète et ne communiquent à personne. Certificat public : Le certificat public se compose de la clé publique et d’informations sur l’identité de la personne, telles que son nom, qui peuvent toutes être signées par une autorité de certification (AC). L’AC garantit que la clé publique appartient à l’entité nommée. z Procédure de cryptage : Pour crypter les informations, les émetteurs utilisent aussi bien leur clé privée que la clé publique de leurs bénéficiaires. Les bénéficiaires utilisent leur clé privée et la clé publique des émetteurs pour décrypter les informations. Cette procédure de cryptage est utilisée avec des signatures numériques pour vérifier l’origine des informations. Configurer les certificats Pour les Paiements sur site marchand cryptés, vous devez publier votre certificat public sur le site PayPal, de façon à ce que le code crypté puisse être vérifié. PayPal n’accepte que les certificats publics X.509 et non les clés publiques. La différence entre une clé et un certificat réside dans le fait que le certificat ne comprend pas uniquement la clé, mais également des informations relatives à la clé, telles que sa date d’expiration et son propriétaire. PayPal accepte les certificats publics au format PEM OpenSSL de n’importe quelle autorité de certification reconnue, telle que Verisign. Vous pouvez également créer vos propres clé privée et certificat public à l’aide d’un logiciel libre tel que OpenSSL (http://www.openssl.org), dont vous trouverez une description détaillée à la section suivante. 104 Août 2006 Guide d’intégration de Paiements sur site marchand Paiements sur site marchand cryptés Configurer les certificats Créer votre clé privée avec OpenSSL Pour créer votre clé privée, saisissez la commande ci-après dans le logiciel openssl. Cette commande génère une clé privée RSA 1024 bits enregistrée dans le fichier my-prvkey.pem : openssl genrsa -out my-prvkey.pem 1024 Créer votre certificat public avec OpenSSL Il doit être au format PEM. Pour créer votre certificat, saisissez la commande openssl ci-après, permettant de générer un certificat public dans le fichier my-pubcert.pem : openssl req -new -key my-prvkey.pem -x509 -days 365 -out my-pubcert.pem Publier votre certificat public Pour publier votre certificat public sur le site PayPal : 1. Connectez-vous à votre compte PayPal Business ou Premier. 2. Cliquez sur le sous-onglet Préférences. 3. Dans la colonne Préférences des ventes, cliquez sur Certificats de cryptage pour site marchand. 4. Cliquez sur Ajouter. 5. Cliquez sur Parcourir, puis sélectionnez le certificat public que vous souhaitez télécharger. Une fois que votre certificat public a été publié correctement, il apparaît à l’écran suivant sous Vos certificats publics. FIGURE 7.47 Publier un certificat public pour les Paiements sur site marchand cryptés R E M A R Q U E : Une fois le certificat publié correctement, PayPal lui attribue un identifiant. Assurez-vous de conserver cet identifiant de certificat dans un endroit sûr. Il vous sera utile pour vos paiements sur site marchand cryptés. Guide d’intégration de Paiements sur site marchand Août 2006 105 Paiements sur site marchand cryptés Configurer les certificats Télécharger le certificat public de PayPal Pour télécharger le certificat public de PayPal : 1. Connectez-vous à votre compte PayPal Business ou Premier. 2. Cliquez sur le sous-onglet Préférences. 3. Dans la colonne Préférences des ventes, cliquez sur Certificats de cryptage pour site marchand. 4. A la section Certificat public de PayPal, cliquez sur Télécharger. FIGURE 7.48 Télécharger le certificat public de PayPal pour les Paiements sur site marchand cryptés Supprimer votre certificat public R E M A R Q U E : Si vous supprimez votre certificat public, l’identifiant qui lui est associé ne sera plus valable pour crypter des boutons et les boutons générés par votre site à l’aide de ce certificat ne fonctionneront plus correctement. Pour supprimer tout ou partie de vos certificats publics : 1. Connectez-vous à votre compte PayPal Business ou Premier. 2. Cliquez sur le sous-onglet Préférences. 3. Dans la colonne Préférences des ventes, cliquez sur Certificats de cryptage pour site marchand. 4. Sélectionnez l’un des certificats répertoriés, puis cliquez sur Supprimer. 5. A l’écran suivant, cliquez de nouveau sur Supprimer pour supprimer le certificat public sélectionné. 106 Août 2006 Guide d’intégration de Paiements sur site marchand Paiements sur site marchand cryptés Crypter votre code HTML Crypter votre code HTML PayPal fournit les logiciels Java et Windows pour crypter les variables FORM HTML de vos Paiements sur site marchand cryptés. Téléchargez un programme à l’adresse suivante : https://www.paypal.com/fr/cgi-bin/webscr?cmd=p/xcl/rec/ewp-code Une fois le logiciel téléchargé et exécuté, copiez votre clé privée, votre certificat public, le fichier p12 et le certificat public de PayPal dans le dossier du programme. 1. Préparez un fichier d’entrée des variables de Paiements sur site marchand pour chaque bouton crypté que vous souhaitez créer. Chaque variable et valeur doit être sur une ligne séparée, tel que dans l’exemple suivant. R E M A R Q U E : La variable cert_id identifie le certificat public que vous avez publié sur le site PayPal. cert_id=Z24MFU6DSHBXQ cmd=_xclick business=sales@company.com item_name=Handheld Computer item_number=1234 custom=sc-id-789 amount=500.00 currency_code=USD tax=41.25 shipping=20.00 address_override=1 address1=123 Main St city=Austin state=TX zip=94085 country=US no_note=1 cancel_return=http://www.company.com/cancel.htm 2. Exécutez le programme de cryptage suivant la syntaxe indiquée au Tableau 7.10, « Syntaxe pour la ligne de commande du logiciel PayPal de Paiements sur site marchand cryptés ». 3. Copiez le code crypté sur votre site. TABLEAU 7.10 Syntaxe pour la ligne de commande du logiciel PayPal de Paiements sur site marchand cryptés Logiciel Ligne de commande Java java ButtonEncryption CertFile PKCS12File PPCertFile Password InputFile OutputFile [Sandbox] Microsoft Windows PPEncrypt CertFile PrivKeyFile PPCertFile InputFile OutputFile [Sandbox] Guide d’intégration de Paiements sur site marchand Août 2006 107 Paiements sur site marchand cryptés Bloquer les Paiements sur site marchand non cryptés où : TABLEAU 7.11 Description des arguments pour les commandes de Paiements sur site marchand cryptés Argument Description CertFile est le chemin vers votre propre certificat public. PKCS12File est le chemin vers le format PKCS12 de votre propre certificat public. PPCertFile est le chemin vers une copie du certificat public de PayPal. Mot de passe est le mot de passe vers le format PKCS12 de votre propre certificat public. InputFile est le chemin vers le fichier contenant la version non cryptée des variables du bouton de Paiements sur site marchand. OutputFile est un nom de fichier pour la sortie cryptée. [Sandbox] est le mot facultatif Sandbox que vous utilisez si vous créez un code de Paiements sur site marchand cryptés dans l’environnement de test PayPal. Bloquer les Paiements sur site marchand non cryptés Afin d’empêcher quiconque d’usurper l’identité de vos boutons de paiement sur site marchand, vous avez la possibilité de bloquer les paiements non cryptés. Pour n’autoriser que le paiement sur site marchand crypté : 1. Connectez-vous à votre compte PayPal Business ou Premier. 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 de droite. 4. Choisissez Oui à côté de l’option Bloquer les paiements sur site marchand non cryptés. 108 Août 2006 Guide d’intégration de Paiements sur site marchand 8 Utiliser l’Environnement de test PayPal L’Environnement de test PayPal permet de tester les fonctionnalités suivantes. IMPO RTANT : L’Environnement z z z z z de test ne permet pas de traiter de réelles sommes d’argent. Boutons Acheter maintenant et Dons : Testez les paiements d’un seul objet. Pour en savoir plus, reportez-vous au Chapitre 3, « Payer un seul objet : Boutons Acheter maintenant et Dons ». Paniers : Testez l’achat de plusieurs objets au sein d’une transaction unique et effectuez un seul paiement. Pour en savoir plus, reportez-vous au Chapitre 4, « Payer plusieurs objets : le Panier ». Abonnements : Créez et publiez les pages Web de test/prototype et tout autre contenu auquel seuls les utilisateurs effectuant des paiements auront accès. Pour en savoir plus, consultez le Guide d’utilisation des Abonnements et paiements récurrents. Remboursements : Testez un remboursement versé par un utilisateur PayPal dans le cadre d’une transaction. Transactions simulées : Scénarios de test tels que des paiements réussis ou non aboutis. Pour tester l’Environnement de test, vous devez d’abord créer un compte Centrale des développeurs. Avec ce compte, vous pouvez créer plusieurs comptes PayPal, comme par exemple des comptes vendeurs et acheteurs, de façon à simuler plusieurs scénarios. Pour en savoir plus sur l’utilisation de la Centrale des développeurs PayPal et de l’ Environnement de test, consultez le Guide d’utilisation de l’Environnement de test. Guide d’intégration de Paiements sur site marchand Août 2006 109 Utiliser l’Environnement de test PayPal 110 Août 2006 Guide d’intégration de Paiements sur site marchand 9 Bases du code HTML FORM de Paiements sur site marchand Ce chapitre décrit en termes techniques les fonctionnalités de base du code HTML FORM de Paiements sur site marchand. Vos clients interagissent avec Paiements sur site marchand, via des variables d’entrée du formulaire HTML cachées sur votre site. Ces formulaires FORM soumettent ces variables et leurs valeurs à PayPal. Vous définissez ces variables selon l’effet souhaité. En fonction de la valeur des variables, vous pouvez invoquer ou activer le Panier PayPal, les fonctions Acheter maintenant, Dons, ou autres fonctions PayPal. Un large éventail d’outils de création HTML s’offre à vous. Ce guide n’en décrit pas toutes les possibilités. PayPal propose un Assistant pour création de boutons qui vous accompagne tout au long de la procédure de création HTML de boutons Acheter maintenant, Dons ou Panier. Pour en savoir plus sur cet Assistant, reportez-vous aux Chapitre 3 et Chapitre 4. Attributs FORM : ACTION et METHOD La balise FORM requiert deux attributs, ACTION et METHOD, qui se présentent toujours comme suit : <FORM ACTION=”https://www.paypal.com/fr/cgi-bin/webscr” METHOD=POST> IMPO RTANT : Ne modifiez pas ces valeurs. Ces attributs sont requis pour n’importe quel bouton Panier PayPal, Acheter maintenant ou Dons. Variables d’entrée cachées Les variables d’entrée HTML d’un formulaire FORM de Paiements sur site marchand sont toujours masquées et le client ne peut pas les voir. Elles se présentent comme suit : <INPUT TYPE=”hidden” name=”variableName” value=”allowedValue”> variableName peut être n’importe quelle variable de l’Annexe A, « Variables HTML de Paiements sur site marchand », et allowedValue n’importe quelle valeur proposée pour ces variables. Guide d’intégration de Paiements sur site marchand Août 2006 111 Bases du code HTML FORM de Paiements sur site marchand Spécifier le produit Paiements sur site marchand : cmd Spécifier le produit Paiements sur site marchand : cmd La variable cmd est toujours requise dans un formulaire FORM. Sa valeur détermine quel produit de Paiements sur site marchand vous utilisez pour obtenir un paiement de votre client. TABLEAU 9.12 Valeurs autorisées pour la variable cmd Valeur de cmd Description _xclick Un bouton Acheter maintenant ou Dons _cart Un panier La balise d’entrée se présente toujours comme suit : z z Acheter maintenant ou Dons : <INPUT TYPE=”hidden” name=”cmd” value=”_xclick”> Panier : <INPUT TYPE=”hidden” name=”cmd” value=”_cart”> IMPO RTANT : Ces balises INPUT sont requises exactement tel qu’indiqué ci-dessus. Ne les modifiez pas. Variantes des variables de base Cette section apporte des précisions utiles sur les variables de FORM avec Paiements sur site marchand. Les variables HTML interagissent de diverses manières. Tantôt leur effet est cumulatif, tantôt elles peuvent s’annuler, tantôt l’une requiert d’en définir une autre. Ces interactions sont détaillées dans les descriptions des variables à l’Annexe A, « Variables HTML de Paiements sur site marchand ». Inviter à saisir la quantité avec Acheter maintenant ou Dons : undefined_quantity Avec Acheter maintenant et Dons, vous pouvez demander au client de spécifier le nombre d’exemplaires de l’objet souhaité à l’aide de la variable undefined_quantity : <INPUT TYPE=”hidden” name=”undefined_quantity” value=”1”> 112 Août 2006 Guide d’intégration de Paiements sur site marchand Bases du code HTML FORM de Paiements sur site marchand Variantes des variables de base Tenue de compte avec variables de transit Certaines variables sont destinées exclusivement à votre usage personnel (par exemple pour le suivi des commandes) et ne sont ni enregistrées ni utilisées par PayPal. Les valeurs que vous envoyez à PayPal vous sont retournées dans une Notification instantanée de paiement (NIP) exactement telles que vous les avez définies. Pour cette raison, elles sont désignées comme variables de transit. Les variables suivantes sont des variables de transit : z custom z item_number ou item_number_x z invoice Définir le jeu de caractères : charset Vous pouvez utiliser la variable FORMcharset pour indiquer le jeu ou le codage de caractères des données recueillies dans les formulaires de votre site que vous envoyez à PayPal. PayPal vous envoie également des données avec le jeu ou l’encodage de caractères précisé dans la variable charset. Par exemple, la balise INPUT règle l’encodage sur UTF-8 : <INPUT TYPE=”hidden” name=”charset” value=”utf-8”> TABLEAU 9.13 Codages et jeux de caractères pris en charge par PayPal Big5 (Chinois traditionnel utilisé à Taiwan) EUC-JP EUC-KR EUC-TW gb2312 (Chinois simplifié) gbk HZ-GB-2312 (Chinois traditionnel utilisé à Hong-Kong) ibm-862 (Hébreu avec caractères européens) ISO-2022-CN ISO-2022-JP ISO-2022-KR ISO-8859-1 (Langues européennes occidentales) ISO-8859-2 ISO-8859-3 ISO-8859-4 ISO-8859-5 ISO-8859-6 ISO-8859-7 ISO-8859-8 ISO-8859-9 ISO-8859-13 ISO-8859-15 KOI8-R (Cyrillique) Shift_JIS UTF-7 UTF-8 UTF-16 Guide d’intégration de Paiements sur site marchand UTF-16BE UTF-16LE UTF16_Platform Endian UTF16_Opposite Endian UTF-32 UTF-32BE UTF-32LE UTF32_Platform Endian UTF32_Opposite Endian Août 2006 US-ASCII windows-1250 windows-1251 windows-1252 windows-1253 windows-1254 windows-1255 windows-1256 windows-1257 windows-1258 windows-874 (Thaï) windows-949 (Coréen) x-mac-greek x-mac-turkish x-maccentraleurroman x-mac-cyrillic ebcdic-cp-us ibm-1047 113 Bases du code HTML FORM de Paiements sur site marchand Pré-saisie des formulaires FORM Définir 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, vous souhaiterez peut-être rediriger le navigateur de votre client sur une URL de votre site spécifique à ce client, avec un identifiant ou toute autre donnée liée à la transaction inclus(e) 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”> Devise souhaitée pour chaque transaction Utilisez la variable currency_code pour chaque transaction afin de spécifier la devise du paiement : <INPUT TYPE=”hidden” NAME=”currency_code” value=”PayPalSupportedCurrencyCode”> La valeur de currency_code doit être un code faisant partie du « Devises acceptées par PayPal », page 56. R E M A R Q U E : Si currency_code n’est pas incluse, la devise par défaut est USD. Valeurs des variables de codage URL Les variables telles que return, cancel_return, image_url nécessitent une URL dans leurs valeurs. Vous devez garantir que ces valeurs sont encodées dans l’URL avant de les transmettre à PayPal. L’encodage dans l’URL remplace les caractères requis dans l’URL par des caractères qui seront clairement interprétés par les serveurs Web. Par exemple, les deux-points seront remplacés par les caractères %3A. Pré-saisie des formulaires FORM La fonction Compte PayPal facultatif (également appelée Paiements express sur site marchand) vous permet d’accepter des paiements de clients qui ne disposent pas d’un compte PayPal. Toutefois, il est souvent plus rapide d’effectuer un paiement avec PayPal que de demander au client de saisir à nouveau des informations déjà enregistrées chez PayPal. Pour les achats à répétition, il est plus avantageux pour vous que vos clients créent un compte PayPal. Durant une transaction de paiement, vous pouvez pré-remplir un formulaire FORM en incluant les variables d’entrée HTML spécialement à cet effet. Vous trouverez une description détaillée de ces variables dans le Tableau A.21, « Variables HTML : Pré-saisie des formulaires FORM PayPal ou remplacement de l’adresse » page 127. 114 Août 2006 Guide d’intégration de Paiements sur site marchand Bases du code HTML FORM de Paiements sur site marchand Remplacer les adresses enregistrées auprès de PayPal Exemple de code HTML pour la pré-saisie des formulaires FORM L’exemple de code HTML ci-après présente les champs de pré-saisie facultatifs contenant les variables requises pour les boutons de paiement. Les entrées des champs doivent être générées de manière dynamique par votre site et intégrées dans l’URL vers laquelle sont renvoyés vos clients lorsqu’ils effectuent un paiement PayPal. EXEMPLE 9.7 Code HTML pour la pré-saisie des formulaires FORM <form action=”https://www.paypal.com/cgi-bin/webscr” method=”POST”> <input type=”hidden” name=”cmd” value=”_cart”> <input type=”hidden” name=”business” value=”seller@designerfotos.com”> <input type=”hidden” name=”item_name” value=”hat”> <input type=”hidden” name=”item_number” value=”123”> <input type=”hidden” name=”amount” value=”15.00”> <input type=”hidden” name=”first_name” value=”John”> <input type=”hidden” name=”last_name” value=”Doe”> <input type=”hidden” name=”address1” value=”9 Elm Street”> <input type=”hidden” name=”address2” value=”Apt 5”> <input type=”hidden” name=”city” value=”Berwyn”> <input type=”hidden” name=”state” value=”PA”> <input type=”hidden” name=”zip” value=”19312”> <input type=”hidden” name=”night_phone_a” value=”610”> <input type=”hidden” name=”night_phone_b” value=”555”> <input type=”hidden” name=”night_phone_c” value=”1234”> <input type=”image” SRC=”http://images.paypal.com/images/x-click-but01.gif” border=”0” name=”submit” alt=”Effectuez vos paiements via PayPal : une solution rapide, gratuite et sécurisée”> </form> Remplacer les adresses enregistrées auprès de PayPal Pour les clients qui disposent déjà d’un compte PayPal et qui ont déjà été invités à entrer une adresse de livraison avan de choisir de payer avec PayPal, vous pouvez utiliser l’adresse saisie au lieu de celle enregistrée auprès de PayPal. Attribuez la valeur 1 à la variable address_override, comme dans l’exemple suivant : <INPUT TYPE=”hidden” name=”address_override” value=”1”> Vous devez également inclure les variables FORM contenant les informations relatives à l’adresse du client, comme indiqué dans le Tableau A.21, « Variables HTML : Pré-saisie des formulaires FORM PayPal ou remplacement de l’adresse » page 127. Le client voit l’adresse transmise, mais il ne peut pas la modifier. Aucune adresse ne s’affiche si l’adresse n’est pas correcte (champs obligatoires manquants, notamment le pays) ou si elle n’est pas fournie. Guide d’intégration de Paiements sur site marchand Août 2006 115 Bases du code HTML FORM de Paiements sur site marchand Notification instantanée de paiement : notify_url Exemple de code HTML de remplacement des adresses de livraison enregistrées chez PayPal Le code HTML suivant affiche la variable address_override conjointement aux variables de pré-saisie pour remplacer l’adresse de livraison d’un client enregistrée auprès de PayPal. EXEMPLE 9.8 Code HTML de remplacement d’une adresse enregistrée chez PayPal <form action="https://www.paypal.com/cgi-bin/webscr" method="post"> <input type="hidden" name="cmd" value="_xclick"> <input type="hidden" name="business" value="seller@designerfotos.com"> <input type="hidden" name="item_name" value="Memorex 256MB Memory Stick"> <input type="hidden" name="item_number" value="MEM32507725"> <input type="hidden" name="amount" value="3"> <input type="hidden" name="tax" value="1"> <input type="hidden" name="quantity" value="1"> <input type="hidden" name="no_note" value="1"> <input type="hidden" name="currency_code" value="USD"> <!-Remplace l’adresse du client enregistrée par PayPal --> <input type="hidden" name="address_override" value="1"> <!—Définit les variables de pré-saisie qui remplacent l’adresse enregistrée --> <input type="hidden" name="first_name" value="John"> <input type="hidden" name="last_name" value="Doe"> <input type="hidden" name="address1" value="345 Lark Ave"> <input type="hidden" name="city" value="San Jose"> <input type="hidden" name="state" value="CA"> <input type="hidden" name="zip" value="95121"> <input type="hidden" name="country" value="US"> <input type="image" src="https://www.paypal.com/en_US/i/btn/x-clickbut01.gif" border="0" name="submit" alt="Effectuez vos paiements via PayPal : une solution rapide, gratuite et sécurisée"> </form> Notification instantanée de paiement : notify_url La Notification instantanée de paiement (NIP) comprend trois étapes : 1. Un client vous règle. 2. PayPal Publie(POST)les variables FORM sur une URL que vous avez spécifiée exécutant un programme de traitement des variables. 3. Vous validez la notification. 116 Août 2006 Guide d’intégration de Paiements sur site marchand Bases du code HTML FORM de Paiements sur site marchand Notification instantanée de paiement : notify_url FIGURE 9.49 Fonctionnement de la notification instantanée de paiement : Trois étapes principales 1. Un paiement ou remboursement d’un client déclenche une notification instantanée de paiement. Ce paiement peut s’effectuer via les formulaires FORM de Paiements sur site marchand ou via les API Paypal pour les Paiements express, les Paiements groupés ou RefundTransaction. Si le paiement est En attente, vous recevrez une seconde notification instantanée de paiement lorsqu’il sera compensé, annulé ou refusé. 2. PayPal publie les variables HTML FORM dans un programme sur une URL que vous avez spécifiée. Vous pouvez spécifier cette URL soit dans vos Préférences soit avec la variable notify_url pour chaque transaction. Cette publication est au cœur de la Notification instantanée de paiement. Cette notification comporte les informations de paiement de votre client (par exemple, nom du client, montant). Toutes les variables possibles dans les publications NIP sont détaillées dansle Guide d’intégration de la gestion des commandes. Lorsque votre serveur reçoit une notification, il doit traiter les données entrantes. 3. Votre serveur doit ensuite valider la notification pour garantir qu’elle est fiable. Pour en savoir plus, reportez-vous au Guide d’intégration de la gestion des commandes. Guide d’intégration de Paiements sur site marchand Août 2006 117 Bases du code HTML FORM de Paiements sur site marchand Notification instantanée de paiement : notify_url 118 Août 2006 Guide d’intégration de Paiements sur site marchand A Variables HTML de Paiements sur site marchand Cette annexe présente en détail toutes les variables des boutons Acheter maintenant, Dons, Ajouter au panier et Panier. TABLEAU A.14 Valeurs autorisées pour la variable cmd Valeur de cmd Description _xclick Un bouton Acheter maintenant ou Dons _cart Un panier TABLEAU A.15 Variables HTML : Contrôle de la notification instantanée de paiement avec notify_url Nom Description Obligatoire ou facultatif Nombre de caractères notify_url URL à laquelle PayPal publie les informations sur la transaction. Son codage URL doit être assuré. Facultatif 255 Nombre de caractères TABLEAU A.16 Variables HTML : Informations sur l’objet Nom Description Obligatoire ou facultatif amount Prix ou montant de l’achat, hors TVA, frais d’expédition et de livraison et frais de dossier. Si cela a été omis dans Acheter maintenant ou Dons, les clients peuvent saisir un montant au moment de l’achat. Voir la description. item_name z Facultatif pour Acheter maintenant et Dons z Obligatoire pour le Panier Description d’un objet. Si cela a été omis dans Acheter maintenant ou Dons, les clients peuvent saisir le nom de l’objet au moment de l’achat. z Facultatif pour Acheter maintenant et Dons z Obligatoire pour le Panier Guide d’intégration de Paiements sur site marchand Août 2006 Voir la description. 127 119 Variables HTML de Paiements sur site marchand TABLEAU A.16 Variables HTML : Informations sur l’objet Nom Description Obligatoire ou facultatif Nombre de caractères item_number Variable de transit permettant d’assurer le suivi des achats ou des dons, qui vous sera renvoyée, une fois le paiement effectué. Si elle n’est pas incluse dans Acheter maintenant et Dons, aucune variable ne vous sera renvoyée. Facultatif 127 quantity Nombre d’objets. Le montant, les frais d’expédition et de livraison, ainsi que les taxes seront multipliés par la quantité pour obtenir le montant total du paiement. S’il s’agit d’une transaction via le Panier, PayPal ajoute le numéro de l’objet (par exemple, quantity1, quantity2). Facultatif R E M A R Q U E : La valeur de quantity doit être un chiffre entier positif. Les chiffres nul, zéro ou négatifs ne sont pas autorisés. undefined_ quantity 1 : permet à l’acheteur de spécifier la quantité. Facultatif 1 R E M A R Q U E : Cette variable est autorisée uniquement dans Acheter maintenant ou Dons et n’est pas permise dans le Panier. on0 Nom du premier champ d’option. Si elle est ignorée, aucune variable ne vous sera renvoyée. Facultatif 64 on1 Nom du second champ d’option. Si elle est ignorée, aucune variable ne vous sera renvoyée. Facultatif 64 os0 Premier ensemble de valeurs d’option. Si cette option est sélectionnée par le biais d’un bouton radio ou d’une zone de texte, chaque valeur ne doit pas dépasser 64 caractères. Si cette valeur est saisie par le client dans une zone de texte, le nombre de caractères est limité à 200. Si elle est ignorée, aucune variable ne vous sera renvoyée. Facultatif 64 ou 200 Voir la description. Facultatif 64 ou 200 Voir la description. R E M A R Q U E : on0 doit aussi être définie. os1 Second ensemble de valeurs d’option. R E M A R Q U E : on1 doit aussi être définie. Si cette option est sélectionnée par le biais d’un bouton radio ou d’une zone de texte, chaque valeur ne doit pas dépasser 64 caractères. Si cette valeur est saisie par le client dans une zone de texte, le nombre de caractères est limité à 200. Si elle est ignorée, aucune variable ne vous sera renvoyée. 120 Août 2006 Guide d’intégration de Paiements sur site marchand Variables HTML de Paiements sur site marchand TABLEAU A.17 Variables HTML : informations sur l’affichage Nom Description Obligatoire ou facultatif Nombre de caractères add Ajoute un objet au panier PayPal. Cette variable doit être définie comme suit : Obligatoire 1 add=1 Il existe une alternative : display=1, qui permet à l’utilisateur de visualiser le contenu du panier PayPal. Si add et display sont spécifiés, c’est la variable display qui prévaut. cancel_ return URL d’une page vers laquelle le client sera dirigé si le paiement est annulé, par exemple une URL sur votre site correspondant à une page Paiement annulé. Par défaut : le navigateur est dirigé vers le site PayPal. Facultatif 1 024 cbt Définit le texte du bouton Continuer de la page Paiement terminé. Facultatif 60 R E M A R Q U E : La variable return doit également être définie. cn Nom au-dessus du champ de remarque. Cette valeur n’est pas conservée et n’apparaît dans aucune des notifications. Si elle est ignorée, aucune variable ne vous sera renvoyée. Facultatif 40 cpp_header_ image Place l’image en haut à gauche de la page de paiement. La taille maximale de l’image est de 750 pixels en largeur et de 90 pixels en hauteur et doit être encodée dans l’URL. PayPal vous recommande de fournir une image stockée uniquement sur un serveur sécurisé (https). Pour en savoir plus, reportez-vous à la section « Conserver l’apparence de votre boutique sur les pages de paiement PayPal » page 31. Facultatif Pas de limite cpp_ headerback_ color Définit la couleur d’arrière-plan de l’en-tête de la page de paiement. La valeur correcte est un code couleur hexadécimal HTML de six caractères en ASCII qui ne différencie pas les majuscules des minuscules. Facultatif cpp_ headerborder _color Définit la couleur de bordure de l’en-tête de la page de paiement. La bordure est un périmètre de 2 pixels autour de l’espace d’en-tête, qui dispose d’une taille maximale de 750 pixels de large sur 90 pixels de haut. La valeur correcte est un code couleur hexadécimal HTML de six caractères en ASCII qui ne différencie pas les majuscules des minuscules. Facultatif Guide d’intégration de Paiements sur site marchand Août 2006 121 Variables HTML de Paiements sur site marchand TABLEAU A.17 Variables HTML : informations sur l’affichage Nom Description Obligatoire ou facultatif cpp_payflow_ color Définit la couleur d’arrière-plan de l’en-tête de la page de paiement. La valeur correcte est un code couleur hexadécimal HTML de six caractères en ASCII qui ne différencie pas les majuscules des minuscules. Facultatif Nombre de caractères R E M A R Q U E : Les couleurs d’arrière-plan incompatibles avec les messages d’erreur de PayPal ne sont pas autorisées et sont remplacées par défaut par du blanc. cs Définit la couleur d’arrière-plan de vos pages de paiement. Facultatif 0 ou par défaut = la couleur d’arrière-plan est le blanc. 1 = la couleur d’arrière-plan est le noir. display Montre le contenu du panier PayPal au client. Cette variable doit être définie comme suit : display=1 Obligatoire Voir la description. 1 Il existe une alternative : la variable add=1, qui ajoute un objet au panier PayPal. Si add et display sont spécifiés, c’est la variable display qui prévaut. 122 image_url URL de l’image de 150 x 50 pixels s’affichant comme votre logo en haut à gauche des pages de paiement de PayPal. Doit être encodée dans l’URL. Par défaut : votre raison sociale (si vous disposez d’un compte Business) ou votre adresse électronique (si vous disposez d’un compte Premier). Facultatif 1 024 no_note Invite le client à ajouter un commentaire à son paiement. Par défaut ou sur 0 : le client est invité à ajouter une remarque. 1 : le client n’est pas invité à ajouter une remarque. Facultatif 1 no_shipping Invite le client à saisir l’adresse de livraison. Par défaut ou sur 0 : le client est invité à saisir une adresse de livraison. 1 : le client n’est pas invité à entrer une adresse de livraison. 2 : le client doit fournir une adresse de livraison. Facultatif 1 Août 2006 Guide d’intégration de Paiements sur site marchand Variables HTML de Paiements sur site marchand TABLEAU A.17 Variables HTML : informations sur l’affichage Nom Description Obligatoire ou facultatif Nombre de caractères page_style Détermine le style personnalisé des pages de paiement associées à ce bouton/lien. unNomDeStyleDePage : nom d’un style de page que vous avez défini. primary : toujours utiliser le style de page défini comme principal. paypal : utiliser le style PayPal par défaut. Caractères ASCII alphanumériques à 7 bits uniquement, plus le caractère de soulignement. Aucun espace. Facultatif 30 return URL d’une page Internet vers laquelle le client est dirigé une fois le paiement effectué, par exemple l’URL sur votre site correspondant à une page du type « Nous vous remercions de votre paiement ». Par défaut : le client est dirigé vers le site PayPal. Facultatif 1,024 shopping_url Valeur du bouton Poursuivre les achats sur PayPal : URL sur votre site vers laquelle les acteurs sont redirigés lorsqu’ils cliquent sur Poursuivre les achats durant un paiement sur PayPal. Facultatif 255 rm Méthode de renvoi GET ou POST : le code FORM METHOD est utilisé pour envoyer des données à l’URL spécifiée par la variable return une fois le paiement terminé. Facultatif R E M A R Q U E : La variable rm prend effet uniquement si la variable return est également définie. Par défaut ou sur 0 : La méthode GET est utilisée pour toutes les transactions du Panier. 1 : GET. Le client est redirigé sur l’URL de renvoi par la méthode GET et aucune variable de transaction n’est envoyée. 2 : POST. Le client est redirigé sur l’URL de renvoi par la méthode POST et toutes les variables de transaction sont également publiées. Guide d’intégration de Paiements sur site marchand Août 2006 123 Variables HTML de Paiements sur site marchand TABLEAU A.18 Variables HTML : Informations sur la transaction Nom Description Obligatoire ou facultatif Nombre de caractères address_ override 1 : L’adresse spécifiée dans les variables de pré-saisie remplace Facultatif 1 l’adresse enregistrée de l’utilisateur. Reportez-vous au Tableau A.21, « Variables HTML : Pré-saisie des formulaires FORM PayPal ou remplacement de l’adresse ». Le client voit l’adresse transmise, mais il ne peut pas la modifier. Si l’adresse n’est pas correcte (champs obligatoires manquants, notamment le pays) ou n’est pas incluse, aucune adresse ne s’affiche. 124 currency_ code Devise du paiement. Définit la devise dans laquelle les variables monétaires (amount, shipping, shipping2, handling, tax) sont indiquées. Par défaut : tous les champs monétaires sont considérés comme libellés en Dollars USD. Facultatif custom Variable de transit jamais présentée au client. Par défaut : aucune variable ne vous sera renvoyée. Facultatif handling Frais de dossier. La valeur n’est pas déterminée en fonction de la quantité. Les mêmes frais de dossier seront facturés quel que soit le nombre d’objets achetés. Par défaut : aucun frais de dossier n’est inclus. Facultatif invoice Variable de transit que vous pouvez utiliser pour identifier votre numéro de facture pour cet achat. Par défaut : aucune variable ne vous sera renvoyée. Facultatif Août 2006 256 127 Guide d’intégration de Paiements sur site marchand Variables HTML de Paiements sur site marchand TABLEAU A.18 Variables HTML : Informations sur la transaction Nom Description Obligatoire ou facultatif shipping Frais d’expédition et de livraison de l’objet si vous avez opté pour la définition de frais d’expédition et de livraison spécifiques aux objets. Si la variable shipping est utilisée et que la variable shipping2 n’est pas définie, le montant forfaitaire sera facturé indépendamment de la quantité d’objets achetés. Facultatif Nombre de caractères R E M A R Q U E : La variable shipping prend effet uniquement si l’option remplacer est cochée dans vos Préférences. Reportez-vous à la section « Annuler le paramètre de calcul des frais d’expédition et de livraison pour chaque transaction » page 47. Par défaut : si le système de facturation de l’expédition et de la livraison repose sur vos Préférences, le client sera facturé du montant ou du pourcentage défini dans vos Préférences. shipping2 Frais d’expédition et de livraison de chaque objet supplémentaire. Si cette variable est ignorée et que le système de facturation de l’expédition et de la livraison repose sur vos Préférences, le client sera facturé du montant ou du pourcentage défini dans vos Préférences. Facultatif tax Variable de remplacement de la taxe définie en fonction de la transaction. Définissez le montant forfaitaire que vous souhaiteriez appliquer à la transaction quelle que soit l’adresse de l’acheteur. Cette valeur remplace tous les paramètres relatifs aux taxes, susceptibles d’être définis dans vos Préférences. Par défaut : les paramètres de taxe définis dans vos Préférences (le cas échéant) s’appliquent. Facultatif tax_cart Taxe appliquée à tout le panier, remplaçant n’importe quelle valeur tax_x liée à un objet Facultatif Guide d’intégration de Paiements sur site marchand Août 2006 125 Variables HTML de Paiements sur site marchand TABLEAU A.19 Variables HTML spécifiques aux paniers Nom Obligatoire ou facultatif Description Valeurs autorisées amount Obligatoire Prix de l’objet ou prix total de tous les objets du panier. N’importe quel montant de devise correct business Obligatoire Adresse email associée à votre compte PayPal. Votre adresse email R E M A R Q U E : La valeur de cette variable doit être en minuscules. N’importe quel montant de devise correct handling_ cart Facultatif Frais de dossier uniques facturés par panier. Si la variable handling_cart est utilisée dans plusieurs boutons Ajouter au panier, la valeur handling_cart utilisée sera celle du premier objet. item_name Obligatoire Nom de l’objet ou nom du panier dans son ensemble. paymentaction Facultatif Indique si la transaction a reçu une autorisation de collecte ultérieure via l’Autorisation et collecte PayPal sur https://www.paypal.fr/. Pour en savoir plus, consultez le Guide d’intégration d’Autorisation et collecte PayPal. authorization upload Obligatoire Indique l’utilisation d’un panier tiers 1 TABLEAU A.20 Variables HTML : pour chaque objet des paniers tiers 126 Nom Obligatoire ou facultatif Description Nombre de caractères amount_x Obligatoire Prix de l’objet x. handling_x Facultatif Frais de dossier pour l’objet x. item_name_x Obligatoire Nom de l’objet x dans le panier. Doit être alphanumérique. 127 item_number_x Facultatif Variable de transit vous permettant de suivre vos commandes ou achats. Par défaut : aucune variable ne vous sera renvoyée. 127 on0_x Facultatif Nom du premier champ d’option de l’objet x. 64 on1_x Facultatif Nom du deuxième champ d’option de l’objet x. 64 Août 2006 Guide d’intégration de Paiements sur site marchand Variables HTML de Paiements sur site marchand TABLEAU A.20 Variables HTML : pour chaque objet des paniers tiers Nom Obligatoire ou facultatif Description Nombre de caractères os0_x Facultatif Premier ensemble de valeurs d’option pour l’objet x. on0_x doit aussi être définie. 200 os1_x Facultatif Second ensemble de valeurs d’option pour l’objet x. on1_x doit aussi être définie. 200 quantity_x Facultatif Quantité de l’objet x. R E M A R Q U E : La valeur de quantity_x doit être un chiffre entier positif. Les chiffres nul, zéro ou négatifs ne sont pas autorisés. shipping_x Facultatif Coût de livraison de la première unité (quantité égale à 1) de l’objet x. shipping2_x Facultatif Coût de livraison de chaque unité supplémentaire (quantité supérieure ou égale à 2) de l’objet x. tax_x Facultatif Montant des taxes relatives à l’objet x. TABLEAU A.21 Variables HTML : Pré-saisie des formulaires FORM PayPal ou remplacement de l’adresse Variable Description Conditions requises Nombre de caractères address1 Rue (1 sur 2 champs) Alphanumérique 100 address2 Rue (2 sur 2 champs) Alphanumérique 100 city Ville Alphanumérique 40 country Définit le pays de livraison et de facturation. Pour connaître les codes pays correspondants, reportez-vous à l’annexe B. Alphabétique 2 first_name Prénom Alphabétique 32 last_name Nom Alphabétique 64 Guide d’intégration de Paiements sur site marchand Août 2006 127 Variables HTML de Paiements sur site marchand TABLEAU A.21 Variables HTML : Pré-saisie des formulaires FORM PayPal ou remplacement de l’adresse Variable Description Conditions requises Nombre de caractères lc Définit la langue de l’acheteur pour la page de connexion uniquement. Valeurs autorisées : AU DE FR IT GB ES US Alphabétique 2 night_ phone_a Indicatif régional des numéros de téléphone aux Etats-Unis, ou indicatif national des numéros hors des Etats-Unis. Numéro de téléphone du domicile de l’acheteur. Numérique 3 night_ phone_b Indicatif à trois chiffres pour les numéros de téléphone aux Etats-Unis, ou totalité du numéro de téléphone pour les numéros hors des Etats-Unis, sans l’indicatif du pays. Numéro de téléphone du domicile de l’acheteur. Numérique 3 night_ phone_c Numéro de téléphone à 4 chiffres (EtatsUnis). Numéro de téléphone du domicile de l’acheteur. Numérique 3 state Etat Abréviation officielle (Etats-Unis) à 2 caractères. 2 zip Code postal Numérique 32 TABLEAU A.22 Variables HTML : Pré-saisie pour l’ouverture d’un compte Business 128 Variable Valeur Conditions requises Nombre de caractères business_ address1 Adresse postale professionnelle Alphanumérique 128 business_ address2 Adresse postale professionnelle Alphanumérique 128 business_ city Ville (adresse professionnelle) Alphanumérique 128 Août 2006 Guide d’intégration de Paiements sur site marchand Variables HTML de Paiements sur site marchand TABLEAU A.22 Variables HTML : Pré-saisie pour l’ouverture d’un compte Business Variable Valeur Conditions requises Nombre de caractères business_ state Etat (adresse professionnelle) Alphanumérique 2 business_ zip Code postal (adresse professionnelle) Numérique 5 business_ country Pays (adresse professionnelle) Alphabétique 2 business_ cs_email Adresse email professionnelle du service clientèle Alphanumérique 128 business_cs _phone_a Indicatif régional du numéro de téléphone du service clientèle pour les numéros aux Etats-Unis ou indicatif national pour les numéros hors des Etats-Unis. Numérique 3 business_ cs_phone_b Indicatif à trois chiffres du service clientèle pour les numéros de téléphone aux Etats-Unis, ou totalité du numéro de téléphone pour les numéros hors des Etats-Unis, sans l’indicatif du pays. Numérique 3 business_ cs_phone_c Numéro de téléphone à quatre chiffres du service clientèle pour les numéros aux Etats-Unis. Numérique 4 business_ url URL du site professionnel Alphanumérique. Doit être encodée dans l’URL. 128 business_ night_phone _a Indicatif régional des numéros de téléphone aux Etats-Unis, ou indicatif national des numéros hors des Etats-Unis. Numéro de téléphone du domicile du client. Numérique 3 business_ night_phone _b Indicatif à trois chiffres pour les numéros de téléphone aux Etats-Unis, ou totalité du numéro de téléphone pour les numéros hors des Etats-Unis, sans l’indicatif du pays. Numéro de téléphone du domicile du client. Numérique 3 business_ night_phone _c Numéro de téléphone à quatre chiffres (Etats-Unis). Numéro de téléphone du domicile du client. Numérique 4 Guide d’intégration de Paiements sur site marchand Août 2006 129 Variables HTML de Paiements sur site marchand 130 Août 2006 Guide d’intégration de Paiements sur site marchand B Codes pays Pays Code Pays Code BELIZE BZ AFGHANISTAN AF BENIN BJ AFRIQUE DU SUD ZA BERMUDES BM ÅLAND, ILES AX BHOUTAN BT ALBANIE AL BIELORUSSIE BY ALGERIE DZ BOLIVIE BO ALLEMAGNE DE BOSNIE-HERZEGOVINE BA ANDORRE AD BOTSWANA BW ANGOLA AO BOUVET, ILE BV ANGUILLA AI BRESIL BR ANTARCTIQUE AQ BRUNEI DARUSSALAM BN ANTIGUA-ET-BARBUDA AG BULGARIE BG ANTILLES NEERLANDAISES AN BURKINA FASO BF ARABIE SAOUDITE SA BURUNDI BI ARGENTINE AR CAIMANES, ILES KY ARMENIE AM CAMBODGE KH ARUBA AW CAMEROUN CM AUSTRALIE AU CANADA CA AUTRICHE AT CAP-VERT CV AZERBAIDJAN AZ CF BAHAMAS BS CENTRAFRICAINE, REPUBLIQUE BAHREIN BH CHILI CL BANGLADESH BD CHINE CN BARBADE BB CHRISTMAS, ILE CX BELGIQUE BE CHYPRE CY COCOS (KEELING), ILES CC 131 Codes pays 132 Pays Code Pays Code COLOMBIE CO FIDJI FJ COMORES KM FINLANDE FI CONGO CG FRANCE FR CONGO, REPUBLIQUE DEMOCRATIQUE DU CD GABON GA GAMBIE GM COOK, ILES CK GEORGIE GE COREE, REPUBLIQUE DE KR KP GEORGIE DU SUD ET LES ILES SANDWICH DU SUD GS COREE, REPUBLIQUE POPULAIRE DEMOCRATIQUE DE GHANA GH COSTA RICA CR GIBRALTAR GI COTE D’IVOIRE CI GRECE GR CROATIE HR GRENADE GD CUBA CU GROENLAND GL DANEMARK DK GUADELOUPE GP DJIBOUTI DJ GUAM GU DOMINICAINE, REPUBLIQUE DO GUATEMALA GT GUERNESEY GG DOMINIQUE DM GUINEE GN EGYPTE EG GUINEE EQUATORIALE GQ EL SALVADOR SV GUINEE-BISSAU GW EMIRATS ARABES UNIS AE GUYANA GY EQUATEUR EC GUYANE FRANCAISE GF ERYTHREE ER HAITI HT ESPAGNE ES HM ESTONIE EE HEARD, ILE ET MCDONALD, ILES ETATS-UNIS US HONDURAS HN ETHIOPIE ET HONG-KONG HK FALKLAND (MALVINAS), ILES FK HONGRIE HU UM FEROE, ILES FO ILES MINEURES ELOIGNEES DES ETATS-UNIS Codes pays Pays Code Pays Code ILES VIERGES BRITANNIQUES VG LITUANIE LT LUXEMBOURG LU ILES VIERGES DES ETATSUNIS VI MACAO MO INDE IN MK INDONESIE ID MACEDOINE, EXREPUBLIQUE YOUGOSLAVE DE IRAK IQ MADAGASCAR MG IRAN, REPUBLIQUE ISLAMIQUE D’ IR MALAISIE MY MALAWI MW IRLANDE IE MALDIVES MV ISLANDE IS MALI ML ISRAEL IL MALTE MT ITALIE IT MAN, ILE DE IM JAMAHIRIYA ARABE LIBYENNE LY MARIANNES DU NORD, ILES MP JAMAIQUE JM MAROC MA JAPON JP MARSHALL, ILES MH JERSEY JE MARTINIQUE MQ JORDANIE JO MAURICE MU KAZAKHSTAN KZ MAURITANIE MR KENYA KE MAYOTTE YT KIRGHIZISTAN KG MEXIQUE MX KIRIBATI KI MICRONESIE, ETATS FEDERES DE FM KOWEIT KW MOLDOVA, REPUBLIQUE DE MD LAOS, REPUBLIQUE DEMOCRATIQUE POPULAIRE LA MONACO MC MONGOLIE MN LESOTHO LS MONTSERRAT MS LETTONIE LV MOZAMBIQUE MZ LIBAN LB MYANMAR MM LIBERIA LR NAMIBIE NA LIECHTENSTEIN LI Codes pays 134 Pays Code Pays Code NAURU NR QATAR QA NEPAL NP SY NICARAGUA NI REPUBLIQUE ARABE SYRIENNE NIGER NE REUNION RE NIGERIA NG ROUMANIE RO NIUE NU ROYAUME-UNI GB NORFOLK, ILE NF RUSSIE, FEDERATION DE RU NORVEGE NO RWANDA RW NOUVELLE-CALEDONIE NC SAHARA OCCIDENTAL EH NOUVELLE-ZELANDE NZ SAINT SIEGE (ETAT DE LA CITE DU VATICAN) VA OCEAN INDIEN, TERRITOIRE BRITANNIQUE DE L’ IO SAINTE-HELENE SH SAINTE-LUCIE LC OMAN OM SAINT-KITTS-ET-NEVIS KN OUGANDA UG SAINT-MARIN SM OUZBEKISTAN UZ PM PAKISTAN PK SAINT-PIERRE-ETMIQUELON PALAOS PW SAINT-VINCENT-ET-LES GRENADINES VC PANAMA PA SALOMON, ILES SB PAPOUASIE-NOUVELLEGUINEE PG SAMOA WS PARAGUAY PY SAMOA AMERICAINES AS PAYS-BAS NL SAO TOME ET PRINCIPE ST PEROU PE SENEGAL SN PHILIPPINES PH SERBIE-ET-MONTENEGRO CS PITCAIRN PN SEYCHELLES SC POLOGNE PL SIERRA LEONE SL PORTO RICO PR SINGAPOUR SG PORTUGAL PT SLOVAQUIE SK POYNESIE FRANCAISE PF SLOVENIE SI SOMALIE SO Codes pays Pays Code Pays Code SOUDAN SD URUGUAY UY SRI LANKA LK VANUATU VU SUEDE SE VENEZUELA VE SUISSE CH VIET NAM VN SURINAM SR WALLIS ET FUTUNA WF SVALBARD ET ILE JAN MAYEN SJ YEMEN YE ZAMBIE ZM SWAZILAND SZ ZIMBABWE ZW TADJIKISTAN TJ TAIWAN, PROVINCE DE CHINE TW TANZANIE, REPUBLIQUE UNIE DE TZ TCHAD TD TCHEQUE, REPUBLIQUE CZ TERRES AUSTRALES FRANÇAISES TF TERRITOIRE PALESTINIEN OCCUPÉ PS THAILANDE TH TIMOR-LESTE TL TOGO TG TOKELAU TK TONGA TO TRINITE-ET-TOBAGO TT TUNISIE TN TURKMENISTAN TM TURKS ET CAIQUES, ILES TC TURQUIE TR TUVALU TV UKRAINE UA Codes pays 136 Index Symboles _cart 77, 84, 85, 86, 112, 115, 119 _xclick 64, 112, 116, 119 A abonnements 25 Accès multi-utilisateur 55 Acheter maintenant 23 exemple de séquence de pages 18 opérations effectuées par le client 59 opérations effectuées par le client avec Compte PayPal facultatif 38 ACTION 111 add 67, 77, 121 address_override 115, 116, 124 address1 115, 116, 127 address2 115, 127 adresse email du Contact administratif 55 adresses confirmées 40 ajouter le nom figurant sur le relevé de carte bancaire 50 amount 64, 84, 115, 119, 126 amount_1 86 amount_x 85, 126 Assistant pour création de boutons Acheter maintenant ou Dons 59 panier 73 authorization 88 Autorisation et collecte 87 B balise INPUT 112 bloquer certains types de paiements 48 bloquer les paiements non cryptés 108 business 64, 77, 84, 85, 86, 115, 126, 128 business_address1 128 business_address2 128 business_city 128 business_country 129 business_cs_email 129 Guide d’intégration de Paiements sur site marchand business_cs_phone_a 129 business_cs_phone_b 129 business_cs_phone_c 129 business_night_phone_a 129 business_night_phone_b 129 business_night_phone_c 129 business_state 129 business_url 129 business_zip 129 C cancel_return 64, 114, 121 cbt 121 Centrale des développeurs 109 Centre d’intégration 15, 25 cert_id 107 Certificat public 104 charset 54, 64, 113 Chèques électroniques 49 choix de la langue 52 city 115, 116, 127 Clé privée 104 cmd 77, 85, 86, 112, 115 cn 121 code HTML bouton Ajouter au panier 77 panier avec des objets distincts 85 pour bouton Acheter maintenant 64 pour considérer le panier dans son ensemble 86 codes des devises 56 collecte par lots 90 commande 88 Compte PayPal facultatif 37, 114 opérations effectuées par le client 38 country 127 cpp_header_image 121 cpp_headerback_color 121 cpp_headerborder_color 121 cpp_payflow_color 122 cs 122 currency_code 85, 114, 124 custom 64, 113, 124 Août 2006 137 Index D Guide d’utilisation du kit de développement PayPal ASP classique 26 Guide d’utilisation du kit de développement PayPal Java 26 Guide d’utilisation du kit de développement PayPal PHP 26 Guide de référence des API 27 définitions de FORM ACTION et METHOD 111 DesignerFotos 18 Détails de la transaction 101 devises acceptées par PayPal 56 display 67, 122 Dons 23 H E encodage dans l’URL 65, 114, 119, 121, 122, 129 Environnement de test 109 Envoi de paiement 49 exemple code HTML de remplacement d’une adresse de livraison enregistrée auprès de PayPal 116 code HTML du bouton Ajouter au panier 77 HTML pour acheter maintenant 64 HTML pour des objets distincts à l’intérieur du panier 85 panier avec informations sur l’ensemble des objets 86 exemple d’intégration 18 Expédition et livraison 47, 125 calcul automatique 46 remplacer par des paramètres spécifiques à chaque transaction 47, 125 expédition et livraison 125 F handling 124 handling_cart 47, 126 handling_x 85, 126 historique 23 historique des transactions 23 Historique téléchargeable 23 https 60 I image_url 114, 122 Informations financières 30 Informations personnelles 29 invoice 64, 113, 124 item_name 64, 115, 119, 126 item_name_1 84, 86 item_name_x 126 item_number 64, 113, 115, 120 item_number_x 113, 126 J first_name 115, 116, 127 jeu de caractères 51 jpg 34 G GET 123 gif 34 Guide d’intégration de la gestion des commandes 23, 25, 26 Guide d’intégration de Paiements express PayPal 26 Guide d’intégration de Paiements sur site marchand 87 Guide d’utilisation de l’Environnement de test 26, 109 Guide d’utilisation des Abonnements et paiements récurrents 27, 45, 109 Guide d’utilisation du kit de développement PayPal .NET 26 K kits de développement 26 L last_name 115, 116, 127 lc 128 M METHOD 111, 123 138 Août 2006 Guide d’intégration de Paiements sur site marchand Index N night_phone_a 115, 128 night_phone_b 115, 128 night_phone_c 115, 128 NIP 25 NIP. Voir « Notification instantanée de paiement » no_note 64, 122 no_shipping 64, 122 nom figurant sur le relevé de carte bancaire 50 Notification instantanée de paiement 22, 23, 25 notification par email 22 désactiver 22 notify_url 119 numéro de téléphone à contacter 50 O on0 77, 120 on0_x 126 on1 120 on1_x 126 OpenSSL 104 os0 77, 120 os0_x 127 os1 120 os1_x 127 P Page Votre paiement a été effectué 21, 43 page_style 34, 35, 123 Paiement 102 paiement sur site marchand crypté voir Paiements sur site marchand cryptés Paiements express sur site marchand. Voir « Compte PayPal facultatif ». Paiements sur site marchand cryptés 60, 63, 103 panier 23 hébergé par PayPal 67, 73 tiers 67, 84 Panier hébergé par PayPal 67 Panier tiers 67 paymentaction 88, 89, 126 PEM 105 Guide d’intégration de Paiements sur site marchand Période d’autorisation 88 Période de validité du paiement 88 png 34 POST 123 Préférences 29 Calcul automatique des frais d’expédition et de traitement, ainsi que de la TVA 45 Compte PayPal facultatif 37, 38 Informations financières 30 Informations personnelles 29 Personnaliser les pages de paiement 32 remplacer par un calcul des frais d’expédition et de livraison spécifique à chaque transaction 47, 125 Renvoi automatique 44 Préférences de réception de paiements 40, 48, 50 préférences en matière de livraison 71, 81 pré-renseigner des formulaires PayPal FORM 114 Q quantité permettant aux clients de spécifier avec Acheter maintenant 62, 120 quantity_x 127 R Rejets de débit 49 relevé de carte bancaire, nom indiqué 50 remboursement 101 remboursement partiel 101 Remplacement calcul de la TVA sur chaque transaction 46 calcul des frais d’expédition et de livraison spécifique à chaque transaction 47, 125 styles de page 35 URL de renvoi pour chaque transaction 45, 114 remplacer adresse de livraison enregistrée chez PayPal 115 Renvoi automatique 43 activation 44 opérations effectuées par le client 43 return 45, 64, 114, 121, 123 rm 123 Août 2006 139 Index S V SDK 15, 25 shipping_x 85, 127 shipping2 125 shipping2_x 85, 127 soldes en devise 58 sommaire des préférences de votre compte voir aussi « Préférences ». sources d’approvisionnement 20 state 115, 116, 128 variables cachées 111 format général des 111 pour les paniers 126 variables de personnalisation du style de page 121 variables de transit, définies 113 variables requises pour un panier tiers 84 T webscr 77, 85, 86, 111, 115, 116 tax 125 tax_cart 85, 125 tax_x 85, 125, 127 Taxe. Voir « TVA ». TDP. Voir aussi « Transfert des données de paiement ». Transfert des données de paiement 25 TVA 45 appliquer au panier dans son ensemble 85 calcul automatique 45 remplacer par des paramètres spécifiques à chaque transaction 85 X W X.509 104 Z zip 115, 128 U undefined_quantity 64, 112, 120 upload 67, 84, 126 exemple d’informations relatives à chaque objet 85 exemple de panier global 86 UTF-8 113 Utilisateurs vérifiés, définition 49 140 Août 2006 Guide d’intégration de Paiements sur site marchand