El problema: confiar en capturas de pantalla
Si tu negocio recibe pagos por transferencia SPEI, probablemente conoces esta situacion: un cliente te envia una captura de pantalla de su comprobante de pago y tu equipo debe verificar manualmente que el deposito realmente llego. En el mejor caso, alguien revisa el estado de cuenta bancario. En el peor, se confia en la captura sin mas.
Esto genera varios problemas reales:
- Las capturas se pueden falsificar. Cualquier persona con conocimientos basicos de edicion puede modificar una imagen de comprobante. No hay forma confiable de distinguir una captura real de una alterada.
- La reconciliacion manual es lenta. Comparar comprobantes contra movimientos bancarios uno por uno consume horas de trabajo, especialmente cuando recibes decenas o cientos de pagos al dia.
- Los errores son costosos. Un pago no verificado puede significar entregar un producto o servicio sin haber recibido el dinero. Un pago duplicado o confundido genera problemas contables que se acumulan.
Este problema afecta particularmente a negocios de ecommerce, plataformas SaaS, empresas de servicios y cualquier operacion que maneje un volumen significativo de transferencias SPEI.
La solucion: el CEP de Banxico
El Comprobante Electronico de Pago (CEP) es el sistema oficial de Banco de Mexico para verificar transferencias SPEI. Cada transferencia que pasa por el sistema SPEI genera un CEP que queda registrado en los servidores de Banxico y puede consultarse en cualquier momento.
El CEP es la unica fuente de verdad para confirmar que una transferencia SPEI realmente ocurrio. No depende del banco emisor ni del banco receptor: es el registro del operador del sistema.
Tlaloc proporciona acceso programatico a este sistema a traves de su API. En lugar de navegar manualmente el sitio web de Banxico, llenar formularios y resolver CAPTCHAs, puedes hacer una llamada HTTP y obtener la respuesta en segundos.
Dos formas de verificar un pago
La API de Tlaloc ofrece dos endpoints para consultar CEPs, cada uno pensado para un caso de uso diferente.
Consulta rapida: GET /v1/cep_query
La consulta rapida te permite verificar si una transferencia existe y conocer su estado con un minimo de datos. Solo necesitas la fecha de operacion, la clave de rastreo (o referencia numerica), y los codigos del banco emisor y receptor.
Es ideal cuando lo que necesitas es una respuesta rapida de tipo "si existe y esta liquidado" o "no se encontro". No requiere conocer la CLABE ni el monto exacto.
Costo: $0.10 MXN por consulta.
Descarga completa: GET /v1/cep
La descarga completa obtiene el documento XML oficial de Banxico con todos los datos de la operacion. Ademas de los datos de la consulta rapida, necesitas la cuenta CLABE del beneficiario (18 digitos) y el monto exacto de la transferencia.
Es la opcion indicada cuando necesitas el comprobante completo para fines contables, legales o de auditoria. La respuesta incluye el XML firmado por Banxico.
Costo: $0.10 MXN por consulta.
Datos que necesitas
Antes de hacer tu primera consulta, reune los siguientes datos. La mayoria los encuentras en el comprobante de pago que te envio el cliente:
| Dato | Ejemplo | Donde encontrarlo |
|---|---|---|
| Fecha de operacion | 2026-04-07 | Comprobante de pago |
| Clave de rastreo | MBAN01042601234567 | Comprobante de pago |
| Banco emisor | BBVA (codigo: 40012) | Comprobante de pago |
| Banco receptor | Nu Mexico (codigo: 90638) | Tu cuenta bancaria |
| CLABE (solo descarga) | 638180000012345678 | Tu cuenta bancaria |
| Monto (solo descarga) | 5000.00 | Comprobante de pago |
La clave de rastreo es el identificador unico de cada transferencia SPEI. Tiene un formato alfanumerico asignado por el banco emisor. Algunos bancos la llaman "numero de seguimiento" o "referencia de rastreo".
Ejemplo: Consulta rapida
Para verificar si una transferencia existe, usa el endpoint /v1/cep_query con los datos basicos:
curl "https://api.tlaloc.sh/mx/v1/cep_query?fecha=2026-04-07&tipo_criterio=T&criterio=MBAN01042601234567&emisor=40012&receptor=90638" \
-H "Authorization: Bearer tlmx_TU_API_KEY"El parametro tipo_criterio=T indica que estas buscando por clave de rastreo. Si prefieres buscar por referencia numerica, usa tipo_criterio=R.
Respuesta:
{
"found": true,
"estado": "Liquidado",
"detalle": {
"beneficiario": "EMPRESA EJEMPLO SA DE CV",
"ordenante": "JUAN PEREZ GARCIA",
"monto": "5000.00",
"fecha_operacion": "07/04/2026"
}
}Si found es true y estado es "Liquidado", la transferencia fue procesada exitosamente por Banxico. Si found es false, la transferencia no existe en los registros de Banxico con los datos proporcionados.
Ejemplo: Descarga completa
Para obtener el comprobante oficial completo, usa el endpoint /v1/cep. Este requiere datos adicionales:
curl "https://api.tlaloc.sh/mx/v1/cep?fecha=2026-04-07&tipo_criterio=T&criterio=MBAN01042601234567&emisor=40012&receptor=90638&cuenta=638180000012345678&monto=5000.00" \
-H "Authorization: Bearer tlmx_TU_API_KEY"Respuesta:
{
"found": true,
"estado": "Liquidado",
"detalle": {
"beneficiario": "EMPRESA EJEMPLO SA DE CV",
"ordenante": "JUAN PEREZ GARCIA",
"cuenta_beneficiario": "638180000012345678",
"cuenta_ordenante": "012180001234567890",
"monto": "5000.00",
"concepto": "PAGO FACTURA 2026-001",
"clave_rastreo": "MBAN01042601234567",
"referencia_numerica": "1234567",
"fecha_operacion": "07/04/2026",
"hora": "14:32:15",
"sello": "..."
},
"xml_content": "<?xml version='1.0'?>..."
}El campo xml_content contiene el documento XML firmado digitalmente por Banxico. Este documento tiene validez oficial y puede usarse como comprobante para fines contables y legales.
Codigos de banco
Para los parametros emisor y receptor necesitas los codigos numericos que Banxico asigna a cada institucion financiera. Puedes consultar el catalogo completo con el endpoint /v1/cep/instituciones:
curl "https://api.tlaloc.sh/mx/v1/cep/instituciones?fecha=2026-04-07" \
-H "Authorization: Bearer tlmx_TU_API_KEY"Este endpoint devuelve la lista de todas las instituciones participantes en SPEI para la fecha indicada, incluyendo su codigo numerico y nombre. Algunos codigos comunes:
| Codigo | Institucion |
|---|---|
| 40002 | BANAMEX |
| 40012 | BBVA MEXICO |
| 40014 | SANTANDER |
| 40021 | HSBC |
| 40072 | BANORTE |
| 90638 | NU MEXICO |
| 90646 | STP |
El catalogo de instituciones puede cambiar con el tiempo a medida que nuevas entidades se incorporan al sistema SPEI. Usa siempre el endpoint para obtener la lista actualizada.
Casos de uso
La validacion programatica de pagos SPEI con CEP tiene aplicaciones directas en varios escenarios de negocio:
- Reconciliacion automatica de pagos. Integra la verificacion CEP en tu sistema de cobros para confirmar automaticamente cada pago recibido contra los registros de Banxico, eliminando la revision manual.
- Prevencion de fraude por comprobantes falsos. En lugar de confiar en capturas de pantalla, valida cada transferencia directamente en la fuente oficial. Si el CEP no existe, el pago no ocurrio.
- Automatizacion de contabilidad. Descarga los CEPs completos con el XML oficial para alimentar directamente tu sistema contable, con la certeza de que cada comprobante es autentico.
- Validacion en sistemas de cobranza. Integra la verificacion en tu flujo de cobranza para liberar pedidos, activar servicios o actualizar saldos automaticamente una vez confirmado el pago.
Siguientes pasos
Ahora que conoces como verificar pagos SPEI de forma programatica, puedes llevar la automatizacion un paso mas alla:
- Automatiza este proceso con IA — Combina un asistente de inteligencia artificial con la API de CEP para validar comprobantes de pago a partir de imagenes, sin escribir codigo.
- Configura el servidor MCP para usar CEP desde ChatGPT o Claude — Conecta tu asistente de IA favorito directamente a los datos oficiales de Banxico en minutos.