BANXICO1 tokenPOST

Comprobante Electrónico de Pago (CEP)

Obtén el Comprobante Electrónico de Pago (CEP) de una transferencia SPEI a partir de la clave de rastreo y los datos de la operación. Útil para validar pagos y conciliar transferencias en flujos contables o de soporte.

Endpoint

POSThttps://api.datosnonstop.com/v1/banxico/cep-spei

Parámetros

json

{
  "tipo": "clave_rastreo",
  "fecha": "2023-02-28",
  "claveRastreo": "123456789987654321",
  "emisor": "40002",
  "receptor": "40058",
  "cuenta": "987654321123456789",
  "monto": 3441.79
}

ParámetroTipoRequeridoDescripción

tipostringSíTipo de búsqueda. Determina cuál campo de identificación de la transferencia debe enviarse. Valores permitidos: clave_rastreo, referencia_numerica.

fechastringSíFecha de la transferencia en formato ISO YYYY-MM-DD.

claveRastreostringNoClave de rastreo asignada por la institución emisora. Requerido cuando tipo es clave_rastreo.

referenciaNumericastringNoReferencia numérica de la transferencia. Requerido cuando tipo es referencia_numerica.

emisorstringSíCódigo de 5 dígitos de la institución emisora del SPEI.

receptorstringSíCódigo de 5 dígitos de la institución receptora del SPEI.

cuentastringSíCuenta destino de la transferencia (CLABE, tarjeta o celular).

montonumberSíMonto exacto de la transferencia en pesos mexicanos.

Ejemplo rápido

Coloca tu API key en el header x-api-key y agrega el header Content-Type: application/json para enviar el body como JSON.

curl

curl -X POST https://api.datosnonstop.com/v1/banxico/cep-spei \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"tipo":"clave_rastreo","fecha":"2023-02-28","claveRastreo":"123456789987654321","emisor":"40002","receptor":"40058","cuenta":"987654321123456789","monto":3441.79}'

Tip

¿Sabías que al pegar un cURL en Postman te crea automáticamente la llamada con todos los elementos?

Token

Cada consulta consume tokens. Lo que no uses, lo conservas — tu saldo se acumula sin fecha de vencimiento ni reinicios. Puedes consultarlo en cualquier momento desde el dashboard o directamente en el header de cada respuesta x-tokens-remaining.

Respuesta

JSON

200 OK

{
  "id": "640299c9b37cb2ea804e6939",
  "status": "found",
  "tipo": "clave_rastreo",
  "claveRastreo": "123456789987654321",
  "fechaOperacion": "2023-02-28",
  "monto": 3441.79,
  "concepto": "pago reserva",
  "iva": 0.00,
  "ordenante": {
    "nombre": "JOSE LOPEZ CASTILLO",
    "rfc": "LOCJ891127J70",
    "banco": {
      "clave": "40002",
      "nombre": "BANAMEX"
    },
    "cuenta": "002180902667895551",
    "tipoCuenta": "CLABE"
  },
  "beneficiario": {
    "nombre": "LUIS ALEJANDRO MAGNO TERCERO",
    "rfc": "MATL900119U24",
    "banco": {
      "clave": "40058",
      "nombre": "BANREGIO"
    },
    "cuenta": "987654321123456789",
    "tipoCuenta": "CLABE"
  }
}

Respuestas en error

JSON

400 Bad Request

[
  {
    "type": "required",
    "message": "El campo es requerido",
    "field": "fecha"
  },
  {
    "type": "catalog",
    "message": "El valor no existe en el catálogo",
    "field": "tipo"
  },
  {
    "type": "required",
    "message": "El campo es requerido",
    "field": "claveRastreo"
  },
  {
    "type": "format",
    "message": "El formato del campo es inválido",
    "field": "monto"
  }
]

Campos

Campos de entrada

CampoTipoDescripción

tipostringTipo de búsqueda. Determina cuál campo de identificación de la transferencia debe enviarse: cuando es clave_rastreo se requiere claveRastreo; cuando es referencia_numerica se requiere referenciaNumerica. Ver catálogo Tipo de búsqueda.

fechastringFecha en que se ejecutó la transferencia SPEI, en formato ISO YYYY-MM-DD.

