Skip to main content
Necesitas una cuenta de Veripay y una API key. Crea ambas gratis en el dashboard.

1. Crear una API key

  1. Inicia sesión en veripay.datagora.mx/dashboard.
  2. Ve a API keys → Crear.
  3. Asigna un nombre descriptivo (p. ej. backend-prod).
  4. Copia el valor vk_live_.... Sólo se muestra una vez.
Guarda la key como secreto en tu backend. Nunca la expongas en frontend ni la subas a Git.

2. Hacer tu primera llamada

El endpoint POST /api/v1/cep/xml_auto descarga el CEP en XML e infiere automáticamente emisor y receptor a partir de la CLABE.
curl -sS -X POST "https://veripay.datagora.mx/api/v1/cep/xml_auto" \
  -H "Content-Type: application/json" \
  -H "x-api-key: vk_live_xxxxxxxx.SECRETO" \
  -d '{
    "fecha": "2025-08-15",
    "clave_rastreo": "CR12345678",
    "cuenta": "012180001234567890",
    "monto": 1234.56
  }' \
  --output cep.xml

3. Interpretar la respuesta

  • 200 OK + cuerpo binario XML → CEP encontrado y firmado por Banxico.
  • Headers X-Inferred-Emisor / X-Inferred-Receptor te indican qué dedujo el gateway.
  • 404 NOT_FOUND → Banxico no tiene registro con esos parámetros (revisa fecha ±1 día y monto exacto).
  • 400 INFERENCE_FAILED → No se pudo inferir el banco; usa la versión sin _auto con emisor/receptor explícitos.

4. Otros formatos disponibles

EndpointDevuelveCuándo usarlo
/v1/cep/xml_autoapplication/xmlDefault, parseable y compacto
/v1/cep/pdf_autoapplication/pdfAdjuntar a clientes / facturación
/v1/cep/zip_autoapplication/zipPDF + XML en un solo request
/v1/cep/base64application/jsonCliente sin soporte binario
/v1/cep/xmlapplication/xmlSi ya conoces emisor + receptor

Siguiente paso

Explora todos los endpoints en la Referencia API con playground interactivo.