Lista de bancos

Cada institución que participa en SPEI tiene un código de banco de cinco dígitos asignado por Banxico. Busca por nombre, por código o por cualquiera de los alias.

La lista es el mismo catálogo contra el que valida el servidor: se pide a GET /v1/public/banks cada vez que se genera esta página, así que no puede quedarse vieja. Se actualiza semanalmente desde las listas oficiales de Banxico.

Cuándo hace falta

• Al registrar un beneficiario de tipo celular (DiMo): el número por sí solo no identifica a la institución, así que bank_code es obligatorio en el cuerpo. Para una CLABE o una tarjeta se deriva del prefijo o del BIN, y lo que envíes se ignora. Ver Crear, actualizar y exportar beneficiarios.
• Al validar una transferencia: los campos emisor y receptor aceptan el código o el nombre del banco. "emisor": "40012" y "emisor": "BBVA MEXICO" son equivalentes. Ver Validar una transferencia SPEI.
• Al leer una respuesta: bank_code y bank_name vienen resueltos por el servidor, así que normalmente no necesitas buscarlos aquí — esta lista sirve para el camino contrario, cuando eres tú quien tiene que enviarlos.

Los alias

Muchas instituciones aparecen con más de un nombre en los comprobantes. El catálogo guarda esos alias y el servidor los resuelve al mismo código: bancomer y BBVA MEXICO llegan los dos a 40012. Por eso la búsqueda de arriba también mira los alias — si tienes un nombre sacado de un comprobante y no sabes qué código le toca, escríbelo tal cual.

Obtenerlo por API

La misma lista se sirve en GET /v1/public/banks, sin autenticación. Responde con ETag, así que puedes cachearla y revalidarla con If-None-Match en lugar de descargarla entera cada vez.

Si lo que tienes es un comprobante

Un código de banco identifica a la institución; no dice si el pago existió. El comprobante oficial que emite Banxico por cada transferencia SPEI sí lo acredita: qué es, dónde se descarga y qué prueba está en la guía del CEP de Banxico.

Si lo que necesitas es revisar el comprobante que te mandaron antes de entregar un pedido, la página para negocios explica ese caso. Las demás guías y el glosario de términos viven en Recursos.