PAYPAL Sandbox - 2012, Sandbox - 2008 User Manual [fr]

Guide d'utilisation de l'Environnement de test
Informations à usage professionnel uniquement.
A usage professionnel uniquement
Dernière mise à jour : Avril 2008
Guide d'utilisation de l'Environnement de test PayPal
Référence : 100007.fr_FR-200804
© 2008 PayPal, Inc. Tous droits réservés. PayPal est une marque déposée de PayPal, Inc. Le logo PayPal est une marque de PayPal, Inc. Les autres marques et marques commerciales déposé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. Copyright © PayPal. Tous droits réservés. PayPal S.à r.l. et Cie, S.C.A., Société en Commandite par Actions. Siège social : 22-24 Boulevard Royal, L­2449, Luxembourg, R.C.S. Luxembourg B 118 349 Avis aux utilisateurs : le service de paiement PayPal™ est considéré comme une fonction de porte-monnaie électronique par la loi de Singapour. A ce titre, il ne nécessite pas l'approbation de la Monetary Authority of Singapore. Nous vous conseillons de lire attentivement les conditions générales.
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.
Préface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
A propos de ce document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Public ciblé. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Organisation de ce document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Conventions typographiques. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Historique des révisions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Chapitre 1 Présentation de l'Environnement de test de PayPal . . . . 9
Premiers pas : Espace Intégration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Présentation rapide : Différences entre l'Environnement de test et le site en production de
PayPal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Chapitre 2 Accéder à l'Environnement de test PayPal . . . . . . . . .13
Ouvrir un compte pour accéder à l'Environnement de test . . . . . . . . . . . . . . . . . 13
Bienvenue dans l'Environnement de test de PayPal. . . . . . . . . . . . . . . . . . . . . 15
Email de test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Chapitre 3 Configurer les comptes test. . . . . . . . . . . . . . . . .17
Planifier les types de comptes test dont vous avez besoin . . . . . . . . . . . . . . . . . 17
Gérer des comptes test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Créer un compte Personnel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Créer un compte Business. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Etat Vérifié du compte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Réinitialisation d'un compte préconfiguré . . . . . . . . . . . . . . . . . . . . . . . . 23
Création manuelle d'un compte test. . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Ajouter une source d'approvisionnement . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Modifier ou enregistrer des comptes bancaires supplémentaires . . . . . . . . . . . . 26
Enregistrer des cartes bancaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Créer un numéro de carte bancaire pour tester la fonction Compte PayPal facultatif. . 28
Chapitre 4 Tester les fonctions Web PayPal . . . . . . . . . . . . . .29
Paiements sur site marchand avec bouton Acheter . . . . . . . . . . . . . . . . . . . . . 29
Paiements sur site marchand cryptés . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Tester le bouton Acheter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Vérifier un paiement test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Traitement des transactions en attente . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Avril 2008 3
Créer une transaction en attente . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Exécuter ou annuler une transaction en attente. . . . . . . . . . . . . . . . . . . . . 31
Notification instantanée de paiement (IPN) . . . . . . . . . . . . . . . . . . . . . . . . . 32
Configurer IPN dans l'Environnement de test . . . . . . . . . . . . . . . . . . . . . . 32
Vérifier un remboursement test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Virer des fonds vers un compte test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Compensation ou échec de transactions de virements différés test. . . . . . . . . . . . . 34
Envoyer des fonds à un vendeur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Facturer un client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Chapitre 5 Tester les API NVP de PayPal . . . . . . . . . . . . . . . . 37
Tester Paiement express. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Chapitre 6 Outils de l'Environnement de test. . . . . . . . . . . . . .41
Simulateur de Notification instantanée de paiement. . . . . . . . . . . . . . . . . . . . . 41
Chapitre 7 Tester les conditions d'erreur . . . . . . . . . . . . . . . .45
Tests des API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Test négatif à l'aide d'un champ correspondant à un montant. . . . . . . . . . . . . . 48
Test négatif à l'aide d'un champ ne correspondant pas à un montant. . . . . . . . . . 48
Test négatif avec plusieurs messages. . . . . . . . . . . . . . . . . . . . . . . . . . 49
Chapitre 8 Tester les paiements récurrents. . . . . . . . . . . . . . .51
Chapitre 9 Assistance technique . . . . . . . . . . . . . . . . . . . .53
Comment contacter le Service clientèle pour une aide sur le site PayPal en production . . 53
Contacter le service d'assistance des développeurs pour une aide sur les API . . . . . . . 53
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
4 Avril 2008
Préface

