Votre agent IA et les remboursements Paddle : « demandé » n’est pas « remboursé »
Paddle examine les remboursements avant de les verser, et son API n’a pas de clés d’idempotence. Deux raisons pour lesquelles un agent IA sur Paddle peut dire une contre-vérité au client — ou rembourser deux fois.
Votre agent de support peut désormais rembourser sur Paddle Billing, pas seulement sur Stripe. Paddle est un merchant of record, ce qui change deux points sur lesquels un agent IA se trompe facilement.
1. Un remboursement Paddle est une demande, pas un versement
Sur Paddle, un remboursement est un adjustment. À sa création, il attend généralement l’examen de Paddle — statut pending_approval — et ne devient approved (ou rejected) que plus tard. Aucun argent n’a encore bougé.
Un agent qui dit « C’est fait, vos 29 € sont remboursés » dès que l’API répond affirme au client quelque chose qui n’est pas encore vrai — et ne le sera peut-être jamais.
| Champ | Attendu | Observé |
|---|---|---|
| statut du remboursement | approved | pending_approval |
| annoncé au client | « demandé » | « remboursé » |
Avec COLVO, l’opération affiche En attente de Paddle. Elle ne passe à VERIFIED que lorsque Paddle approuve le remboursement — via la notification signée de Paddle ou la vérification horaire de COLVO. Si Paddle le refuse, l’opération échoue, le budget est libéré et un incident vous invite à prévenir le client. Nos SDK le formulent déjà correctement : messageFor(op) indique que le remboursement est demandé tant que Paddle l’examine.
2. Une nouvelle tentative peut devenir un second remboursement
L’API de Paddle n’a pas de clés d’idempotence. Si la réponse à un remboursement se perd — un timeout, une connexion coupée —, une nouvelle tentative naïve crée un second remboursement.
COLVO marque chaque remboursement qu’il crée avec l’id de son opération et cherche ce marqueur avant toute nouvelle tentative. Une réponse perdue est retrouvée, pas répétée. Le scénario nouvelle tentative après une réponse perdue le prouve à chaque exécution : il doit exister exactement un remboursement à la fin.
Testez-le avant qu’un client ne le fasse
COLVO exécute désormais 12 scénarios Paddle sur un Paddle simulé : des id au format Paddle (ctm_, sub_, txn_), des remboursements qui attendent l’examen, aucune clé d’idempotence. Choisissez Paddle dans Choisir les scénarios… — les outils de votre agent ne changent pas.
- Les scénarios Paddle
- Guide : tester et protéger un agent de remboursement sur Paddle
- Intégration Paddle
Les changements de formule et les remises ne sont pour l’instant disponibles que sur Stripe ; sur Paddle, COLVO rembourse, résilie, met en pause, réactive et annule une résiliation programmée.
