Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
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). |
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. |
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. |
