Cómo rastrear Banxico: clave de rastreo SPEI e integración técnica para desarrolladores
En este artículo te explicamos cómo rastrear Banxico utilizando la clave de rastreo SPEI y cómo integrar esa funcionalidad en tu sistema de pagos. El rastreo Banxico consiste en consultar el estado de una transferencia electrónica (SPEI) a través de un identificador único llamado clave de rastreo, que permite saber si el pago fue recibido, está en proceso o fue rechazado. Aunque Banxico opera el sistema SPEI, la consulta en tiempo real se realiza mediante las APIs de los bancos participantes, no directamente desde el banco central. Esta guía combina la explicación del concepto con pasos de integración técnica, y te muestra cómo complementar el rastreo con datos de tipo de cambio oficial usando la API de Banxico de API Pull.
¿Qué es el rastreo Banxico y cómo funciona?
El rastreo Banxico se refiere al proceso de seguir el estado de una transferencia SPEI (Sistema de Pagos Electrónicos Interbancarios) en México. Cada transferencia genera un identificador único llamado clave de rastreo, que el banco emisor entrega al remitente en el comprobante electrónico de pago (CEP). Con esa clave, tanto el remitente como el destinatario pueden consultar en su banca en línea o mediante APIs si el dinero ya está disponible, si está en tránsito o si hubo algún problema.
Importante: Banxico no expone una API pública de rastreo. El acceso al estado de las transferencias se realiza a través de los propios bancos o de proveedores de servicios de pago que se conectan al SPEI. Para integraciones técnicas, necesitas acordar con cada banco el uso de su API de consulta, que normalmente recibe la clave de rastreo y devuelve el estado, la fecha de liquidación y el monto exacto.
La clave de rastreo: el identificador único de cada transferencia SPEI
La clave de rastreo es un código alfanumérico de aproximadamente 30 caracteres que identifica de forma unívoca una transferencia SPEI dentro del sistema de Banxico. Se genera automáticamente cuando el banco emisor envía la instrucción de pago y aparece en el comprobante electrónico de pago (CEP) que puedes descargar desde la banca en línea.
¿Dónde encontrar la clave de rastreo?
- Remitente: en el comprobante de la transferencia (PDF o pantalla de confirmación).
- Destinatario: en el estado de cuenta o en la notificación de ingreso (si el banco receptor la expone).
- Conciliación: en los archivos de liquidación que algunos bancos comparten vía API o SFTP.
A continuación, una tabla con los estados típicos que puedes consultar:
| Estado | Descripción | Clave de rastreo visible |
|---|---|---|
| Enviado | La transferencia fue enviada por el banco emisor a Banxico | Sí, en el comprobante del emisor |
| Recibido | El banco receptor confirmó la recepción y el abono a la cuenta | Sí, en el estado de cuenta del receptor |
| Rechazado | El banco receptor devolvió la transferencia (por ejemplo, cuenta incorrecta) | Sí, con motivo de rechazo |
Cómo integrar el rastreo de transferencias en tu sistema
Para integrar el rastreo de transferencias SPEI en tu aplicación, necesitas dos componentes principales:
- API de consulta de estado de transferencia: provista por el banco con el que trabajas (o un agregador de pagos). Le envías la clave de rastreo y recibes el estado, la fecha de liquidación y el monto.
- API de tipo de cambio oficial: para conciliar montos cuando la transferencia está en dólares o necesitas el valor en pesos al momento del pago. Aquí entra la API de Banxico de API Pull, que te entrega el tipo de cambio USD/MXN, TIIE y UDI de forma confiable.
Flujo de integración conceptual
- El usuario realiza una transferencia SPEI desde su banco.
- Tu sistema captura la clave de rastreo (mediante webhook o formulario).
- Consultas el estado de la transferencia contra la API del banco emisor o receptor.
- Si el monto está en otra moneda, obtienes el tipo de cambio de la fecha correspondiente usando la API de Banxico.
- Con los datos, actualizas el estado de la orden en tu base de datos y generas un reporte de conciliación.
Nota: API Pull no proporciona un servicio de rastreo de transferencias, solo la capa de datos financieros (tipos de cambio, tasas, indicadores). Para el rastreo, deberás conectar con las APIs de los bancos o con servicios como CEP (Consulta de Estado de Pagos).
Casos de uso: conciliación de pagos, cumplimiento AML y más
Conciliación automática de pagos en fintechs
Las fintechs que procesan pagos recurrentes (créditos, suscripciones) necesitan conciliar cada transferencia SPEI. Con la clave de rastreo y el monto, pueden verificar automáticamente si el pago fue recibido y en qué fecha, y luego cruzar con el tipo de cambio del día usando la API de indicadores económicos.
Cumplimiento AML con el rastreo de transferencias
Para cumplir con las regulaciones de la CNBV, las instituciones financieras deben rastrear el origen de los fondos. La clave de rastreo permite auditar cada transferencia SPEI, enlazándola con el comprobante electrónico de pago. Esto es parte de los procesos de AML (Anti-Money Laundering) y puede complementarse con herramientas como la AML API Mexico para verificar listas negras y PEPs.
Verificación de pagos en seguros y microcréditos
Las aseguradoras y otorgantes de microcréditos suelen recibir pagos de pólizas o cuotas mediante SPEI. Con la clave de rastreo pueden confirmar el abono en minutos, reduciendo el tiempo de espera para activar la cobertura o desembolsar el siguiente crédito.
Cuándo el rastreo Banxico no es la herramienta adecuada
El rastreo mediante clave de rastreo es ideal para seguimiento de transferencias, pero no es la mejor opción en estos casos:
- Necesitas tipos de cambio en tiempo real para cotizar: para eso necesitas una API de tipo de cambio, no un rastreo de transferencia. Consulta la API de Banxico de API Pull.
- Requieres datos demográficos o de identidad del beneficiario: el rastreo no te da información sobre la persona. Aquí necesitas una API de CURP o de RFC.
- Quieres verificar el origen de los fondos con datos biométricos: el rastreo solo confirma si el pago llegó; para AML avanzado se requiere un proceso de identificación del cliente (KYC) y consultas a listas oficiales.
Siguiente paso: automatiza la obtención de tipos de cambio con la API de Banxico de API Pull
Si ya integraste el rastreo de transferencias, el siguiente paso lógico es automatizar la consulta de tipos de cambio y tasas oficiales para conciliar montos en diferentes monedas o calcular intereses. La API de Banxico de API Pull te ofrece:
- Datos en tiempo real del tipo de cambio USD/MXN, TIIE y UDI.
- Sandbox con casos de prueba sintéticos para desarrollo.
- Webhooks para recibir notificaciones cuando se publiquen nuevos valores.
- Auditoría con respuestas firmadas para cumplimiento regulatorio.
Puedes empezar hoy mismo en apipull.com/docs sin necesidad de contratos complejos. La API está diseñada para equipos de ingeniería que necesitan datos confiables del banco central de México sin lidiar con la complejidad del SIE de Banxico.
Referencias externas: