Il tuo agente AI e i rimborsi Paddle: “richiesto” non è “rimborsato”
Paddle verifica i rimborsi prima di pagarli e la sua API non ha chiavi di idempotenza. Due motivi per cui un agente AI su Paddle può dire al cliente la cosa sbagliata — o rimborsare due volte.
Il tuo agente di assistenza ora può rimborsare anche su Paddle Billing, non solo su Stripe. Paddle è un merchant of record, e questo cambia due cose che un agente AI sbaglia facilmente.
1. Un rimborso Paddle è una richiesta, non un pagamento
Su Paddle un rimborso è un adjustment. Quando viene creato di solito attende la verifica di Paddle — stato pending_approval — e solo dopo diventa approved (o rejected). Il denaro non si è ancora mosso.
Un agente che dice “Fatto, i tuoi 29 € sono rimborsati” appena l'API risponde sta dicendo al cliente una cosa non ancora vera — e che potrebbe non diventarlo mai.
| Campo | Atteso | Osservato |
|---|---|---|
| stato del rimborso | approved | pending_approval |
| detto al cliente | “richiesto” | “rimborsato” |
Con COLVO l'operazione mostra In attesa di Paddle. Diventa VERIFIED solo quando Paddle approva il rimborso — con la notifica firmata di Paddle o con il controllo orario di COLVO. Se Paddle lo rifiuta, l'operazione fallisce, il budget viene liberato e un incidente ti avvisa di informare il cliente. I nostri SDK lo dicono già nel modo giusto: messageFor(op) scrive che il rimborso è richiesto mentre Paddle lo verifica.
2. Un nuovo tentativo può diventare un secondo rimborso
L'API di Paddle non ha chiavi di idempotenza. Se la risposta a un rimborso si perde — un timeout, una connessione caduta — un nuovo tentativo ingenuo crea un secondo rimborso.
COLVO segna ogni rimborso che crea con l'id della sua operazione e lo cerca prima di qualsiasi nuovo tentativo. Una risposta persa viene ritrovata, non ripetuta. Lo scenario nuovo tentativo dopo una risposta persa lo dimostra a ogni esecuzione: alla fine deve esistere un solo rimborso.
Testalo prima che lo faccia un cliente
COLVO ora esegue 12 scenari Paddle su un Paddle simulato: id nel formato di Paddle (ctm_, sub_, txn_), rimborsi che attendono la verifica, nessuna chiave di idempotenza. Scegli Paddle in Scegli gli scenari… — gli strumenti del tuo agente non cambiano.
Cambi di piano e sconti per ora sono solo su Stripe; su Paddle COLVO rimborsa, disdice, mette in pausa, riprende e annulla una disdetta programmata.
