Validar un código SWIFT/BIC

Cómo luce en realidad un SWIFT/BIC válido

Un BIC tiene 8 u 11 caracteres, nunca otra cantidad, y cada posición tiene un significado: las primeras cuatro letras identifican la institución, las siguientes dos el código de país ISO, las siguientes dos una ubicación dentro de ese país, y un tramo final opcional de tres caracteres identifica una sucursal específica cuando está presente. Esta api validar codigo swift analiza cada segmento por separado y confirma que se cumplen las reglas de longitud y conjunto de caracteres, atrapando los fallos más comunes: un código en minúsculas copiado de un PDF, un espacio de sobra, un código de 11 caracteres truncado a 9 o un segmento de país que no corresponde a un código ISO real.

Dónde un BIC incorrecto causa fricción real

Las mesas de transferencias internacionales, los sistemas de nómina que pagan a contratistas en el extranjero, las plataformas de facturación que recogen datos bancarios de proveedores y el software de tesorería que concilia registros de contrapartes dependen todos de un BIC con la forma correcta antes de que una instrucción de pago avance. Como los pagos SWIFT pasan por bancos corresponsales, un código mal formado no siempre falla al instante: a veces queda en cola para revisión, sumando días a una transferencia que debía tomar horas. Atrapar el error de formato en la captura de datos evita ese desvío por completo.

Cómo corre la verificación

Envíe POST /verify/swift con el código y recibe un task_id de inmediato, ya que la verificación ocurre de forma asíncrona y nunca bloquea su proceso. La respuesta indica si el formato es válido, los segmentos de institución y país detectados, y si había presente un código de sucursal opcional. Cualquier tarea que falle de plano se reintenta tres veces antes de devolver un error claro, y jamás se cobra una tarea que termina en fallo.

Un formato moldeado por décadas de mensajería interbancaria

El estándar BIC se remonta a la fundación de SWIFT en los años setenta, cuando los bancos necesitaban una forma compacta y sin ambigüedad de dirigirse unos a otros dentro de una red de mensajería compartida, y más adelante se formalizó como ISO 9362. Esa historia explica por qué la estructura es tan rígida: un código de ancho fijo se diseñó para que máquinas lo analizaran de forma confiable mucho antes de que existieran las API, y esa misma rigidez es lo que hoy hace posible y útil validar el formato.

Cómo se integra en flujos de pago

Como los resultados llegan en JSON estructurado por webhook, este endpoint se conecta directo a formularios de alta de proveedores, cargas masivas de nómina y auditorías periódicas de una tabla de contrapartes almacenada: validar en la captura para detener un código malo antes de que llegue a un archivo de pagos, o revisar una base de datos existente durante la noche para marcar registros que merecen una segunda mirada. El acceso requiere saldo prepago, lo que mantiene el endpoint rápido y libre de abuso, y cada verificación tiene un precio fijo publicado de $0.002 sin créditos inventados que rastrear.