A propos de ce document

Ce document décrit l'environnement de test de PayPal.

Public ciblé

Ce document s'adresse aux marchands et aux développeurs qui souhaitent tester leurs applications PayPal avant de les utiliser en production.

Organisation de ce document

Le Chapitre 1, “Présentation de l'Environnement de test de PayPal”, décrit l'Environnement de test en général et présente les différences entre cet Environnement de test et les services PayPal de production.
Le Chapitre 2, “Accéder à l'Environnement de test PayPal”, indique comment accéder à l'Environnement de test.
Le Chapitre 3, “Configurer les comptes test”, présente les différents types de rôles métier et les comptes de test associés dont vous avez besoin pour configurer l'Environnement de test afin de tester efficacement vos applications PayPal.
Le Chapitre 4, “Tester les fonctions Web PayPal”, explique comment utiliser l'Environnement de test ( interactif principal de PayPal
Le Chapitre 5, “Tester les API NVP de PayPal”, indique comment tester l'API NVP de Paiement express dans l'Environnement de test.
Chapitre 6, “Outils de l'Environnement de test”, décrit l'utilisation des outils de
l'Environnement de test tels que le simulateur de Notification instantanée de paiement.
Chapitre 7, “T ester les conditions d'erreur”, décrit l'utilisation de la fonction de test négatif
pour la simulation des conditions d'erreur.
Chapitre 8, “Tester les paiements récurrents”, fournit des informations sur une fonction de test
des paiements récurrents. Le Chapitre 9, “Assistance technique”, indique comment contacter le support technique.
https://www.sandbox.paypal.com) pour tester les fonctions correspondant à celles du site
https://www.paypal.fr/.
Guide d'utilisation de l'Environnement de test Avril 2008 5

Conventions typographiques

Conventions typographiques
Différents types de caractères sont utilisés dans ce document pour identifier les caractéristiques du texte. Ces types de caractères et leurs caractéristiques sont décrits ci-dessous :
Type de caractère Utilisation
police à empattements italique
police à espacement constant
Police à empattements gras
Titre de document Terme traité ou défini
Exemple : Un fichier est un flux de caractères en lecture ou en écriture… Valeurs booléennes (pas les mots-clés)
Exemple : La fonction renvoie la valeur true si une erreur se produit. Chemins d'accès aux fichiers ou noms de fichiers 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 méthodes, 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 du protocole Internet, tels que les variables HTTPS et FORM.
Exemple : le système PayPal utilise une requête method=POST pour renvoyer les variables d'état IPN relatives aux abonnements, telles que txn_type.
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.
Police sans empattements oblique
6 Avril 2008 Guide d'utilisation de l'Environnement de test
Espaces réservés utilisés dans le contexte d'un format, d'une norme de programmation ou des 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.

