Consulta el estado real de una sesión

El aviso firmado es el camino normal, pero no el único. Si tu servidor estuvo caído, si un pedido lleva demasiado tiempo «en espera» o si quieres cuadrar los cobros del día, pregunta directamente.

1. Busca el sesionId que guardaste junto al pedido.

2. Consulta la sesión con tu clave:

   curl -s "<URL_DEL_MERCHANT>/api/v1/checkout/sesiones/CS7Hq2mVx0Ld" \
     -H "X-API-Key: <TU_CLAVE_API>"

3. Mira estado y, si es APROBADA, el bloque resultado.recibo. La respuesta también trae la lista de intentos, útil para entender qué pasó cuando hubo rechazos antes del pago.

4. Actualiza tu pedido con ese estado, igual que si hubiera llegado el aviso.

Para cuadrar el día

Lista las sesiones de un intervalo, opcionalmente filtradas por estado:

curl -s "<URL_DEL_MERCHANT>/api/v1/checkout/sesiones?desde=2026-10-04T00:00:00Z&hasta=2026-10-05T00:00:00Z&estado=APROBADA&max=500" \
  -H "X-API-Key: <TU_CLAVE_API>"

Las más recientes vienen primero. max admite hasta 500 (100 si no lo indicas). Compara la lista con tus pedidos pagados: cada APROBADA debe corresponder a un pedido entregado, y al revés.

Un pedido en duda no se cobra otra vez

Si la consulta dice EN_DUDA, FINORA todavía está averiguando con el banco qué pasó. No abras otra sesión para el mismo pedido: espera el segundo aviso o consulta más tarde.

Si algo sale mal

Respuesta	Qué significa
404 SESION_NO_ENCONTRADA	La sesión no existe o no es de tu comercio. FINORA no distingue los dos casos a propósito
401 CLAVE_INVALIDA	La clave falta, es incorrecta o fue revocada