Disputa
La carga útil enviada a tu endpoint de webhook cuando se crea o actualiza una disputa, y cómo manejar cada evento del ciclo de vida de la disputa.
Eventos de Webhook de Disputa
Una disputa emite un evento en cada etapa de su ciclo de vida:| Evento | Dispara cuando | Lo que usualmente significa |
|---|---|---|
dispute.opened | Un titular de tarjeta abre una disputa sobre un pago | Los fondos están retenidos; prepárate para responder |
dispute.challenged | Se ha presentado evidencia para impugnar la disputa | La disputa está siendo revisada por la red |
dispute.accepted | La disputa fue aceptada (no impugnada) | Los fondos son devueltos al titular de la tarjeta |
dispute.cancelled | La disputa fue retirada o cancelada | No se necesita más acción |
dispute.expired | El período de respuesta pasó sin resolución | Típicamente se resuelve en tu contra |
dispute.won | La disputa se resolvió a tu favor | Los fondos son retenidos |
dispute.lost | La disputa se resolvió a favor del titular de la tarjeta | Los fondos son devueltos al titular de la tarjeta |
dispute.lost con is_resolved_by_rdr: true. Esto es esperado: el reembolso se emitió automáticamente para prevenir un contracargo formal.Manejo de Eventos de Disputa
Cuandodispute.opened se dispara, el monto disputado se retiene inmediatamente. Usa el evento para actualizar tus registros y, si planeas impugnarlo, recopila evidencia en el panel de control.
Estado y Etapa de la Disputa
El objeto de disputa informa su progreso a través de dos 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 Carga Útil del 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