> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Disputas

> Encuentra una disputa en el Dashboard de Fintoc, revisa su fecha límite de documentación y envía evidencia para revisión.

Una disputa (contracargo) ocurre cuando tu cliente desconoce un pago con tarjeta ante su emisor. Cada disputa tiene un ID con el prefijo `cb_`. Mientras la disputa está abierta, el monto del pago queda retenido hasta que el emisor resuelva la disputa. Puedes responder una disputa desde el Dashboard subiendo evidencia y enviándola a revisión antes de la fecha límite.

Para responder disputas a través de la API, revisa la [referencia de la API de Disputas](/es/api/payments-api/disputes).

## Antes de comenzar

* Tu organización debe tener habilitados los pagos con tarjeta. La pestaña **Disputas** aparece solo para organizaciones con pagos con tarjeta.
* Para ver disputas, tu usuario necesita acceso **Ver** a **Pagos**.
* Para subir evidencia y enviarla a revisión, tu usuario necesita acceso **Administrar** a **Disputas**. Si tu usuario no tiene este acceso, pide a un administrador de tu organización que lo otorgue o que suba la evidencia por ti. Para más información, revisa [Roles de permisos](/es/guides/home/dashboard/permission-roles).

## Encuentra una disputa

1. En el Dashboard, ve a **Historial de pagos**.
2. Abre la pestaña **Disputas**. El indicador junto a la pestaña muestra cuántas disputas esperan documentación.
3. Para encontrar una disputa específica, filtra por **ID de la disputa** con el ID `cb_` exacto o por **Estado**.
4. Haz clic en la disputa para abrir su página de detalle.

La página de detalle muestra los datos del pago, la línea de tiempo de **Actividad** con la fecha límite de documentación y la sección **Documentos de respaldo**.

## Estados de una disputa

El Dashboard muestra cada estado de la disputa con su valor correspondiente en la API:

| Estado en el Dashboard | Estado en la API | Descripción |
| :- | :- | :- |
| Documentación requerida | `waiting_documentation` | Tu cliente abrió la disputa. Sube evidencia y envíala antes de la fecha límite. |
| En revisión | `in_review` | Enviaste tu evidencia y la disputa está en revisión. No puedes agregar ni eliminar documentos. |
| Disputa ganada | `won` | El emisor resolvió la disputa a tu favor. Recibes los fondos de vuelta. |
| Disputa perdida | `lost` | El emisor resolvió la disputa a favor de tu cliente. No recibes los fondos de vuelta. |
| Vencida | `expired` | La fecha límite pasó sin evidencia enviada. Pierdes la disputa y no recibes los fondos. |

## Fecha límite de documentación

Cada disputa tiene una fecha límite de documentación, que aparece junto a **Fecha límite:** en la página de detalle de la disputa. La API devuelve la fecha límite como `documentation_upload_deadline`. Puedes subir y enviar documentos solo mientras la disputa está en **Documentación requerida** y antes de la fecha límite. Si la fecha límite pasa sin evidencia enviada, la disputa pasa a **Vencida**.

## Sube evidencia y envíala a revisión

Adjunta evidencia relacionada con la venta o el servicio prestado, como boletas, comunicaciones con tu cliente o comprobantes de entrega.

1. Abre la página de detalle de la disputa.
2. En **Documentos de respaldo**, sube uno o más archivos. Cada archivo debe ser PDF, JPEG o PNG y pesar menos de 10 MB.
3. Haz clic en **Enviar documentación**.
4. En el diálogo de confirmación, haz clic nuevamente en **Enviar documentación**.

Después de enviar la evidencia, la disputa pasa a **En revisión**. Ya no puedes agregar ni eliminar documentos de esa disputa.

## Recibe notificaciones de disputas

Para hacer seguimiento a las disputas desde tus sistemas, suscríbete a los eventos de webhook `dispute.*`. Para más información, revisa [Tipos de eventos](/es/api/main-resources/events-reference/types-of-events).
