Un remboursement fait chez PayPal n'apparaît pas dans Agora
Un don toujours « Reçu » ou une vente toujours « Livré » après un remboursement chez PayPal : le webhook PayPal n'est pas branché, ou Agora le refuse.
Mis à jour le 5 oct. 2026, 09 h 25
Sur cette page
En bref. Tu as remboursé (ou perdu un litige) chez PayPal, mais le don reste Reçu ou la vente reste Livré dans Agora. La cause est presque toujours le webhook PayPal : il n'est pas branché, ou Agora refuse ce qu'il reçoit.
Les causes #
| Ce que tu vois | Cause |
|---|---|
| Rien ne bouge, et le champ ID du webhook est vide dans Administration → Configuration → Paiements | Sans cet ID, Agora répond « non configuré » à tout ce qui arrive sur /api/paypal/webhook |
| Une ligne rouge sous le champ : « événements refusés, dernier refus le … » | L'ID est faux (celui d'une autre application) ou d'un autre environnement (Sandbox ≠ Live) : PayPal ne reconnaît pas la signature. Le journal des erreurs en garde aussi une ligne |
| Le champ ID du webhook s'est vidé après un changement Sandbox ↔ Live | Normal : l'ID est propre à chaque environnement, Agora l'efface et te le dit. Colle celui du webhook du nouvel environnement |
| Un remboursement partiel, et le don reste Reçu ou la vente Livré | Normal : un remboursement partiel ne sort pas le don des totaux, il en réduit le montant compté (la liste des dons affiche Remboursé en partie : …). Sur une vente de la concession, il note le montant rendu sur la ligne et prévient les administrateurs, mais le véhicule reste au joueur : à toi de décider (Rembourser rend le reste et reprend le véhicule). Rembourser le total chez PayPal revient au remboursement complet |
| Une notification « à vérifier dans PayPal » | Le remboursement est signé mais Agora ne retrouve pas la capture, ou ne peut pas relire son état chez PayPal |
| Plus rien depuis une série d'échecs | Une adresse qui accumule dix échecs est mise en pause quelques minutes |
Corriger #
- Dans Administration → Configuration → Paiements, vérifie l'environnement (Sandbox ou Live) et l'ID du webhook.
- Côté PayPal (
developer.paypal.com→ ton application → Webhooks), vérifie que l'adresse est bienhttps://ton-site/api/paypal/webhook(en https) et que les événements Payment capture refunded, reversed, denied, completed, Customer dispute created et resolved sont cochés (completed sert à livrer tout seul un paiement resté « en attente »). - PayPal rejoue les événements ratés pendant plusieurs jours ; tu peux aussi les renvoyer depuis Webhooks → Events.
- Pour une vente déjà remboursée dont le véhicule est resté au garage, utilise Reprendre le véhicule dans Modération → Concession (voir Relivrer, rembourser, reprendre un véhicule).
Le branchement complet du webhook est décrit dans Les campagnes de dons, section « Remboursements faits chez PayPal ».
Cet article t'a aidé ?
Articles liés
- Les campagnes de dons (PayPal)Brancher PayPal, créer une campagne avec objectif et paliers, valider la campagne d'exemple, suivre et exporter les dons reçus.
- Relivrer, rembourser, reprendre un véhicule : les ventes en argent réelLes ventes de la concession payées par PayPal direct ou chez Tebex ont leurs propres gestes : revérifier le paiement, relivrer, rembourser, reprendre le véhicule, marquer remboursé.
- Les paramètres du site et la page d'accueilAdministration → Configuration règle tout à chaud : nom, logo, langue, adresse publique, thème, Discord, paiements, sécurité, carte, portail, concession et tablette.