Empezar · 03

Ciclo de vida asíncrono

Una verificación consulta varias fuentes externas y tarda algunos minutos. Por eso la API es asíncrona: POST responde de inmediato y el resultado llega después.

Los dos estados finales no cambian después.

Estados

Estado	Qué significa	Cobro	Aviso
`en_proceso`	Revísame está consultando las fuentes.	`cobro.estatus: null`	—
`emitida`	Hay una recomendación con acción, sustento documental y factores.	Un cargo	Webhook `verificacion.emitida`
`no_concluyente`	No se pudo concluir una recomendación (por ejemplo, fuentes no disponibles o tiempo agotado).	No se cobra (`no_aplicada`)	Sin webhook: se ve con `GET`

Importante: no hay webhook para no_concluyente. Si solo esperas webhooks, programa además un sondeo de respaldo: cualquier verificación que siga sin webhook después de ~11 minutos debe consultarse con GET /v1/verificaciones/{verificacion_id}.

Tiempos

Una verificación típica tarda unos minutos (del orden de 3 a 4).
Cada verificación tiene un presupuesto de tiempo total (10 minutos por omisión). Si se agota sin resultado, termina en no_concluyente sin cobro.

Sondeo recomendado

espera = 5 s
mientras estado == "en_proceso" y transcurrido < 11 min:
    dormir(espera)
    GET /v1/verificaciones/{verificacion_id}
    espera = min(espera × 1.5, 30 s)

No sondees más de una vez cada 5 segundos por verificación.
Si recibes el webhook, detén el sondeo de esa verificación.
Para reconciliar en lote usa GET /v1/verificaciones?estado=en_proceso.

Reintentos y reinicios

El reintento de POST con la misma Idempotency-Key devuelve la misma verificación, incluso si sigue en_proceso; no dispara un segundo proceso. Ver Idempotencia.