Guida agli Eventi Webhook - Dodo Payments Documentation

Dodo Payments fornisce notifiche webhook in tempo reale per tenerti informato su eventi critici relativi a transazioni, abbonamenti, rimborsi, controversie e gestione delle chiavi di licenza. Di seguito è riportata una guida dettagliata a questi eventi, categorizzati per chiarezza, insieme a suggerimenti e considerazioni per l’implementazione.

Eventi di Pagamento

Event Name	Event Type	Description
Payment Succeeded	`payment.succeeded`	Viene attivato quando un pagamento viene elaborato con successo.
Payment Failed	`payment.failed`	Si verifica quando un tentativo di pagamento fallisce a causa di errori, carte rifiutate o altri problemi.
Payment Processing	`payment.processing`	Indica che un pagamento è attualmente in fase di elaborazione.
Payment Cancelled	`payment.cancelled`	Viene attivato quando un pagamento viene annullato prima del completamento.

Eventi di Rimborso

Event Name	Event Type	Description
Refund Succeeded	`refund.succeeded`	Viene attivato quando un rimborso viene elaborato con successo.
Refund Failed	`refund.failed`	Si verifica quando un tentativo di rimborso fallisce a causa di errori di elaborazione o altri problemi.

Eventi di Controversia

Event Name	Event Type	Description
Dispute Opened	`dispute.opened`	Viene attivato quando un cliente avvia una controversia.
Dispute Expired	`dispute.expired`	Indica che una controversia è scaduta senza risoluzione.
Dispute Accepted	`dispute.accepted`	Viene attivato quando un commerciante accetta la controversia.
Dispute Cancelled	`dispute.cancelled`	Si verifica quando una controversia viene annullata dal cliente o dal sistema.
Dispute Challenged	`dispute.challenged`	Viene attivato quando un commerciante contesta una controversia.
Dispute Won	`dispute.won`	Indica che il commerciante ha vinto con successo una controversia.
Dispute Lost	`dispute.lost`	Si verifica quando il commerciante perde una controversia.

Eventi di Abbonamento

Event Name	Event Type	Description
Subscription Active	`subscription.active`	Indica che un abbonamento è ora attivo e sono programmati addebiti ricorrenti.
Subscription Updated	`subscription.updated`	Viene attivato quando viene aggiornato qualsiasi campo dell’abbonamento (sincronizzazione in tempo reale senza polling).
Subscription On Hold	`subscription.on_hold`	Viene attivato quando un abbonamento viene messo temporaneamente in pausa a causa di un rinnovo non riuscito.
Subscription Renewed	`subscription.renewed`	Si verifica quando un abbonamento viene rinnovato con successo.
Subscription Plan Changed	`subscription.plan_changed`	Viene attivato quando un abbonamento viene aggiornato, retrocesso o modificato con addon diversi.
Subscription Cancelled	`subscription.cancelled`	Viene attivato quando un abbonamento viene annullato dal commerciante o dal cliente.
Subscription Failed	`subscription.failed`	Indica un abbonamento fallito. Ciò significa che non siamo riusciti a creare un mandato.
Subscription Expired	`subscription.expired`	Viene attivato quando un abbonamento raggiunge la fine del suo periodo e scade.

Eventi di Chiave di Licenza

Event Name	Event Type	Description
License Key Created	`license_key.created`	Viene attivato quando viene creata una nuova chiave di licenza per un prodotto.

Eventi di Concessione dei Diritti

Nome Evento	Tipo di Evento	Descrizione
Grant Created	`entitlement_grant.created`	Viene creata una nuova concessione di diritti per un cliente. Le concessioni delle chiavi di licenza arrivano `delivered`; le concessioni basate su OAuth (Discord, GitHub, Notion) arrivano `pending`.
Grant Delivered	`entitlement_grant.delivered`	Il completamento della concessione è avvenuto: chiave di licenza emessa, link ai file risolti o accesso alla piattaforma concesso.
Grant Failed	`entitlement_grant.failed`	La concessione non è riuscita; controlla `error_code` e `error_message`.
Grant Revoked	`entitlement_grant.revoked`	L’accesso è stato revocato; controlla `revocation_reason` (stato dell’abbonamento, rimborso, cambio piano o manuale).

Per schemi di payload dettagliati, eventi di esempio e il riferimento completo revocation_reason, vedere Entitlement Grant Webhooks.

Eventi di Credito

Nome Evento	Tipo di Evento	Descrizione
Credit Added	`credit.added`	Attivato quando i crediti vengono concessi a un cliente (abbonamento, una tantum, componente aggiuntivo o API).
Credit Deducted	`credit.deducted`	Si verifica quando i crediti vengono consumati tramite utilizzo o addebito manuale.
Credit Expired	`credit.expired`	Attivato quando i crediti non utilizzati scadono dopo il periodo di scadenza configurato.
Credit Rolled Over	`credit.rolled_over`	Si verifica quando i crediti non utilizzati vengono trasferiti a una nuova concessione alla fine del ciclo.
Rollover Forfeited	`credit.rollover_forfeited`	Attivato quando i crediti vengono persi perché è stato raggiunto il massimo conteggio di rollover.
Overage Charged	`credit.overage_charged`	Si verifica quando vengono applicati addebiti per eccedenza per l’uso oltre il saldo zero.
Manual Adjustment	`credit.manual_adjustment`	Attivato quando viene effettuata una regolazione manuale di credito o debito.
Balance Low	`credit.balance_low`	Attivato quando il saldo del credito scende al di sotto della soglia configurata.

Eventi di Recupero

Nome Evento	Tipo di Evento	Descrizione
Abandoned Checkout Detected	`abandoned_checkout.detected`	Attivato quando viene rilevato un checkout incompleto o non riuscito dopo 60 minuti.
Abandoned Checkout Recovered	`abandoned_checkout.recovered`	Si verifica quando un cliente completa il pagamento tramite un link di recupero.

Per schemi dettagliati del payload, descrizioni dei campi ed esempi di handler, vedere Webhook di Recupero.

Eventi di Sollecito

Nome Evento	Tipo di Evento	Descrizione
Dunning Started	`dunning.started`	Attivato quando un tentativo di sollecito inizia per un abbonamento messo in pausa o cancellato.
Dunning Recovered	`dunning.recovered`	Si verifica quando un cliente aggiorna il proprio metodo di pagamento e l’addebito risultante ha successo.

Per schemi di payload dettagliati, descrizioni dei campi ed esempi di gestione, vedere Recovery Webhooks. Questi eventi webhook sono progettati per fornire ai commercianti aggiornamenti critici per gestire efficacemente le loro operazioni. Implementa gestori robusti per ciascun evento pertinente nella tua integrazione webhook per assicurare funzionalità fluide e affidabili.

​Eventi di Pagamento

​Eventi di Rimborso

​Eventi di Controversia

​Eventi di Abbonamento

​Eventi di Chiave di Licenza

​Eventi di Concessione dei Diritti

​Eventi di Credito

​Eventi di Recupero

​Eventi di Sollecito