Historique des révisions

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 afin d'apporter 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.
Historique des révisions
Historique des révisions du Guide d'utilisation de l'Envir onnement de test PayPal.
ABLEAU P.1 Historique des révisions
T
Date Description
A vril 2008 Ajout d'informations sur le simulateur de notifications instantanées de paiement,
description des modifications de l'interface utilisateur de l'Environnement de test et correction de tous les problèmes connus.
Décembre 2007 Ajout d'informations sur la fonction de réinitialisation des comptes, adaptation
des copies d'écran aux modifications de l'interface utilisateur et correction de tous les problèmes connus.
Septembre 2007 Adaptation des copies d'écran à la nouvelle interface utilisateur, ajout
d'informations sur le test des paiements récurrents et correction de tous les
problèmes connus. Août 2007 Modificati on du lo go PayPal et correction de tous les problèmes connus. Mai 2007 Révision du manuel reflétant la nouvelle fonction de création automatique de
comptes. Avril 2007 Ajout de chapitres sur les tests négatifs et les tests d'API avec l'API NVP de
Paiement Express. Ajout d'une nouvelle section sur le traitement des
transactions en cours et modifications diverses. Juillet 2006 Correction du nom de la variable « ipn_test » en « test_ipn ». Juin 2006 Correction du code de tri permettant de tester les comptes britanniques dans
l'Environnement de test. Le code de tri correct est 609204. Décembre 2005 Diverses corrections.
Guide d'utilisation de l'Environnement de test Avril 2008 7
Historique des révisions
8 Avril 2008 Guide d'utilisation de l'Environnement de test
Présentation de l'Environnement
1
de test de PayPal
L'Environnement de test de PayPal est un environnement autonome dans lequel vous pouvez créer des prototypes et tester les fonctions et API de PayPal. Il s'agit d'une copie pratiquement identique du site en production de PayPal. Il sert à fournir aux dévelo ppeurs un environnement protégé leur permettant d'effectuer leurs tests et leur intégration et les aidant à éviter les problèmes qui pourraient se produire s'ils testaient leurs solutions d'intégration sur le site en production. Avant d'envoyer une application PayPal en production, vous devez la tester dans l'Environnement de test pour vérifier qu'elle fonctionne comme prévu et conformément aux directives et normes définies par le réseau de développement PayPal (PDN).

Premiers pas : Espace Intégration

L'Espace Intégration PayPal disponible sur https://www.paypal.com/integration présente les étapes détaillées de l'utilisation des kits de développement logiciel PayPal (SDK), Paiement express PayPal, Paiements sur site marchand, Autorisation et collecte, Notification instantanée de paiement et bien plus encore.
Visitez l'Espace Intégration :
http://www.solutionspaypal.fr/RessourcesTechniquesPayPal/ic_home.html
Guide d'utilisation de l'Environnement de test Avril 2008 9
Présentation de l'Environnement de test de PayPal

Présentation rapide : Différences entre l'Environnement de test et le site en production de PayPal

