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

# Modos de integración

> Tiempo real por API vs. por lote en el dashboard — qué se puede programar

El scoring se usa de dos formas, y no se solapan: una es programable, la otra no.

|             | Tiempo real                                   | Por lote                     |
| ----------- | --------------------------------------------- | ---------------------------- |
| Cómo        | `POST /v1/transactions/analyze`               | Subes un CSV en el dashboard |
| Programable | Sí, con tu API key                            | No                           |
| Devuelve    | Una decisión por transacción, en la respuesta | Un reporte PDF + Excel       |

Identidad es otra superficie (verificaciones + webhook), no un tercer modo de scoring.

## Tiempo real

Le mandas una transacción al endpoint y recibes la decisión en la misma respuesta —
sincrónico, un request por transacción. Requiere tu API key (`X-Api-Key`) y una
`X-Idempotency-Key` por transacción. Es el único modo de scoring con superficie
programable hoy.

Para probar sin tráfico live, usa `/analyze/sandbox` en el mismo host de API. Ver
[Entornos](/entornos) y [Tu primera transacción](/integrar/primera-transaccion).

## Por lote

<Note>
  Esto se hace en el dashboard — no hay endpoint público.
</Note>

Subes un CSV desde el dashboard (`sandbox.fraudeg.com` o `fraudeg.com`). El archivo pasa
por mapeo de columnas, ingesta, análisis y generación de reporte, y termina en dos
archivos descargables: un PDF y un Excel. No hay endpoint público para subir el archivo,
consultar su progreso ni descargar el reporte.

Ver [Estados del archivo](/referencia/estados-archivo) para las fases por las que pasa un
archivo cargado.

## ¿Esto lo puedo llamar por API?

Calificar una transacción, sí. Subir un archivo, consultar su estado o bajar el reporte, no
— son acciones del dashboard. Esta es la respuesta permanente a esa pregunta; no cambia
hasta que se documente lo contrario aquí mismo.

Siguiente paso: [Score de riesgo](/conceptos/score-y-decision).
