Disputa

Disputa es la solución de Rapid para la defensa automatizada de contracargos. Mientras Prevención responde al banco para que la disputa no se abra y Alerta 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

Tú envías la transacción, con el id del cobro en el gateway, y las evidencias de la venta
Gateway registra el contracargo cuando el titular abre la disputa
Gateway → Rapid avisa a Rapid al instante, porque tu cuenta del gateway está conectada a Rapid (ver abajo)
Rapid cruza la disputa con tu transacción por el id del cobro
Rapid → Tú te avisa por webhook, si el motivo es fraude, para que cortes el acceso del comprador
Rapid evalúa el caso, arma el dossier con las evidencias y presenta la defensa
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
Evidencias que respalden la venta	son el contenido de la defensa	Evidencia y Captura
Un endpoint para el corte de acceso	lo exigen las reglas de la red de tarjetas	Webhook

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.

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: qué enviar para que la disputa encuentre la transacción
Visión general de evidencias: cómo registrar evidencias
Visión general de captura: cómo capturar señales en el checkout
Payload del webhook: el formato del corte de acceso