Tu agente de IA y los reembolsos en Paddle: “solicitado” no es “reembolsado”
Paddle revisa los reembolsos antes de pagarlos y su API no tiene claves de idempotencia. Dos motivos por los que un agente de IA en Paddle puede decirle al cliente algo falso, o reembolsar dos veces.
Tu agente de soporte ya puede reembolsar en Paddle Billing, no solo en Stripe. Paddle es merchant of record, y eso cambia dos cosas en las que un agente de IA se equivoca con facilidad.
1. Un reembolso en Paddle es una solicitud, no un pago
En Paddle un reembolso es un adjustment. Cuando se crea, normalmente espera la revisión de Paddle —estado pending_approval— y solo después pasa a approved (o rejected). Todavía no se ha movido dinero.
Un agente que dice “Hecho, tus 29 € están reembolsados” en cuanto responde la API le está diciendo al cliente algo que aún no es cierto, y que quizá nunca lo sea.
| Campo | Esperado | Observado |
|---|---|---|
| estado del reembolso | approved | pending_approval |
| dicho al cliente | “solicitado” | “reembolsado” |
Con COLVO la operación muestra Esperando a Paddle. Pasa a VERIFIED solo cuando Paddle aprueba el reembolso, con la notificación firmada de Paddle o con la comprobación horaria de COLVO. Si Paddle lo rechaza, la operación falla, se libera el presupuesto y un incidente te avisa para que informes al cliente. Nuestros SDK ya lo expresan bien: messageFor(op) dice que el reembolso está solicitado mientras Paddle lo revisa.
2. Un reintento puede convertirse en un segundo reembolso
La API de Paddle no tiene claves de idempotencia. Si la respuesta a un reembolso se pierde —un timeout, una conexión caída—, un reintento ingenuo crea un segundo reembolso.
COLVO marca cada reembolso que crea con el id de su operación y busca esa marca antes de cualquier reintento. Una respuesta perdida se encuentra, no se repite. El escenario reintento tras una respuesta perdida lo demuestra en cada ejecución: al final debe existir exactamente un reembolso.
Pruébalo antes de que lo haga un cliente
COLVO ya ejecuta 12 escenarios de Paddle contra un Paddle simulado: ids con el formato de Paddle (ctm_, sub_, txn_), reembolsos que esperan revisión, sin claves de idempotencia. Elige Paddle en Elegir escenarios…: las herramientas de tu agente no cambian.
- Los escenarios de Paddle
- Guía: prueba y protege un agente de reembolsos en Paddle
- Integración con Paddle
Por ahora, los cambios de plan y los descuentos solo están en Stripe; en Paddle, COLVO reembolsa, cancela, pausa, reanuda y deshace una cancelación programada.