claveRastreostringIdentificador único asignado por la institución emisora a la transferencia SPEI. Requerido cuando tipo es clave_rastreo.

referenciaNumericastringReferencia numérica que la institución emisora asocia a la transferencia. Requerido cuando tipo es referencia_numerica.

emisorstringCódigo de 5 dígitos asignado por Banxico a la institución que originó la transferencia. Ver catálogo Instituciones SPEI.

receptorstringCódigo de 5 dígitos asignado por Banxico a la institución que recibió la transferencia. Ver catálogo Instituciones SPEI.

cuentastringCuenta destino de la transferencia. Puede ser CLABE (18 dígitos), número de tarjeta o número de celular según el tipo de cuenta del beneficiario.

montonumberMonto exacto de la transferencia en pesos mexicanos. Debe coincidir con el monto registrado en SPEI.

Campos de respuesta

CampoTipoDescripción

idstringIdentificador interno de la consulta, útil para soporte y trazabilidad.

statusstringResultado de la consulta del CEP en Banxico. Ver catálogo Status.

tipostringTipo de búsqueda enviado en la consulta. Refleja el valor recibido en el request. Ver catálogo Tipo de búsqueda.

claveRastreostringClave de rastreo de la transferencia. Solo está presente cuando tipo es clave_rastreo.

referenciaNumericastringReferencia numérica de la transferencia. Solo está presente cuando tipo es referencia_numerica.

messagestringDetalle del motivo cuando status es not_found. Solo está presente en respuestas not_found.

fechaOperacionstringFecha en que se ejecutó la transferencia SPEI registrada por Banxico, en formato ISO YYYY-MM-DD.

montonumberMonto exacto de la transferencia en pesos mexicanos.

conceptostringDescripción libre que la institución emisora asoció a la transferencia.

ivanumberIVA asociado a la transferencia, cuando aplica. Para la mayoría de transferencias entre personas el valor es 0.00.

ordenanteobjectDatos de la persona o entidad que originó la transferencia.

ordenante.nombrestringNombre completo del ordenante registrado en la institución emisora.

ordenante.rfcstringRFC del ordenante registrado en la institución emisora.

ordenante.bancoobjectDatos de la institución bancaria que originó la transferencia.

ordenante.banco.clavestringCódigo de 5 dígitos asignado por Banxico a la institución emisora. Ver catálogo Instituciones SPEI.

ordenante.banco.nombrestringNombre comercial de la institución emisora.

ordenante.cuentastringCuenta del ordenante desde la que se ejecutó la transferencia.

ordenante.tipoCuentastringTipo de cuenta del ordenante. Ver catálogo Tipo de cuenta.

beneficiarioobjectDatos de la persona o entidad que recibió la transferencia.

beneficiario.nombrestringNombre completo del beneficiario registrado en la institución receptora.

beneficiario.rfcstringRFC del beneficiario registrado en la institución receptora.

beneficiario.bancoobjectDatos de la institución bancaria que recibió la transferencia.

beneficiario.banco.clavestringCódigo de 5 dígitos asignado por Banxico a la institución receptora. Ver catálogo Instituciones SPEI.

beneficiario.banco.nombrestringNombre comercial de la institución receptora.

beneficiario.cuentastringCuenta del beneficiario donde se acreditó la transferencia.

beneficiario.tipoCuentastringTipo de cuenta del beneficiario. Ver catálogo Tipo de cuenta.

Catálogos

Tablas de referencia para los valores de los campos enumerados en la sección anterior.

Status

Valores posibles del campo status.

ValorDescripción

foundSe localizó la transferencia en SPEI. La respuesta incluye los datos del CEP.

not_foundNo se localizó la transferencia con el dato consultado (claveRastreo o referenciaNumerica). La respuesta incluye el campo message con el detalle.

Tipo de búsqueda

Valores posibles del campo tipo en la consulta. Define cuál campo de identificación de la transferencia se debe enviar en el request.

ValorDescripción

clave_rastreoBúsqueda por clave de rastreo. Requiere enviar el campo claveRastreo en el body.

referencia_numericaBúsqueda por referencia numérica. Requiere enviar el campo referenciaNumerica en el body.

Tipo de cuenta