Présentation rapide : Différences entre l'Environnement de test
et le site en production de PayPal
Le tableau qui suit compare l'Environnement de test et le site en production de PayPal. Il offre un aperçu rapide des différences pour le développeur interne ou tiers d'une entreprise.
Ce tableau peut également vous servir de liste de contrôle.
TABLEAU 1.1 Différences entr e l'Environnement de test et le s ite en production de PayPal
Environnement de test PayPal Site PayPal en production et service d'API
T ype de comptes PayPal
Logos du site en haut à gauche
Serveurs d'API NVP
Serveurs d'API SOAP
Rôles métier Vous jouez tous les rôles que vous devez tester :
Noms et adresses postales de sociétés et de personnes
Selon la fonction que vous souhaitez développer et tester, vous devez disposer d'un compte Personnel, Business ou Premier.
https://www.sandbox.paypal.com
https://api.sandbox.paypal.com/nvp/ Pour la sécurité du certificat d'API :
https://api.sandbox.paypal.com/2.0/ Pour la sécurité du certificat d'API :
marchand, acheteur et vendeur. Totalement fictifs. Avant de commencer à utiliser
l'Environnement de test, créez les détails de tous les rôles métier que vous devez remplir.
L'Environnement de test simule la vérification des adresses postales et des noms.
Compte Personnel, Business ou Premier
https://www.paypal.fr
https://api.paypal.com/nvp/
Pour la sécurité de la signature API :
https://api-3t.paypal.com/nvp/
https://api.paypal.com/2.0/
Pour la sécurité de la signature API :
https://api-3t.paypal.com/2.0/
Des personnes réelles jouent ces rôles.
Noms et adresses postales de sociétés et de personnes réelles.
Adresses email et boîtes de réception des emails
10 Avril 2008 Guide d'utilisation de l'Environnement de test
Une boîte de réception des emails spécialement conçue pour vos tests est contenue dans l'Environnement de test proprement dit.
Adresses email et boîte de réception réelles pour chaque rôle métier
Présentation de l'Environnement de test de PayPal
Présentation rapide : Différences entre l'Environnement de test et le site en production de PayPal
T
ABLEAU 1.1 Différences e ntre l'Environnement de test et le site en production de PayPal
Environnement de test PayPal Site PayPal en production et service d'API
Numéros de compte bancaire et de carte bancaire
Transactions PayPal
Détection de fraudes
Certificats numériques
Fonctions marchands PayPal prises en charge
L'Environnement de test crée les comptes bancaires, numéros de cartes bancaires et cryptogrammes visuels dont vous avez besoin pour le développement et les tests. Ils sont tous fictifs et utilisés uniquement à l'intérieur de l'Environnement de test. L'Environnement de test simule la vérification de ces numéros. Les transactions n'affectent aucun compte réel et aucune somme d'argent n'est jamais échangée.
L'Environnement de test crée tous les comptes bancaires, numéros de carte bancaire et numéros de cryptogramme visuel fictifs dont vous avez besoin pour le développement et le test. L'Environnement de test simule la vérification de ces numéros.
La détection de fraudes n'est pas activée pour l'Environnement de test.
Une fois que vous avez demandé les certificats numériques à utiliser avec l'API PayPal, l'Environnement de test les génère automatiquement. Ils peuvent être téléchargés immédiatement.
Toutes les fonctions du site en production de PayPal, à l'exception de la fermeture d'un compte, des fonctions d'enchères, des préférences de livraison et des boutiques PayPal.
Vérification réelle des numéros de compte bancaire, de carte bancaire et de cryptogramme visuel
Transactions en direct, compensées par des procédures PayPal en direct
Protection totale grâce au système de détection de fraudes de PayPal
Pour garantir votre sécurité et celle de vos clients, les demandes de certificats numériques à utiliser avec l'API PayPal en direct doivent être vérifiées par PayPal avant toute émission. Vous êtes informé par email lorsque votre demande a été approuvée.
Guide d'utilisation de l'Environnement de test Avril 2008 11
Présentation de l'Environnement de test de PayPal
Présentation rapide : Différences entre l'Environnement de test et le site en production de PayPal
12 Avril 2008 Guide d'utilisation de l'Environnement de test
Accéder à l'Environnement
2
de test PayPal
Pour accéder à l'Environnement de test PayPal, ouvrez un compte à l'adresse
https://developer.paypal.com. Après cela, vous pourrez accéder à l'Environnement de test soit
depuis votre code, soit en vous connectant au compte. Selon la fonctionnalité de PayPal que vous voulez tester dans une application, vous devez
configurer différents types de comptes de tests : Personnel et Business (ou Premier) PayPal. Reportez-vous à « Planifier les types de comptes test dont vous avez besoin » page 17.

Ouvrir un compte pour accéder à l'Environnement de test

Pour ouvrir un compte en vue d'accéder à l'Environnement de test :
1. Rendez-vous sur
https://developer.paypal.com/. L'écran de connexion se présente ainsi :
2. Si vous avez déjà un compte, saisissez votre email et votre mot de passe de connexion et cliquez sur Log In.
Guide d'utilisation de l'Environnement de test Avril 2008 13
Accéder à l'Environnement de test PayPal
Ouvrir un compte pour accéder à l'Environnement de test
3. Si vous n'avez pas encore de compte, cliquez sur Sign Up Now et saisissez les informations requises telles qu'elles apparaissent ci-dessous :
IMPORTANT : N'utilisez pas l'adresse email ou le mot de passe qui vous donnent accès au
site en production paypal.com, au cas où vous laisseriez une tierce personne travailler pour vous dans l'Environnement de test sans pour autant souhaiter qu'elle accède à votre vrai compte PayPal.
Une fois le compte ouvert, PayPal envoie des instructions de connexion à l'adresse email que vous avez indiquée à l'ouverture du compte. Si un filtre d'emails est activé dans votre logiciel de messagerie électronique, il se peut que le message envoyé par PayPal soit rejeté ou stocké dans un dossier où vous ne penserez pas à le chercher. Si, par exemple, vous utilisez Microsoft Outlook, la fonction de filtrage peut placer l'email dans le dossier Courrier indésirable ou Emails non sollicités.
4. Répondez à l'email de confirmation et connectez-vous.
14 Avril 2008 Guide d'utilisation de l'Environnement de test
Accéder à l'Environnement de test PayPal

