# Disputa

> Cómo Disputa arma y presenta la defensa del contracargo, qué necesita Rapid de ti y el corte de acceso en disputas por fraude.

Página: https://doc.rapidchargeback.com/es/produtos/disputa/visao-geral/

**Disputa** es la solución de Rapid para la **defensa automatizada de contracargos**. Mientras [Prevención](https://doc.rapidchargeback.com/es/produtos/prevencao/visao-geral/) responde al banco para que la disputa no se abra y [Alerta](https://doc.rapidchargeback.com/es/produtos/alerta/visao-geral/) avisa antes de que se convierta en contracargo, Disputa actúa después: cuando el contracargo ya entró, Rapid arma y presenta la defensa (*second presentment*) dentro del plazo de la red de tarjetas.

La defensa se construye con lo que ya envías: la transacción, las evidencias registradas y las señales capturadas en el checkout. Cuanto más material, mayor la probabilidad de ganar.

## Cómo funciona

1. **Tú** envías la transacción, con el id del cobro en el gateway, y las evidencias de la venta
2. **Gateway** registra el contracargo cuando el titular abre la disputa
3. **Gateway → Rapid** avisa a Rapid al instante, porque tu cuenta del gateway está conectada a Rapid (ver abajo)
4. **Rapid** cruza la disputa con tu transacción por el id del cobro
5. **Rapid → Tú** te avisa por webhook, si el motivo es fraude, para que cortes el acceso del comprador
6. **Rapid** evalúa el caso, arma el dossier con las evidencias y presenta la defensa
7. **Gateway → Rapid** devuelve el resultado, que aparece en el panel

Tu trabajo está en los pasos 1 y 5, destacados: el material que envías antes de que todo pase y el corte de acceso. El resto es de Rapid.

## Qué necesita Rapid de ti

| Qué | Por qué | Dónde |
|---|---|---|
| Tu cuenta del gateway de pagos conectada a Rapid | es por donde llega la disputa; sin la conexión, no aparece ninguna disputa | Panel, en **Configuración › Integraciones**: solo autorizar, sin código |
| La transacción, con el id del cobro en el gateway | sin ella la disputa llega sin historial y sin evidencias | [Crear transacción](https://doc.rapidchargeback.com/es/canais/transactions/criar-transacao/) |
| Evidencias que respalden la venta | son el contenido de la defensa | [Evidencia](https://doc.rapidchargeback.com/es/canais/evidence/visao-geral/) y [Captura](https://doc.rapidchargeback.com/es/canais/capture/visao-geral/) |
| Un endpoint para el corte de acceso | lo exigen las reglas de la red de tarjetas | [Webhook](https://doc.rapidchargeback.com/es/canais/webhook/visao-geral/) |

El punto que más rompe integraciones es la transacción. La disputa encuentra la transacción por el identificador del cobro en el gateway, así que el campo `transaction_id` (o `external_source` más `external_id`) tiene que llevar ese valor. Una transacción no encontrada significa una defensa sin los datos de autenticación, sin evidencias adjuntas y sin el historial del pedido.

## Corte de acceso en disputas por fraude

Cuando la disputa es por fraude, las redes de tarjetas exigen que el comercio intente revocar el producto o servicio entregado y tenga un proceso para evitar la reincidencia. Para eso, Rapid dispara el evento `dispute.fraud.revoke_access` en tu webhook, con las acciones exigidas y el plazo.

Es el único punto de Disputa en el que Rapid llama a tu sistema. Trátalo de forma automática si es posible: cuanto más rápido el corte, menor la pérdida. El formato está en [Payload del webhook](https://doc.rapidchargeback.com/es/canais/webhook/payload/#evento-disputefraudrevoke_access).

Si la entrega falla, el pendiente aparece en el panel para que alguien de tu equipo lo confirme a mano.

## Situaciones de la disputa

| Situación | Qué significa |
|---|---|
| `received` | llegó y está en evaluación |
| `submitted` | defensa enviada al gateway, esperando el resultado |
| `won` | disputa ganada |
| `lost` | disputa perdida |
| `accepted` | el caso no se contestó |
| `needs_review` | Rapid no pudo identificar al vendedor y el equipo lo está revisando |

No todo contracargo se contesta. Rapid evalúa caso por caso: cuando las reglas de la red de tarjetas no dan derecho a contestar, o cuando el material disponible no sostiene la defensa, el caso se marca como no contestado en vez de gastar el plazo en una presentación perdida.

## Requisitos de configuración

- el producto **Disputa** activo en tu empresa
- la cuenta de tu gateway de pagos conectada en el panel, en **Configuración › Integraciones**
- un webhook activo, si quieres recibir el corte de acceso

La conexión del gateway se hace en el panel, sin código: creas una clave restringida en la plataforma de pagos, la pegas en el panel y registras la dirección que el panel muestre. El soporte de Rapid acompaña este paso.

## Próximos pasos

- [Crear transacción](https://doc.rapidchargeback.com/es/canais/transactions/criar-transacao/): qué enviar para que la disputa encuentre la transacción
- [Visión general de evidencias](https://doc.rapidchargeback.com/es/canais/evidence/visao-geral/): cómo registrar evidencias
- [Visión general de captura](https://doc.rapidchargeback.com/es/canais/capture/visao-geral/): cómo capturar señales en el checkout
- [Payload del webhook](https://doc.rapidchargeback.com/es/canais/webhook/payload/): el formato del corte de acceso