Guida agli eventi Webhook

Dodo Payments emette eventi Webhook in ogni fase del ciclo di vita di un pagamento, abbonamento, contestazione, payout, credito o chiave di licenza. Questa pagina elenca tutti gli eventi per risorsa. Per gli schemi dettagliati dei payload e gli esempi di handler, consulta le pagine specifiche delle risorse collegate di seguito.

Eventi di pagamento

Evento	Viene attivato quando
`payment.succeeded`	Un pagamento viene elaborato correttamente.
`payment.failed`	Un tentativo di pagamento non va a buon fine a causa di carte rifiutate, fondi insufficienti o altri errori.
`payment.processing`	Un pagamento è in fase di elaborazione.
`payment.cancelled`	Un pagamento viene annullato prima del completamento.

Per lo schema completo del payload, consulta Webhook dei pagamenti.

Eventi di rimborso

Evento	Viene attivato quando
`refund.succeeded`	Un rimborso viene elaborato correttamente.
`refund.failed`	Un tentativo di rimborso non va a buon fine a causa di errori di elaborazione o altri problemi.

Per lo schema completo del payload, consulta Webhook dei rimborsi.

Eventi di contestazione

Evento	Viene attivato quando
`dispute.opened`	Un titolare di carta apre una contestazione su un pagamento.
`dispute.challenged`	Sono state inviate prove per contestare la contestazione.
`dispute.accepted`	La contestazione è stata accettata senza essere contestata.
`dispute.cancelled`	La contestazione è stata ritirata o annullata.
`dispute.expired`	Il periodo per rispondere è trascorso senza una risoluzione.
`dispute.won`	La contestazione è stata risolta a tuo favore.
`dispute.lost`	La contestazione è stata risolta a favore del titolare della carta.

Per gli schemi dettagliati dei payload e gli esempi di handler, consulta Webhook delle contestazioni.

Eventi degli abbonamenti

Evento	Viene attivato quando
`subscription.active`	Un abbonamento viene attivato correttamente e vengono pianificati gli addebiti ricorrenti.
`subscription.updated`	Qualsiasi campo dell’abbonamento cambia (sincronizzazione in tempo reale senza polling).
`subscription.past_due`	Un rinnovo non va a buon fine e inizia il periodo di tolleranza; il cliente mantiene l’accesso fino alla scadenza.
`subscription.on_hold`	Un abbonamento viene temporaneamente sospeso a causa di un rinnovo non riuscito.
`subscription.paused`	Un abbonamento viene messo in pausa.
`subscription.unpaused`	Un abbonamento in pausa viene ripreso.
`subscription.renewed`	Un abbonamento viene rinnovato correttamente per il periodo di fatturazione successivo.
`subscription.plan_changed`	Un abbonamento viene aggiornato, declassato o modificato con componenti aggiuntivi diversi.
`subscription.update_payment_method`	Il metodo di pagamento di un abbonamento viene aggiornato.
`subscription.cancelled`	Un abbonamento viene annullato dal merchant o dal cliente.
`subscription.failed`	La creazione dell’abbonamento non va a buon fine durante la creazione del mandato.
`subscription.expired`	Un abbonamento raggiunge la fine del proprio termine e scade.

Per gli schemi dettagliati dei payload e gli esempi di handler, consulta Webhook degli abbonamenti.

Eventi delle chiavi di licenza

Evento	Viene attivato quando
`license_key.created`	Viene creata una nuova chiave di licenza per un prodotto.

Per lo schema completo del payload, consulta Webhook delle chiavi di licenza.

Eventi delle concessioni di entitlement

Evento	Viene attivato quando
`entitlement_grant.created`	Viene creata una nuova concessione di entitlement per un cliente. Le concessioni di chiavi di licenza evase automaticamente e le concessioni di feature flag arrivano con `status: "Delivered"` e non attivano un evento `delivered` separato. Le altre concessioni, incluse le chiavi di licenza evase manualmente, arrivano `Pending`. Consulta Concessione di entitlement.
`entitlement_grant.delivered`	L’evasione della concessione è completata: la chiave di licenza è stata emessa, i link ai file sono stati risolti oppure è stato concesso l’accesso alla piattaforma.
`entitlement_grant.failed`	L’evasione della concessione non va a buon fine. Controlla `error_code` e `error_message` nel payload.
`entitlement_grant.revoked`	L’accesso viene revocato. Controlla `revocation_reason` nel payload.

Per gli schemi dettagliati dei payload, gli eventi di esempio e il riferimento completo a revocation_reason, consulta Webhook delle concessioni di entitlement.

