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.
Eventos de Webhook de Disputa
Uma disputa emite um evento em cada estágio do seu ciclo de vida:dispute.lost com is_resolved_by_rdr: true. Isso é esperado — o reembolso foi emitido automaticamente para evitar um chargeback formal.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.
Status e etapa da disputa
O objeto de disputa informa seu progresso por meio de dois campos:Relacionado
Managing Disputes
Handle Payment Failures
Schema do payload do Webhook
The amount involved in the dispute, represented as a string to accommodate precision.
Brand id this dispute belongs to
The unique identifier of the business involved in the dispute.
The timestamp of when the dispute was created, in UTC.
The currency of the disputed amount, represented as an ISO 4217 currency code.
The customer who filed the dispute
The unique identifier of the dispute.
The current stage of the dispute process.
pre_dispute, dispute, pre_arbitration The current status of the dispute.
dispute_opened, dispute_expired, dispute_accepted, dispute_cancelled, dispute_challenged, dispute_won, dispute_lost The unique identifier of the payment associated with the dispute.
Which processor handled the underlying payment. stripe / adyen for
BYOP routes (the merchant's own payment connector); dodo for
everything Dodo processed itself.
stripe, adyen, dodo Whether the dispute was resolved by Rapid Dispute Resolution
Reason for the dispute
Remarks