Ce dont vous avez besoin
| Champ | Ce qu'il fait |
|---|---|
| Client ID | Identifie votre app PayPal sur les appels API. Couplé au secret. |
| Client secret | La moitié secrète de l'authentification API. Avec le Client ID, il crée la commande. Secret. |
| Webhook ID | Identifie le webhook que PayPal signe, pour que nous puissions vérifier chaque livraison. |
| URL de réussite / URL d'annulation | Où l'acheteur atterrit après avoir payé ou renoncé. |
Pourquoi nous demandons chaque champ
Client ID
Identifie votre app PayPal sur les appels API. Ne fonctionne que couplé au Client secret.
Client secret
La moitié privée de l'authentification API. Avec le Client ID, il nous permet de créer la commande, pour que le paiement passe par votre compte.
Webhook ID
Comment nous confirmons qu'un webhook provient bien de PayPal : PayPal identifie chaque webhook par un ID, et nous nous en servons pour demander directement à PayPal si un message donné est authentique. Cela empêche quiconque de falsifier un événement « payé ».
URL de réussite et d'annulation
Réglages simples : où l'acheteur atterrit après avoir payé ou renoncé. Pas secret.
Configuration
- Ouvrez le tableau de bord développeur PayPal
Connectez-vous sur developer.paypal.com. PayPal vous donne un Sandbox gratuit avec de faux comptes professionnels et acheteurs, pour que vous puissiez tester sans déplacer de vrai argent. Ce guide parcourt le Sandbox ; le flux Live est identique, il suffit de basculer le bouton Sandbox / Live (en haut à gauche) et d'utiliser un compte PayPal for Business. Depuis le tableau de bord, ouvrez Apps & Credentials.
PayPal Developer → Apps & Credentials - Créez une application
Sur la page API Credentials, vérifiez que le bouton Sandbox est sélectionné, puis cliquez sur Create App (en haut à droite).
PayPal → Apps & Credentials → Create App - Nommez-la et choisissez Merchant
Entrez un App Name (par exemple « Coin Moebius »), laissez le Type sur Merchant, choisissez votre compte professionnel sandbox, puis cliquez sur Create App.
PayPal → Create App - Copiez votre Client ID et votre Client secret
PayPal ouvre votre nouvelle application. Copiez le Client ID et révélez puis copiez la Secret key. (Vous pouvez également copier les deux depuis la ligne Default Application dans la liste API Credentials.) Mettez-les de côté.
1. PayPal → API Credentials → votre application dans la liste 2. PayPal → votre application → Client ID et Secret Le Client secret est secret, traitez-le comme un mot de passe. L'application sandbox et l'application live ont chacune leur propre paire, ne les mélangez pas.
- Ajoutez un webhook
Faites défiler la page de l'application jusqu'à la section Sandbox Webhooks et cliquez sur Add Webhook. Dans le champ Webhook URL, collez l'adresse webhook PayPal de votre projet (ci-dessous). Choisissez ensuite les événements que Coin Moebius écoute, puis enregistrez.
- Paiements uniques : CHECKOUT.ORDER.APPROVED, PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.DENIED, PAYMENT.CAPTURE.DECLINED, PAYMENT.CAPTURE.REFUNDED, PAYMENT.CAPTURE.REVERSED, CUSTOMER.DISPUTE.CREATED.
- Abonnements (uniquement si vous en vendez) : BILLING.SUBSCRIPTION.ACTIVATED, BILLING.SUBSCRIPTION.UPDATED, BILLING.SUBSCRIPTION.CANCELLED, BILLING.SUBSCRIPTION.PAYMENT.FAILED, PAYMENT.SALE.COMPLETED. Si vous ne facturez pas de manière récurrente, ignorez-les.
- Pressé ? Sélectionner All Events (le joker en haut) fonctionne aussi, nous ignorons tout ce que nous n'utilisons pas.
https://api.coinmoebius.com/webhook/paypal/<your project id>PayPal → votre application → Add webhook Votre identifiant de projet se trouve sous le nom du projet dans le tableau de bord Coin Moebius ; insérez-le dans l'adresse ci-dessus. La carte du fournisseur connecté (dernière étape) affiche la même URL pour référence.
- Copiez le Webhook ID
Votre webhook apparaît maintenant dans la liste Sandbox Webhooks. Copiez le Webhook ID affiché à côté. C'est ainsi que Coin Moebius demande à PayPal de confirmer que chaque webhook est authentique. Enregistrez un webhook distinct en sandbox et en live.
PayPal → votre application → Sandbox Webhooks → Webhook ID - Dans Coin Moebius : Add provider → PayPal
Dans votre projet, ouvrez l'onglet Providers, cliquez sur Add provider, choisissez Connect a service et sélectionnez PayPal. Définissez votre URL de réussite et votre URL d'annulation. Vous testez avec des identifiants sandbox ? Utilisez l'onglet Test (optionnel) et collez-y votre Client ID, Client secret et Webhook ID, puis cliquez sur Save. Vous passez directement en live ? Utilisez l'onglet Live. Le groupe Test est tout-ou-rien : les trois champs, ou aucun.
Coin Moebius → Add provider → PayPal - Vous êtes connecté
PayPal apparaît désormais dans votre onglet Providers avec la date de connexion (étiqueté TEST quand vous avez utilisé des identifiants sandbox). La carte affiche la même URL de webhook que vous avez collée dans PayPal, ainsi que Modifier et Déconnecter.
Coin Moebius → Providers → PayPal (connecté) - Testez avec un acheteur sandbox
Pour payer via un paiement de test, vous avez besoin de votre identifiant d'acheteur sandbox. Dans PayPal, ouvrez Testing Tools → Sandbox Accounts pour voir vos faux comptes Business et Personal.
PayPal → Testing Tools → Sandbox Accounts - Obtenez les identifiants de l'acheteur
Ouvrez le compte Personal (acheteur) pour voir ses Login Info : l'URL sandbox, l'e-mail et le mot de passe. Connectez-vous sur sandbox.paypal.com avec ces informations quand un paiement de test vous demande de payer. Aucun argent réel ne bouge.
PayPal → Sandbox account → Login Info
Après la connexion
Faites un paiement de test avant de passer en live :
- Créez un produit et réglez son Environnement sur Testing. Cela fait tourner le produit sur vos identifiants sandbox, pour que vous puissiez passer une commande complète sans déplacer d'argent. (Si vous avez sauté le jeu sandbox, un produit Testing retombe sur le live, donc ajoutez-le d'abord.)
- Placez le bouton d'achat sur une page (un fichier HTML local convient) pointé vers votre projet.
- Finalisez le paiement en payant avec votre compte acheteur sandbox.
- Ouvrez l'onglet Transactions. Une nouvelle ligne apparaît, étiquetée Testing. Quand son statut atteint succeeded, vos identifiants et votre webhook fonctionnent tous deux de bout en bout.
Basculez l'Environnement du produit sur Live quand vous êtes prêt pour de vrais paiements.
Dépannage
Commencez par Vérifier. Dans le tableau de bord, cliquez sur Vérifier (ou Vérifier les identifiants de test pour le sandbox) pour contrôler vos identifiants client.
La vérification échoue.
Recopiez le Client ID et le Client secret. L'app sandbox et l'app live ont des paires différentes, donc ne les mélangez pas.
Le paiement se finalise mais la commande reste en attente.
Le Webhook ID doit provenir de la même app et du même environnement que vos identifiants client. Les identifiants live ont besoin du webhook ID live. Confirmez que l'URL du webhook correspond.
Confirmez de bout en bout.
PayPal Developer Dashboard → Webhooks Simulator : envoyez un événement d'exemple vers votre URL de webhook, puis observez la commande se mettre à jour.
Bon à savoir
Rotation des secrets. Générez un nouveau client secret à tout moment, puis collez-le. Les champs secrets restent vides à la modification.
Des questions ? Join our Discord