Webhook Payloads
Webhook delle contestazioni
Il payload inviato al tuo endpoint webhook quando viene creata o aggiornata una contestazione. Gestisci ogni evento per rispondere alle contestazioni e riconciliare i tuoi dati.
Come tuo Merchant of Record, Dodo Payments gestisce il processo di disputa e chargeback con i circuiti delle carte per tuo conto. Questi webhook mantengono i tuoi sistemi sincronizzati mentre una disputa attraversa il suo ciclo di vita in modo da poter revocare l’accesso, raccogliere prove e conciliare i tuoi registri.
Eventi Webhook di Disputa
Una disputa emette un evento in ogni fase del suo ciclo di vita:Le dispute risolte automaticamente tramite Visa Rapid Dispute Resolution (RDR) appaiono come
dispute.lost con is_resolved_by_rdr: true. Questo è previsto — il rimborso è stato emesso automaticamente per prevenire un chargeback formale.Gli avvisi Ethoca e le deflection non creano mai una contestazione, quindi non emettono eventi
dispute.*. Un rimborso generato da un avviso Ethoca attiva l’evento standard refund.succeeded, mentre qualsiasi annullamento di un abbonamento collegato attiva il consueto evento dell’abbonamento. Una deflection non attiva alcun evento.Gestione degli eventi di contestazione
Quando viene attivatodispute.opened, l’importo contestato viene trattenuto immediatamente. Usa l’evento per aggiornare i tuoi dati e, se intendi contestare la richiesta, raccogli le prove nella dashboard.
Handling dispute events
Stato e fase della contestazione
L’oggetto della contestazione ne indica l’avanzamento attraverso due campi:Correlati
Managing Disputes
Come rispondere alle contestazioni, inviare le prove e come RDR protegge il tuo tasso di contestazioni.
Handle Payment Failures
Rileva e recupera i pagamenti non riusciti prima che diventino contestazioni.
Schema del payload del webhook
Ultima modifica il 26 settembre 2026