Validar cuenta CLABE Banxico: guía para desarrolladores
Si necesitas validar una cuenta CLABE con Banxico de forma programática, probablemente esperas una API oficial del banco central. La realidad es que Banxico no expone un endpoint REST público para validar CLABEs. Sin embargo, sí existe una ruta práctica: aprovechar el sistema SPEI y las APIs de terceros agregadas en plataformas como el API Hub de API Pull. Este artículo te explica cómo integrar la validación de CLABE en tu flujo de onboarding o pagos, combinándola con datos de Banxico para tasas y cumplimiento normativo.
¿Qué es una CLABE y por qué validarla con Banxico?
La CLABE (Clave Bancaria Estandarizada) es el identificador único de 18 dígitos para cuentas bancarias en México. Fue creada por Banxico para estandarizar las transferencias electrónicas, especialmente a través del sistema SPEI.
Estructura de la CLABE de 18 dígitos
| Posición | Dígitos | Significado |
|---|---|---|
| 1-3 | 3 | Código del banco (asignado por Banxico) |
| 4-8 | 5 | Sucursal (código de plaza) |
| 9-17 | 9 | Número de cuenta |
| 18 | 1 | Dígito verificador (algoritmo propio) |
Validar una CLABE implica comprobar que el dígito verificador es correcto, que el banco existe y que la cuenta tiene el formato adecuado. Pero la validación más profunda —confirmar que la cuenta está activa y pertenece a un titular— requiere consultar el sistema SPEI de Banxico, que no ofrece una API pública directa.
El rol de Banxico en el registro de cuentas
Banxico mantiene el registro de las CLABE a través de la asignación de códigos bancarios y la especificación del algoritmo de dígito verificador. Sin embargo, la validación en tiempo real contra la base de datos de Banxico solo es posible mediante transacciones SPEI o a través de servicios de terceros que tienen acceso a la red SPEI.
Métodos oficiales para validar una CLABE
Validación mediante transacciones SPEI
El método más confiable para verificar que una CLABE es válida y está activa es realizar una transferencia SPEI de prueba (por ejemplo, 1 centavo) y esperar la confirmación. Si el banco receptor acepta la orden, la cuenta existe. Banxico es el operador del sistema SPEI, pero no expone una API REST para consultas individuales. Los bancos comerciales y las instituciones financieras pueden conectarse directamente a SPEI, pero para un desarrollador externo es más práctico usar una API de validación CLABE que ya se integre con SPEI.
Portal de Banxico para consulta manual
Banxico ofrece un portal web para consultar CLABE de forma individual (https://www.banxico.org.mx/). No es una solución automatizada, pero puede ser útil para verificar manualmente cuentas durante pruebas o auditorías. Para una integración programática, necesitas una API.
La solución práctica: APIs de validación de CLABE en el API Hub
Dado que Banxico no proporciona una API directa, la alternativa es utilizar proveedores de validación CLABE disponibles en el API Hub de API Pull. Estos proveedores se conectan a la red SPEI u otras fuentes para verificar la existencia y formato de la CLABE.
¿Cómo funciona una API de validación CLABE?
Envías una solicitud HTTP con la CLABE de 18 dígitos y recibes una respuesta JSON que indica:
- Si el formato es válido (dígito verificador correcto).
- El código y nombre del banco emisor.
- Si la cuenta está registrada en el sistema SPEI (activa o no).
- Opcionalmente, el tipo de cuenta (cheques, nómina, etc.).
Proveedores disponibles en API Pull
El API Hub agrega múltiples proveedores de validación de CLABE. Puedes probar diferentes endpoints en el sandbox y elegir el que mejor se adapte a tu volumen y presupuesto. Algunos proveedores incluyen también validación de CURP, RFC y AML screening, lo que te permite consolidar la verificación de identidad en un solo flujo.
Integración conceptual de la validación CLABE en tu flujo
A continuación, describimos los pasos típicos de integración sin inventar endpoints específicos.
Paso 1: Captura de la CLABE
El usuario ingresa su CLABE de 18 dígitos en tu formulario de onboarding o alta de cuenta. Debes validar el formato básico (solo números, 18 dígitos) en el frontend.
Paso 2: Llamada a la API de validación
Tu backend envía una solicitud a la API de validación CLABE (por ejemplo, a través del proveedor que elijas en el API Hub). La respuesta típica incluye:
{
"valid": true,
"bank": {
"code": "002",
"name": "Banamex"
},
"account_type": "checking",
"spei_active": true
}
Paso 3: Manejo de la respuesta y acciones posteriores
Si la validación es exitosa, puedes continuar con el proceso de alta. Si falla, muestra un mensaje de error al usuario. Puedes configurar webhooks para recibir notificaciones asíncronas cuando la validación tome más tiempo (por ejemplo, consultas batch).
Consideraciones de seguridad
- Siempre valida la CLABE en el servidor, no confíes solo en la validación del frontend.
- Almacena los resultados de la validación con un hash para auditoría (cumplimiento AML).
- Usa HTTPS y autenticación por API key.
Complementa con la API Banxico de API Pull para tasas y cumplimiento
Una vez que tienes la CLABE validada, es común que necesites datos financieros de Banxico para completar la operación. La API Banxico de API Pull te permite obtener:
- Tipo de cambio USD/MXN actualizado.
- Tasa TIIE (28 días, 91 días, etc.).
- UDI (Unidades de Inversión).
Casos de uso combinados
Imagina que estás procesando un pago internacional: validas la CLABE del beneficiario, luego consultas el tipo de cambio USD/MXN para calcular el monto exacto en pesos que debes enviar. Todo en una sola integración.
Para cumplimiento normativo, puedes complementar con la AML API Mexico para verificar listas de sanciones (SAT 69-B, OFAC, PEP) y asegurar que la cuenta no esté vinculada a actividades ilícitas.
Cuándo la validación de CLABE no es suficiente
Verificación de titularidad de la cuenta
La validación de CLABE confirma que el número de cuenta existe y es válido, pero no verifica que el titular sea quien dice ser. Para eso necesitas métodos adicionales como:
- Validación de CURP contra RENAPO (por ejemplo, con la CURP API).
- Transferencia SPEI de ida y vuelta (cobro de microdepósito).
- Consulta de titularidad mediante convenio con el banco (solo para instituciones reguladas).
Transferencias internacionales y cuentas en el extranjero
Para cuentas fuera de México, la CLABE no aplica. En su lugar se usa el IBAN (para Europa) o el routing number (para EE.UU.). Cada país tiene su propio sistema de validación.
Para operaciones de AML, combina la validación CLABE con el AML API Mexico y la CURP Compliance API.
Próximos pasos para tu implementación
- Explora el API Hub de API Pull para encontrar proveedores de validación CLABE que se ajusten a tu caso de uso.
- Registra una cuenta gratuita para probar la API Banxico y obtener tasas oficiales.
- Si necesitas asesoría, contacta al equipo de soporte de API Pull para una integración asistida.
