Webhook Payloads
Webhooks de disputas
La carga útil enviada a tu endpoint de webhook cuando se crea o actualiza una disputa. Gestiona cada evento para responder a las disputas y conciliar tus registros.
Como tu Merchant of Record, Dodo Payments gestiona el proceso de disputas y contracargos con las redes de tarjetas en tu nombre. Estos webhooks mantienen tus sistemas sincronizados a medida que una disputa avanza en su ciclo de vida, para que puedas revocar el acceso, recopilar evidencia y conciliar tus registros.
Eventos de Webhook de Disputa
Una disputa emite un evento en cada etapa de su ciclo de vida:Las disputas resueltas automáticamente a través de Visa Rapid Dispute Resolution (RDR) aparecen como
dispute.lost con is_resolved_by_rdr: true. Esto es esperado: el reembolso se emitió automáticamente para prevenir un contracargo formal.Las alertas de Ethoca y las desviaciones nunca crean una disputa, por lo que no emiten eventos
dispute.*. Un reembolso por una alerta de Ethoca activa el evento estándar refund.succeeded, y cualquier cancelación de suscripción vinculada activa el evento habitual de suscripción. Una desviación no activa ningún evento.Gestión de eventos de disputa
Cuando se activadispute.opened, el importe disputado se retiene de inmediato. Usa el evento para actualizar tus registros y, si tienes la intención de impugnarlo, recopila pruebas en el dashboard.
Handling dispute events
Estado y etapa de la disputa
El objeto de disputa informa de su progreso mediante dos campos:Relacionado
Managing Disputes
Cómo responder a las disputas, enviar pruebas y cómo RDR protege tu tasa de disputas.
Handle Payment Failures
Detecta y recupera los pagos fallidos antes de que se conviertan en disputas.
Esquema de carga útil del webhook
Última modificación el 26 de septiembre de 2026