Bienvenue dans l'Environnement de test de PayPal

Bienvenue dans l'Environnement de test de PayPal
Lorsque vous vous connectez à l'Environnement de test, la page d'accueil suivante s'affiche :
Sur cette page, vous pouvez effectuer les actions suivantes :
z Créer des comptes test. Vous pouvez créer et gérer des comptes test dans l'onglet Test
Accounts. Cet onglet donne également accès au site virtuel de l'Environnement de test, qui
simule le site paypal.com réel. Pour en savoir plus, reportez-vous au chapitre
« Configurer les comptes test » page 17.
z Accéder aux emails envoyés aux comptes de test à partir de l'onglet Test Email. Pour en
savoir plus, reportez-vous à la section « Email de test » page 16.
z Afficher les Informations d'authentification API des comptes de test Business à partir de
l'onglet API Credentials. Une signature API (qui est le type d'information d'authentification préféré) est automatiquement générée lorsque vous créez un compte de test Business. Vous avez besoin des informations affichées dans cet onglet lorsque vous testez les API.
z Obtenir des informations techniques sur les produits et API PayPal grâce au lien Help.
Guide d'utilisation de l'Environnement de test Avril 2008 15
Accéder à l'Environnement de test PayPal

Email de test

z Simuler des Notifications instantanées de paiement à l'aide d'un outil de test. Pour en savoir
plus, reportez-vous au chapitre « Outils de l'Environnement de test » page 41.
z Changer le mot de passe de connexion à l'aide du lien Profile.
REMARQUE :Vous ne pouvez pas changer l'adresse email de connexion.
Email de test
Lors de l'exécution de certains types de transactions dans PayPal, le système envoie des messages aux adresses email réelles des personnes participant à ces transactions. Grâce à ces emails, le destinataire ou l'auteur d'un événement ou d'une transaction peut vérifier que l'événement a bien eu lieu et que les montants associés sont corrects.
Dans l'Environnement de test de PayPal, en revanche, les emails constituent un système de messagerie autonome. Vous pouvez uniquement afficher les emails envoyés aux comptes de test que vous avez créés. Les 30 derniers messages emails sont répertoriés dans l'onglet Test Email. L'objet des emails que vous n'avez pas encore lus est en gras. Cliquez dessus pour lire le message.
16 Avril 2008 Guide d'utilisation de l'Environnement de test

Configurer les comptes test

3
Selon l'application d'entreprise que vous développez et testez, vous avez besoin de différents types de comptes test. Il existe deux types de comptes test : Personnel (ou Premier) et Business.

Planifier les types de comptes test dont vous avez besoin

Déterminez les types de comptes test dont vous avez besoin pour tester les applications que vous développez. Déterminez également le nombre de comptes différents dont vous avez besoin. Généralement, vous créez au moins un compte vendeur (Business) et un compte acheteur (Personnel ou Premier). Vous pouvez avoir besoin de plusieurs comptes test Personnel ou Business différents pour tester votre application.
Lorsque vous créez un compte test, les informations suivantes sont générées pour vous :
z Adresse postale; z Adresse email et mot de passe du compte test PayPal. Pour faciliter leur mémorisation,
vous pouvez spécifier le même mot de passe (mais non la même adresse email) pour tous vos comptes test;
z Questions secrètes et réponses. Pour faciliter leur mémorisation, vous pouvez utiliser les
mêmes questions secrètes et les mêmes réponses pour tous vos comptes test;
IMPORTANT : N'utilisez jamais d'adresses email ou de mots de passe de comptes réels
paypal.com pour les comptes de test. N'utilisez que des informations fictives dans vos réponses aux questions de sécurité. Toutes les informations fournies doivent être fictives.
z Compte Personnel ou Business; z Votre engagement à respecter les conditions d'utilisation de l'Environnement de test;
Pour les comptes Business, les informations supplémentaires suivantes sont générées pour vous :
z Raison sociale et adresse professionnelle; z Informations de contact du Service clientèle; z Coordonnées professionnelles du représentant autorisé; z Adresse du représentant autorisé.
Guide d'utilisation de l'Environnement de test Avril 2008 17
Loading...
+ 39 hidden pages