API Comprobante CEP

Descarga y verifica comprobantes electrónicos de pago SPEI de Banco de México.

Se requiere una API key para usar esta API. Fuente oficial Banxico CEP.

Regístrate para Comenzar

Características

✓ Descarga de Comprobantes

Descarga comprobantes de pago SPEI completos en XML con datos de transacción: beneficiario, ordenante, monto y clave de rastreo.

✓ Consulta Rápida de Estado

Verifica el estado de un pago sin descargar el comprobante completo. Ideal para confirmación de pagos en tiempo real.

✓ Directorio de Instituciones

Lista todas las instituciones financieras registradas en el sistema SPEI para cualquier fecha.

✓ Datos de Transacción Parseados

Campos extraídos automáticamente: beneficiario, ordenante, monto, fecha, clave de rastreo, referencia numérica e instituciones.

Endpoints API

1. Descarga de Comprobante de Pago

GET https://api.tlaloc.sh/mx/v1/cep?fecha={fecha}&tipo_criterio={tipo_criterio}&criterio={criterio}&emisor={emisor}&receptor={receptor}&cuenta={cuenta}&monto={monto}

Parámetros

Parámetro Tipo Requerido Descripción
fecha string Sí Fecha de la transacción (YYYY-MM-DD)
tipo_criterio string Sí Tipo de criterio de búsqueda (ej. "T" para clave de rastreo)
criterio string Sí Valor de búsqueda (clave de rastreo o referencia numérica)
emisor string Sí Código de la institución emisora
receptor string Sí Código de la institución receptora
cuenta string Sí Número de cuenta del beneficiario
monto string Sí Monto de la transacción

Ejemplo de Solicitud

curl -X GET "https://api.tlaloc.sh/mx/v1/cep?fecha=2025-01-15&tipo_criterio=T&criterio=MHETRE010115&emisor=40002&receptor=40012&cuenta=012180015025252000&monto=1500.00"

Ejemplo de Respuesta

{
  "found": true,
  "beneficiario": "JUAN PEREZ LOPEZ",
  "ordenante": "MARIA GARCIA HERNANDEZ",
  "monto": "1500.00",
  "fecha_operacion": "2025-01-15",
  "clave_rastreo": "MHETRE010115",
  "referencia_numerica": "1234567",
  "estado": "Liquidado",
  "institucion_emisora": "BANAMEX",
  "institucion_receptora": "BBVA MEXICO",
  "xml_content": "<?xml version='1.0'?>..."
}

2. Consulta Rápida de Estado

GET https://api.tlaloc.sh/mx/v1/cep_query?fecha={fecha}&tipo_criterio={tipo_criterio}&criterio={criterio}&emisor={emisor}&receptor={receptor}

Parámetros

Parámetro Tipo Requerido Descripción
fecha string Sí Fecha de la transacción (YYYY-MM-DD)
tipo_criterio string Sí Tipo de criterio de búsqueda
criterio string Sí Valor de búsqueda
emisor string Sí Código de la institución emisora
receptor string Sí Código de la institución receptora

Ejemplo de Respuesta

{
  "found": true,
  "estado": "Liquidado",
  "detalle": {
    "Estado del pago en Banxico": "Liquidado",
    "Fecha de operación": "15/01/2025",
    "Clave de rastreo": "MHETRE010115"
  }
}

3. Instituciones Financieras

GET https://api.tlaloc.sh/mx/v1/cep/instituciones?fecha={fecha}

Parámetros

Parámetro Tipo Requerido Descripción
fecha string Sí Fecha para consultar instituciones (YYYY-MM-DD)

Ejemplo de Respuesta

[
  {"codigo": "40002", "nombre": "BANAMEX"},
  {"codigo": "40012", "nombre": "BBVA MEXICO"},
  {"codigo": "40014", "nombre": "SANTANDER"}
]

Casos de Uso

Conciliación de Pagos

Verifica y concilia automáticamente pagos SPEI contra tus registros.

Prevención de Fraude

Valida comprobantes de pago enviados por clientes para detectar recibos falsificados.

Automatización Contable

Extrae datos estructurados de transacciones de comprobantes CEP para contabilidad automatizada.

Cumplimiento Normativo

Mantén registros de pago verificables con documentación oficial de Banxico.

Ver Documentación Completa Contactar Ventas

Preguntas Frecuentes

¿Qué es un CEP?

El Comprobante Electrónico de Pago que emite Banco de México por cada transferencia SPEI liquidada. Es el documento oficial que prueba que un pago existió, de qué cuenta salió, a cuál llegó y por qué monto.

¿Qué datos necesito para consultar un pago?

La fecha de la operación, la clave de rastreo (o referencia numérica), los códigos de banco emisor y receptor, y para la descarga completa, la CLABE del beneficiario y el monto. Con GET /v1/cep/instituciones obtienes el catálogo de códigos de banco.

¿Cuál es la diferencia entre /v1/cep y /v1/cep_query?

/v1/cep_query confirma rápido el estado del pago (¿existe?, ¿está liquidado?). /v1/cep descarga el comprobante completo con todos los campos parseados y el XML oficial de Banxico. Ambas cuestan $0.10 MXN.

¿Sirve para conciliar pagos automáticamente?

Sí, es su caso de uso principal: confirmar contra Banxico cada SPEI que tus clientes reportan, sin confiar en capturas de pantalla. Lee la guía Cómo Validar Pagos SPEI con el CEP, o combínala con IA para leer comprobantes en imagen: Validar Comprobantes con Inteligencia Artificial.

¿Los datos son oficiales?

Sí. La consulta se hace directamente al sistema CEP de Banco de México y el XML descargado es el comprobante oficial con validez ante aclaraciones bancarias.

Guías Relacionadas

Cómo Validar Pagos SPEI con el Comprobante Electrónico de Pago

Validar Comprobantes de Pago con Inteligencia Artificial