Docs
EN

Esta guía te lleva desde cero a obtener el Comprobante Electrónico de Pago (CEP) de una transferencia SPEI en Banxico. Asume que ya iniciaste sesión en la consola.

1. Obtener tu API key

Desde la consola de Veriko, ve a la sección API y abre el panel API Key. Haz clic en Generar o Regenerar y copia tu clave. Solo se muestra una vez, si la pierdes deberás regenerarla.

Tu clave tiene este formato:

veriko_<64 caracteres>

2. Haz tu primera validación

POST /v1/validate Valida una transferencia SPEI e intenta obtener el CEP de Banxico. Los parámetros básicos son: fecha, monto, emisor y al menos uno entre clave_rastreo y referencia_numerica.

curl -X POST 'https://api.veriko.mx/v1/validate' \
  -H 'Authorization: Bearer veriko_••••' \
  -H 'Content-Type: application/json' \
  -d '{
    "fecha": "2025-03-15",
    "monto": 15000.50,
    "clave_rastreo": "MXBA20250315001234",
    "cuenta_beneficiaria": "012180004412345678",
    "emisor": "40012"
  }'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

Los campos emisor y receptor se refieren a los bancos de las partes correspondientes.
Son formato 'string' y pueden enviarse como código bancario o como nombre de banco (revisa la lista códigos y bancos o el endpoint v1/public/banks). Ejemplo: "emisor": "40012" o "emisor": "BBVA MEXICO".

NOTA: El campo receptor es opcional cuando cuenta_beneficiaria es una CLABE o Tarjeta. Para celulares (10 dígitos) es obligatorio si no tienes ya un beneficiario guardado con ese número celular.

Referencia completa en: POST /v1/validate

3. Interpretar la respuesta

Una respuesta exitosa vuelve con HTTP 200 y este formato:

{
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "type": "direct",
    "status": "valid",
    "fecha": "2025-03-15",
    "monto": 15000.50,
    "has_cep": true
  },
  "meta": {
    "version": "1.x.x",
    "api_version": "v1",
    "request_id": "...",
    "datetime": { "timezone": "UTC", "format": "ISO 8601" }
  }
}

Los parámetros más importantes:

  • data.id: ID de la validación. Se utiliza para descargar el CEP, consultar reintentos, o usar Idempotencia.
  • data.status: Veredicto de la validación. Puede ser alguno de los siguientes valores:
    valid: El CEP existe y los datos coinciden.
    not_found: El CEP no fue encontrado.
    cep_unavailable: El pago fue identificado pero el CEP no está disponible ahora.
    error: Hubo una falla no recuperable.
  • has_cep: Indica si la validación arrojó un comprobante CEP.

Referencia completa en: POST /v1/validate

4. Opcional: Registrar beneficiarios

Un beneficiario se refiere a una cuenta bancaria (Clabe, Tarjeta o Celular) en la que recibes transferencias SPEI. En Veriko, puedes guardar cada una de esas cuentas:

  1. Ayudan en las validaciones desde imagen (OCR) a identificar la cuenta_beneficiaria cuando está enmascarada o incompleta (común en algunos comprobantes).
  2. Útil si manejas vendedores o diferentes cuentas bancarias.
  3. Reportes y estadísticas financieras de cada una.

Revisa la entrada Crear beneficiario para registrar el primero y facilitar las Validaciones desde imagen (OCR).

5. Cómo continuar