Il tuo agente AI e Chargebee: un rimborso è una nota di credito su una fattura
Su Chargebee un agente rimborsa una fattura, non un pagamento — e Chargebee ricorda un nuovo tentativo solo per 30 minuti. Cosa significa per un agente AI e come lo gestisce COLVO.

Il tuo agente di assistenza ora può agire anche su Chargebee: rimborsi, disdette, pause, cambi di piano e coupon. Chargebee funziona in modo un po' diverso da Stripe, e due differenze contano per un agente AI.
1. Un rimborso indica una fattura
Su Chargebee il denaro torna indietro su una fattura. Il rimborso crea una nota di credito rimborsabile e viene pagato tramite il gateway che aveva incassato — Stripe, Braintree, Adyen.
Quindi la domanda “quale pagamento?” diventa “quale fattura?” — e un agente che sceglie quella sbagliata rimborsa il cliente sbagliato.
| Campo | Atteso | Osservato |
|---|---|---|
| fattura rimborsata | INV-1042 (di Mara) | INV-2042 (di qualcun altro) |
Con COLVO il mandato elenca le fatture che una conversazione può rimborsare. Un agente che indica la fattura di un altro cliente viene bloccato prima che parta qualsiasi cosa, e lo scenario rimborso sulla fattura di un altro cliente lo verifica a ogni esecuzione.
2. Chargebee ricorda un nuovo tentativo per 30 minuti
Ogni scrittura di COLVO su Chargebee porta la chiave di idempotenza di Chargebee — l'id dell'operazione — quindi un nuovo tentativo dopo una risposta persa restituisce la stessa nota di credito invece di crearne una seconda. Lo scenario nuovo tentativo dopo una risposta persa lo dimostra: alla fine c'è una sola nota di credito.
Ma Chargebee conserva queste chiavi per 30 minuti. Dopo, la stessa richiesta sarebbe un nuovo rimborso. Per questo COLVO non ripete mai una scrittura su Chargebee più vecchia di così: se l'esito è ancora incerto, apre un incidente e controlla una persona.
Cos'altro funziona
Disdetta subito o a fine periodo (senza accrediti, a meno che non venga chiesto un rimborso), pausa e ripresa, annullo di una disdetta programmata, cambi di piano sugli item price — subito o a fine periodo — e coupon. Stessi limiti, approvazioni e verifiche di Stripe.
- Gli scenari Chargebee
- Guida: testa e proteggi un agente di rimborsi su Chargebee
- Integrazione Chargebee


