Disputa
O payload enviado para o seu endpoint webhook quando uma disputa é criada ou atualizada, e como lidar com cada evento do ciclo de vida da disputa.
Eventos de Webhook de Disputa
Uma disputa emite um evento em cada estágio do seu ciclo de vida:| Evento | Dispara quando | O que geralmente significa |
|---|---|---|
dispute.opened | Um portador do cartão abre uma disputa em um pagamento | Fundos são retidos; prepare-se para responder |
dispute.challenged | Evidências foram enviadas para contestar a disputa | A disputa está sendo revisada pela rede |
dispute.accepted | A disputa foi aceita (não contestada) | Os fundos são devolvidos ao portador do cartão |
dispute.cancelled | A disputa foi retirada ou cancelada | Nenhuma ação adicional é necessária |
dispute.expired | O prazo de resposta passou sem resolução | Tipicamente resolve contra você |
dispute.won | A disputa foi resolvida a seu favor | Fundos são retidos |
dispute.lost | A disputa foi resolvida a favor do portador do cartão | Os fundos são devolvidos ao portador do cartão |
dispute.lost com is_resolved_by_rdr: true. Isso é esperado — o reembolso foi emitido automaticamente para evitar um chargeback formal.Tratamento de Eventos de Disputa
Quandodispute.opened dispara, o valor em disputa é retido imediatamente. Use o evento para atualizar seus registros e, se você pretende contestá-lo, reúna evidências no painel.
Status e Etapa da Disputa
O objeto disputa reporta seu progresso através de dois campos:| Campo | Valores |
|---|---|
dispute_status | dispute_opened, dispute_expired, dispute_accepted, dispute_cancelled, dispute_challenged, dispute_won, dispute_lost |
dispute_stage | pre_dispute, dispute, pre_arbitration |
Relacionado
Managing Disputes
Handle Payment Failures
Esquema de Payload de Webhook
The amount involved in the dispute, represented as a string to accommodate precision.
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 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.
Whether the dispute was resolved by Rapid Dispute Resolution
Remarks