Valores posibles del campo tipoCuenta para ordenante y beneficiario.

ValorDescripción

CLABECuenta CLABE de 18 dígitos.

TARJETANúmero de tarjeta de débito asociada a la cuenta.

CELULARNúmero de celular asociado a la cuenta a través de CoDi o Cobro Digital.

Instituciones SPEI

Códigos de 5 dígitos asignados por Banxico a las instituciones participantes en SPEI. Aplica a los campos emisor y receptor de la consulta y a banco.clave del ordenante y del beneficiario.

Consulta el catálogo oficial de instituciones SPEI de Banxico.

Histórico

Endpoint

GEThttps://api.datosnonstop.com/v1/banxico/cep-spei/historico/{id}

El {id} corresponde al campo id devuelto en la respuesta de la consulta principal.

Si necesitas la lista completa de elementos almacenados, accede a tu dashboard.

La respuesta está sujeta al tiempo de almacenamiento de tu plan. Si requieres más tiempo, cambia de plan en tu dashboard.

Respuesta

JSON

200 OK

{
  "id": "640299c9b37cb2ea804e6939",
  "status": "found",
  "tipo": "clave_rastreo",
  "claveRastreo": "123456789987654321",
  "fechaOperacion": "2023-02-28",
  "monto": 3441.79,
  "concepto": "pago reserva",
  "iva": 0.00,
  "ordenante": {
    "nombre": "JOSE LOPEZ CASTILLO",
    "rfc": "LOCJ891127J70",
    "banco": {
      "clave": "40002",
      "nombre": "BANAMEX"
    },
    "cuenta": "002180902667895551",
    "tipoCuenta": "CLABE"
  },
  "beneficiario": {
    "nombre": "LUIS ALEJANDRO MAGNO TERCERO",
    "rfc": "MATL900119U24",
    "banco": {
      "clave": "40058",
      "nombre": "BANREGIO"
    },
    "cuenta": "987654321123456789",
    "tipoCuenta": "CLABE"
  }
}

Respuestas en error

JSON

404 Not Found

[
  {
    "type": "not_found",
    "message": "el id no fue encontrado en el historico"
  }
]

Sandbox

Endpoint

POSThttps://sandbox.api.datosnonstop.com/v1/banxico/cep-spei

Para llamar al sandbox necesitas una API key de sandbox que puedes generar en el dashboard.

curl

curl -X POST https://sandbox.api.datosnonstop.com/v1/banxico/cep-spei \
  -H "x-api-key: tu_api_key_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"tipo":"clave_rastreo","fecha":"2023-02-28","claveRastreo":"123456789987654321","emisor":"40002","receptor":"40058","cuenta":"987654321123456789","monto":3441.79}'

Casos de prueba

Si envías un valor que no esté en la lista, el sandbox devuelve automáticamente una respuesta exitosa con la misma estructura que la de 123456789987654321.

CasoCampoValor

Caso exitoso — Encontrado por claveRastreoclaveRastreo123456789987654321

Caso exitoso — No encontrado por claveRastreoclaveRastreo999999999000000001

Caso exitoso — Encontrado por referenciaNumericareferenciaNumerica1702230

Caso exitoso — No encontrado por referenciaNumericareferenciaNumerica9999999

Sin tokensclaveRastreo333333333000000003

Error internoclaveRastreo444444444000000004

Unavailable serviceclaveRastreo555555555000000005

Endpoint histórico

GEThttps://sandbox.api.datosnonstop.com/v1/banxico/cep-spei/historico/{id}

Para llamar al sandbox necesitas una API key de sandbox que puedes generar en el dashboard.

curl

curl https://sandbox.api.datosnonstop.com/v1/banxico/cep-spei/historico/640299c9b37cb2ea804e6939 \
  -H "x-api-key: tu_api_key_sandbox"

Casos de prueba histórico

Si envías un valor de id que no esté en la lista, el sandbox devuelve automáticamente una respuesta exitosa con la misma estructura que la de 640299c9b37cb2ea804e6939.

Casoid

Caso exitoso640299c9b37cb2ea804e6939

No encontrado0000000000000000ffffffff

Fuera de rango1111111111111111aaaaaaaa

Error interno2222222222222222bbbbbbbb

Empezar gratis →