Webhook Payloads
Webhooks de Disputas
O payload enviado ao endpoint do seu webhook quando uma disputa é criada ou atualizada. Trate cada evento para responder às disputas e reconciliar seus registros.
Como seu Merchant of Record, a Dodo Payments gerencia o processo de disputa e chargeback com as redes de cartões em seu nome. Esses webhooks mantêm seus sistemas sincronizados à medida que uma disputa avança em seu ciclo de vida para que você possa revogar acesso, reunir evidências e reconciliar seus registros.
Eventos de Webhook de Disputa
Uma disputa emite um evento em cada estágio do seu ciclo de vida:Disputas auto-resolvidas através do Visa Rapid Dispute Resolution (RDR) aparecem como
dispute.lost com is_resolved_by_rdr: true. Isso é esperado — o reembolso foi emitido automaticamente para evitar um chargeback formal.Ethoca alerts e deflections nunca criam uma disputa, portanto não emitem eventos
dispute.*. Um reembolso de um alerta da Ethoca dispara o evento padrão refund.succeeded, e qualquer cancelamento de assinatura vinculado dispara o evento usual de assinatura. Uma deflection não dispara nenhum evento.Tratamento de eventos de disputa
Quandodispute.opened é disparado, o valor contestado é retido imediatamente. Use o evento para atualizar seus registros e, se pretende contestá-lo, reúna evidências no painel.
Handling dispute events
Status e etapa da disputa
O objeto de disputa informa seu progresso por meio de dois campos:Relacionado
Managing Disputes
Como responder a disputas, enviar evidências e como o RDR protege sua taxa de disputas.
Handle Payment Failures
Detecte e recupere pagamentos malsucedidos antes que se tornem disputas.
Schema do payload do Webhook
Última modificação em 26 de setembro de 2026