PayPal : Test des appels de l'API classique

Le service Paypal a évolué. Voici la nouvelle marche à suivre pour les tests.

Les sections suivantes décrivent comment tester vos applications avec le bac à sable :

• Obtenir les informations d'identification pour l'essai
• Faire des tests d'appel
• Trucs et astuces

—-

Pour tester le système, PayPal a mis en place un environnement de test virtuel autonome, le bac à sable https://www.sandbox.paypal.com (« Sandbox »). Cet environnement reproduit l'environnement PayPal dans un espace protégé pour simuler des transactions avec des comptes de test PayPal virtuels.

L'environnement de test PayPal comprend :

• Le site du bac à sable (https://www.sandbox.paypal.com/)
• La page des comptes de test virtuels (accessible par https://developer.paypal.com). Ces comptes représentent les utilisateurs qui participent aux opérations simulées pendant la phase de test. Créer au moins un compte de test pour chaque utilisateur représenté dans les transactions à tester.

Utilisés dans le bac à sable, les comptes de test virtuels et leurs codes d'identification permettent de simuler tout le processus PayPal, avec le même comportement que dans la réalité. PayPal crée des transactions virtuelles qui se comportent exactement comme les vraies. Le bac à sable garde la trace de toutes les transactions virtuelles, exactement comme le site PayPal dans la réalité.

• Disposer d'un compte Paypal dédié aux tests.

Pour créer un compte Paypal, se rendre à l'adresse https://developer.paypal.com/ et cliquer sur le bouton Sign' 'Up :

Une page s'ouvre sur le site www.paypal.com ; sélectionner la France :

Dans la page qui s'ouvre,

1. choisir de créer un compte de type Professionnel
2. et cliquer sur le bouton Continuer.

Dans la page qui s'ouvre,

1. donner une adresse e-mail valide (elle servira à valider le compte)
2. et cliquer sur le bouton Continuer.

Renseigner toutes les rubriques, cocher la case et cliquer sur le bouton Valider' 'et' 'continuer.

Un mail est envoyé à l'adresse indiquée : surveiller la messagerie et répondre au mail pour activer le compte.

Le compte développeur Paypal permet de créer des comptes acheteur et vendeur fictifs pour tester une solution Paypal de paiement en ligne en simulant des paiements sans verser de fonds.

Le bac à sable prend en charge deux types de comptes de test :

• Personal : représente l'acheteur dans une transaction.
• Business : représente le vendeur dans une transaction.

Les comptes de test Sandbox sont des comptes virtuels qui n'existent que dans l'environnement du bac à sable.

Ils représentent des utilisateurs fictifs qui participent à des opérations simulées.

Aller sur le site https://developer.paypal.com. Cliquer sur le bouton Log' 'In en haut à droite :

Se connecter avec les paramètres du compte Professionnel (voir Pré-requis) en renseignant :

1. adresse mail
2. mot de passe
3. cliquer sur le bouton Log' 'In

Dans la page qui s'ouvre,

1. Cliquer sur Dashboard en haut
2. Dans le menu qui apparaît à gauche, cliquer sur Accounts dans le paragraphe Sandbox
3. Deux comptes modèles ont été créés :

   • un compte Business, nommé d'après l'e-mail de connexion avec le suffixe -facilitator, représentant le vendeur
   • un compte Personal, nommé d'après l'e-mail de connexion avec le suffixe -buyer, représentant l'acheteur
4. En bout de ligne de chaque compte, une icône permet de le dupliquer.

Ce compte est en réalité un sous-compte du compte développeur.

Le mieux est de dupliquer le compte modèle.

Connecte-vous sur le site https://developer.paypal.com avec les paramètres du compte développeur PayPal.

Cliquez sur l'icône en bout de ligne du compte -facilitator et renseignez :

1. Le prénom et le nom (quelconques)
2. un e-mail
3. un mot de passe

Le nouveau compte est opérationnel sur le site http://sandbox.paypal.com :

Sur ce site, on se retrouve sur une page Paypal du bac à sable

Créez de même un compte de test Personal, en dupliquant le compte …-buyer@…, qui représentera l'acheteur.

Le nouveau compte est déjà opérationnel sur le site http://sandbox.paypal.com :

Pour gérer un compte du bac à sable, se connecter au site développeur de PayPal https://developer.paypal.com/ et accéder à Applications > Sandbox accounts.

Pour gérer un compte du bac à sable,

1. cliquer sur sa ligne,
2. puis sur Profile :

La boîte de dialogue Accounts Details s'affiche et permet de visualiser et configurer divers paramètres du compte,

1. en particulier le mot de passe.
2. Cliquer sur Close pour terminer.

Pour accepter des cartes de crédit dans les tests, il faut configurer en Pro le compte vendeur fictif :

1. Dans la boîte de dialogue Accounts Details, cliquez sur le lien : Account type: Upgrade to Pro
2. Dans l'écran qui s'ouvre, cliquez sur Activer

La suppression d'un compte de test Sandbox existant se fait dans la page Sandbox test accounts :

1. Cocher la case dans la colonne de gauche du ou des compte(s) à supprimer.
2. Cliquez sur le bouton Delete.

Un message confirme la suppression des comptes de test.

Pour le site du vendeur, il faut créer 4 pages web :

1. Une page qui contiendra le formulaire de paiement pour acheter le produit ou commander le service.
2. une page qui affichera un message en cas de succès du paiement
3. une page qui affichera un message en cas d'annulation du paiement
4. une page qui traitera le paiement, appelée par PayPal grâce à la requête IPN lorsqu'un paiement est validé.

Maintenant que le compte vendeur est opérationnel, nous allons créer un bouton pour vendre un produit. Allez dans l’onglet Merchand Services, et cliquez sur le lien sell single item.

Différentes options assez explicites s’offrent à vous, paramétrez donc votre bouton selon vos besoins, les champs principaux étant la Description du produit/service et le prix (à ce titre, pensez à jeter un œil sur la grille des commissions Paypal pour éviter les mauvaises surprises). C’est ici que s’ajoute l’option facultative concernant la redirection vers une URL spécifique de votre site à l’issu du paiement (étape 3 : options avancées)

Validez le formulaire en appuyant sur create button puis copiez/collez le code qui s’affiche à l’endroit désiré sur votre site pour y intégrer le bouton.

Aller sur le site du bac à sable : https://www.sandbox.paypal.com/fr/webapps/mpp/home.

Se connecter avec le avec l'e-mail et le mot de passe du vendeur fictif. Dans ce compte,

1. Dans l'onglet Mon compte
2. menu Préférences,
3. cliquer sur Plus d'options

Cliquer sur Préférences de Notification instantanée de paiement :

Cliquer sur le bouton Choisir' 'les' 'paramètres' 'IPN

Enfin,

1. renseigner une URL de notification (correspondant à l’emplacement du fichier ipn.php, qu’on va voir plus bas). ex: http://www.domain.com/inc/ipn.php
2. cocher Recevoir les messages IPN
3. et cliquer sur le bouton Enregistrer

• https://developer.paypal.com/docs/classic/lifecycle/ug_sandbox/

Contributeurs principaux : Jamaique.