Introducción - Veripay

Base URL

https://veripay.datagora.mx/api

Todos los endpoints públicos están bajo el prefijo /v1/cep/*. Las rutas de gestión (/keys, /admin/*) usan sesión de Supabase y no son consumibles desde código de cliente.

Autenticación

x-api-key: vk_live_xxxxxxxx.SECRETO

Genera tu key en el dashboard. Detalles en Autenticación.

Convenciones


Encoding	UTF-8
Content-Type request	`application/json`
Errores	JSON `{ error, message, details? }` — ver Errores
Versionado	Prefijo `/v1`. Cambios breaking subirán a `/v2`.
Idempotencia	Las descargas son seguras de reintentar; el CEP es inmutable por (`fecha`, `clave_rastreo`, `monto`).
Timeout sugerido	`15s` por request

Tipos de endpoints CEP

Modo explícito

/v1/cep/{xml,pdf,base64,xml_base64} — requieren emisor y receptor (códigos Banxico de 5 dígitos).

Modo auto

/v1/cep/{xml,pdf,zip}_auto — infieren emisor/receptor desde la cuenta. Ver Inferencia.

Headers de respuesta útiles

Header	Significado
`X-Inferred-Emisor`	Código Banxico inferido (sólo `_auto`)
`X-Inferred-Receptor`	Código Banxico inferido (sólo `_auto`)
`X-Date-Used`	Fecha exacta consultada en Banxico
`X-Attempts`	Intentos realizados antes del hit
`X-Request-Id`	ID único del request, úsalo al contactar soporte