Vai al contenuto principale
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 NameEvent TypeDescription
Payment Succeededpayment.succeededViene attivato quando un pagamento viene elaborato con successo.
Payment Failedpayment.failedSi verifica quando un tentativo di pagamento fallisce a causa di errori, carte rifiutate o altri problemi.
Payment Processingpayment.processingIndica che un pagamento è attualmente in fase di elaborazione.
Payment Cancelledpayment.cancelledViene attivato quando un pagamento viene annullato prima del completamento.

Eventi di Rimborso

Event NameEvent TypeDescription
Refund Succeededrefund.succeededViene attivato quando un rimborso viene elaborato con successo.
Refund Failedrefund.failedSi verifica quando un tentativo di rimborso fallisce a causa di errori di elaborazione o altri problemi.

Eventi di Controversia

Event NameEvent TypeDescription
Dispute Openeddispute.openedViene attivato quando un cliente avvia una controversia.
Dispute Expireddispute.expiredIndica che una controversia è scaduta senza risoluzione.
Dispute Accepteddispute.acceptedViene attivato quando un commerciante accetta la controversia.
Dispute Cancelleddispute.cancelledSi verifica quando una controversia viene annullata dal cliente o dal sistema.
Dispute Challengeddispute.challengedViene attivato quando un commerciante contesta una controversia.
Dispute Wondispute.wonIndica che il commerciante ha vinto con successo una controversia.
Dispute Lostdispute.lostSi verifica quando il commerciante perde una controversia.

Eventi di Abbonamento

Event NameEvent TypeDescription
Subscription Activesubscription.activeIndica che un abbonamento è ora attivo e sono programmati addebiti ricorrenti.
Subscription Updatedsubscription.updatedViene attivato quando viene aggiornato qualsiasi campo dell’abbonamento (sincronizzazione in tempo reale senza polling).
Subscription On Holdsubscription.on_holdViene attivato quando un abbonamento viene messo temporaneamente in pausa a causa di un rinnovo non riuscito.
Subscription Renewedsubscription.renewedSi verifica quando un abbonamento viene rinnovato con successo.
Subscription Plan Changedsubscription.plan_changedViene attivato quando un abbonamento viene aggiornato, retrocesso o modificato con addon diversi.
Subscription Cancelledsubscription.cancelledViene attivato quando un abbonamento viene annullato dal commerciante o dal cliente.
Subscription Failedsubscription.failedIndica un abbonamento fallito. Ciò significa che non siamo riusciti a creare un mandato.
Subscription Expiredsubscription.expiredViene attivato quando un abbonamento raggiunge la fine del suo periodo e scade.

Eventi di Chiave di Licenza

Event NameEvent TypeDescription
License Key Createdlicense_key.createdViene attivato quando viene creata una nuova chiave di licenza per un prodotto.

Eventi di Credito

Nome eventoTipo di eventoDescrizione
Credito Aggiuntocredit.addedAttivato quando vengono concessi crediti a un cliente (abbonamento, acquisto singolo, componente aggiuntivo o API).
Credito Detrattocredit.deductedSi verifica quando i crediti vengono consumati tramite utilizzo o addebito manuale.
Credito Scadutocredit.expiredAttivato quando i crediti inutilizzati scadono dopo il periodo di validità configurato.
Credito Trasferitocredit.rolled_overSi verifica quando i crediti inutilizzati vengono portati avanti in una nuova assegnazione alla fine del ciclo.
Rollover Perditàcredit.rollover_forfeitedAttivato quando i crediti vengono annullati perché è stato raggiunto il numero massimo di rollover.
Addebito Oltre il Limitecredit.overage_chargedSi verifica quando vengono applicati addebiti per l’utilizzo oltre il saldo zero.
Regolazione Manualecredit.manual_adjustmentAttivato quando viene effettuata una regolazione manuale di crediti o addebiti.
Saldo Bassocredit.balance_lowAttivato quando il saldo dei crediti scende al di sotto della soglia configurata.
Questi eventi webhook sono progettati per fornire ai commercianti aggiornamenti fondamentali per gestire efficacemente le loro operazioni. Implementa gestori robusti per ciascun evento rilevante nella tua integrazione webhook per garantire funzionalità fluide e affidabili.