Webhook Payloads
Fatturazione basata sui crediti
Il payload inviato al tuo endpoint webhook quando si verificano eventi di fatturazione basata sui crediti — crediti virtuali (chiamate API, token, ore di calcolo) concessi, consumati, scaduti, trasferiti o avvisi sul saldo. Questi webhook non sono correlati ai Customer Wallets (saldi monetari).
Eventi webhook per la fatturazione basata sui crediti
Sono disponibili i seguenti eventi webhook per monitorare i cambiamenti del ciclo di vita della fatturazione basata sui crediti. Questi eventi si applicano ai crediti virtuali (chiamate API, token, ore di calcolo), non ai Customer Wallets (saldi monetari).Eventi del registro contabile
Tutti gli eventi del registro contabile (credit.added fino a credit.manual_adjustment) condividono lo stesso payload CreditLedgerEntryResponse documentato nello schema sottostante.
Il payload include un campo metadata risolto dall’origine della concessione di credito — l’abbonamento o il pagamento creato al checkout. Questo ti consente di collegare i crediti del wallet al tuo stesso checkout metadata (ad esempio, un orgId) piuttosto che al customer_id emesso da Dodo: le concessioni derivate dall’abbonamento fanno emergere il metadata dell’abbonamento e quelle derivate dal pagamento fanno emergere il metadata del pagamento. Il campo è vuoto quando la concessione non ha un’origine risolvibile (ad esempio, crediti concessi direttamente tramite l’API).
Bilancio Basso Evento (credit.balance_low)
L’eventocredit.balance_low utilizza un payload diverso (CreditBalanceLowPayload) incentrato sull’avviso di soglia:
string
Il brand a cui appartiene questo diritto ai crediti.
string
Il cliente il cui saldo crediti ha attivato l’avviso.
string
L’abbonamento associato a questo diritto ai crediti.
string
Il diritto ai crediti con un saldo basso.
string
Nome visualizzato del diritto ai crediti.
string
Saldo crediti corrente al momento dell’avviso.
string
Totale dei crediti emessi per ciclo di fatturazione per questo abbonamento.
integer
Percentuale configurata della soglia di saldo basso.
string
L’importo assoluto dei crediti a cui corrisponde la soglia.
Utilizzo di credit.balance_low per gli avvisi proattivi
Utilizza il webhook credit.balance_low per informare i clienti prima che esauriscano i crediti:
Get Customer Balance
Verifica il saldo corrente di un cliente tramite API.
Create Ledger Entry
Aggiungi o sottrai manualmente crediti dal saldo di un cliente.
Schema del payload del webhook
Response for a ledger entry
Brand id this credit ledger entry belongs to
Metadata associated with the credit grant's source (the subscription or payment created at checkout). Empty when the grant has no resolvable source (e.g. credits granted directly via the API).
Opzioni disponibili:
credit_added, credit_deducted, credit_expired, credit_rolled_over, rollover_forfeited, overage_charged, overage_reset, auto_top_up, manual_adjustment, refund Ultima modifica il 6 agosto 2026