Eventi dei crediti

Evento	Viene attivato quando
`credit.added`	I crediti vengono concessi a un cliente (tramite abbonamento, acquisto una tantum, componente aggiuntivo o API).
`credit.deducted`	I crediti vengono consumati tramite utilizzo o addebito manuale.
`credit.expired`	I crediti inutilizzati scadono al termine del periodo di scadenza configurato.
`credit.rolled_over`	I crediti inutilizzati vengono trasferiti a una nuova concessione al termine del ciclo.
`credit.rollover_forfeited`	I crediti vengono persi perché è stato raggiunto il numero massimo di rollover.
`credit.overage_charged`	Vengono applicati addebiti per l’eccedenza relativa all’utilizzo oltre il saldo zero.
`credit.overage_reset`	Gli addebiti per eccedenza accumulati vengono reimpostati (ad esempio, all’inizio di un nuovo ciclo di fatturazione).
`credit.manual_adjustment`	Viene effettuata una rettifica manuale del credito o del debito.
`credit.balance_low`	Il saldo dei crediti scende al di sotto della soglia configurata.

Per gli schemi dettagliati dei payload e gli esempi di handler, consulta Webhook della fatturazione basata sui crediti.

Eventi di recupero

Evento	Viene attivato quando
`abandoned_checkout.detected`	Viene rilevato un checkout incompleto o non riuscito dopo 60 minuti.
`abandoned_checkout.recovered`	Un cliente completa il pagamento tramite un link di recupero.

Per gli schemi dettagliati dei payload, le descrizioni dei campi e gli esempi di handler, consulta Webhook di recupero.

Eventi di sollecito

Evento	Viene attivato quando
`dunning.started`	Inizia un tentativo di sollecito per un abbonamento scaduto o sospeso, oppure annullato.
`dunning.recovered`	Un cliente aggiorna il proprio metodo di pagamento e l’addebito risultante va a buon fine.

Per gli schemi dettagliati dei payload, le descrizioni dei campi e gli esempi di handler, consulta Webhook di recupero.

Eventi dei payout

Gli eventi dei payout tracciano il trasferimento dei tuoi fondi da Dodo Payments al tuo conto bancario. Rispecchiano gli stati dei payout mostrati nella dashboard. Il payload è un oggetto payout con la stessa struttura di una voce di GET /payouts.

Evento	Viene attivato quando
`payout.created`	Viene creato un payout, tramite il ciclo automatico dei payout o al di fuori del ciclo.
`payout.in_progress`	Arriva la data di scadenza del payout e inizia l’elaborazione.
`payout.on_hold`	Un payout viene messo in pausa o sottoposto a revisione.
`payout.success`	Il payout sul tuo conto bancario viene regolato.
`payout.failed`	Un payout non va a buon fine. I fondi e le commissioni vengono riaccreditati sul tuo wallet.

Gli eventi dei payout non sono né terminali né strettamente ordinati. payout.failed può arrivare dopo payout.success quando una banca restituisce il trasferimento, mentre payout.success può arrivare dopo payout.failed quando un payout non riuscito viene successivamente recuperato. Il campo status del payload corrisponde sempre al tipo di evento; usa quindi timestamp di primo livello di ogni evento per trovare lo stato più recente.

payout.created veniva precedentemente emesso come payout.not_initiated. Se un endpoint esistente applica un filtro su payout.not_initiated, aggiorna il filtro a payout.created affinché continui a trovare le corrispondenze.

Per gli schemi dettagliati dei payload, le descrizioni dei campi e gli esempi di handler, consulta Webhook dei payout.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Eventi di pagamento

Eventi di rimborso

Eventi di contestazione

Eventi degli abbonamenti

Eventi delle chiavi di licenza

Eventi delle concessioni di entitlement

Eventi dei crediti

Eventi di recupero

Eventi di sollecito

Eventi dei payout

​Eventi di pagamento

​Eventi di rimborso

​Eventi di contestazione

​Eventi degli abbonamenti

​Eventi delle chiavi di licenza

​Eventi delle concessioni di entitlement

​Eventi dei crediti

​Eventi di recupero

​Eventi di sollecito

​Eventi dei payout

Eventi di pagamento

Eventi di rimborso

Eventi di contestazione

Eventi degli abbonamenti

Eventi delle chiavi di licenza

Eventi delle concessioni di entitlement

Eventi dei crediti

Eventi di recupero

Eventi di sollecito

Eventi dei payout