Gerador e Validador de CLABE Mexicana | Ferramenta de Teste Gratuita

Gerador de CLABE Mexicano para Testes

Introdução

A CLABE mexicana (Clave Bancaria Estandarizada ou Código Bancário Padronizado) é um código numérico de 18 dígitos usado em todo o sistema bancário mexicano para padronizar transferências eletrônicas de fundos. Ao construir sistemas de pagamento ou aplicações financeiras que interagem com bancos mexicanos, você rapidamente descobrirá que ter números de CLABE válidos para teste é absolutamente crítico.

Aqui está o que torna esta ferramenta valiosa: ela gera CLABEs estruturalmente válidas que seguem o formato exato e as regras de validação estabelecidas pela Associação Bancária Mexicana (ABM). Cada número gerado inclui um dígito de verificação calculado corretamente que passa por algoritmos de verificação padrão. Seja você precisando de uma única CLABE para um teste de unidade rápido ou 100 números diferentes para testes de integração abrangentes, você obterá códigos formatados corretamente que se comportam como CLABEs reais em seu ambiente de teste.

Entendendo os Números CLABE

O que é CLABE?

CLABE (Clave Bancaria Estandarizada) é o código bancário padronizado do México usado para todas as transferências eletrônicas de fundos dentro do sistema bancário mexicano. Introduzido em 2004 junto com o sistema de pagamento em tempo real SPEI (Sistema de Pagos Electrónicos Interbancarios), os CLABEs resolveram um grande problema: antes de sua implementação, cada banco usava formatos diferentes de números de conta, tornando as transferências interbancárias propensas a erros e lentas. Agora, cada conta bancária mexicana possui um CLABE único de 18 dígitos que funciona consistentemente em todas as instituições.

Estrutura do CLABE

Cada CLABE consiste exatamente em 18 dígitos, divididos em quatro componentes principais:

1. Código do Banco (dígitos 1-3): Identifica o banco específico no México
2. Código da Agência (dígitos 4-6): Identifica a agência específica do banco
3. Número da Conta (dígitos 7-17): O identificador de conta único (11 dígitos)
4. Dígito Verificador (dígito 18): Um dígito de verificação calculado usando um algoritmo específico

Exemplo: 012 345 01234567890 1

Por exemplo, no número CLABE 012345678901234567:

• 012 é o código do banco (BBVA Bancomer)
• 345 é o código da agência
• 67890123456 é o número da conta
• 7 é o dígito verificador

Como os Números CLABE São Gerados

Códigos de Bancos

Os três primeiros dígitos de uma CLABE representam o código do banco, que identifica a instituição financeira específica no México. Esses códigos são padronizados e atribuídos pela Associação Bancária Mexicana (ABM). Nosso gerador inclui todos os códigos de bancos oficiais do sistema financeiro mexicano, incluindo bancos principais como:

• 002 - BANAMEX
• 012 - BBVA BANCOMER
• 014 - SANTANDER
• 021 - HSBC
• 072 - BANORTE

Códigos de Agências

Os próximos três dígitos (posições 4-6) representam o código da agência. Embora os códigos de agência reais correspondam a locais físicos específicos dos bancos, para fins de teste, nosso gerador cria códigos de agência aleatórios, mas em formato válido.

Números de Conta

As posições 7-17 contêm o número de conta de 11 dígitos. Em sistemas de produção, esses números são exclusivos para cada conta bancária. Nosso gerador cria números de conta aleatórios que seguem o formato adequado, mas não estão vinculados a contas reais.

Cálculo do Dígito Verificador

O 18º dígito é um dígito verificador calculado usando um algoritmo de módulo 10 ponderado. Esse mecanismo de verificação detecta erros comuns de digitação, como dígitos trocados ou erros de digitação.

Veja como funciona:

1. Cada um dos primeiros 17 dígitos é multiplicado por um valor de peso correspondente
2. Os pesos seguem o padrão: 3, 7, 1, 3, 7, 1, ... (repetindo em todas as posições)
3. Apenas o último dígito de cada resultado de multiplicação é usado
4. Esses dígitos são somados
5. O dígito verificador é calculado como (10 - (soma mod 10)) mod 10

O interessante deste algoritmo é que fornece forte detecção de erros. Se alguém acidentalmente trocar dois dígitos ou digitar incorretamente um único dígito, a validação do dígito verificador falhará, impedindo transferências incorretas. É por isso que as APIs bancárias rejeitarão CLABEs com dígitos verificadores inválidos antes mesmo de tentar processar uma transação.

1function calculateCheckDigit(clabe17) {
2  // Pesos para cada posição
3  const weights = [3, 7, 1, 3, 7, 1, 3, 7, 1, 3, 7, 1, 3, 7, 1, 3, 7];
4  
5  // Calcular a soma ponderada
6  let sum = 0;
7  for (let i = 0; i < 17; i++) {
8    const digit = parseInt(clabe17[i], 10);
9    const product = digit * weights[i];
10    sum += product % 10; // Apenas o último dígito do produto é usado
11  }
12  
13  // Calcular o dígito verificador
14  const mod = sum % 10;
15  const checkDigit = (10 - mod) % 10; // Se mod for 0, o dígito verificador é 0
16  
17  return checkDigit;
18}
19

Usando a Ferramenta de Geração de CLABE

A ferramenta oferece três funções principais projetadas para fluxos de trabalho comuns de teste:

1. Gerar uma CLABE Única

Perfeito para testes unitários rápidos ou quando você precisa inspecionar manualmente um caso específico. Você pode:

• Selecionar um banco específico (útil ao testar lógica específica de banco) ou deixar a ferramenta escolher aleatoriamente um
• Copiar a CLABE gerada para a área de transferência com um único clique
• Visualizar um detalhamento mostrando código do banco, código da agência, número da conta e dígito verificador

Quando usar isso: Sessões de depuração rápida, testes manuais de API com ferramentas como Postman ou cURL, ou ao demonstrar a estrutura da CLABE para membros da equipe.

2. Gerar Múltiplas CLABEs

Essencial para cenários de teste abrangentes. Você pode:

• Especificar a quantidade (até 100 CLABEs de uma vez)
• Opcionalmente bloquear todas as CLABEs para um banco específico, ou misturar bancos aleatoriamente
• Copiar CLABEs individuais ou capturar todo o conjunto como uma lista separada por vírgulas
• Cada CLABE é garantida como única dentro do lote

Quando usar isso: Alimentar bancos de dados de teste, testar APIs de pagamento sob carga, criar conjuntos de dados de teste diversos para automação de QA, ou configurar cenários de teste multiusuário complexos.

3. Verificar uma CLABE

Valida números de CLABE existentes em relação às regras oficiais de formato:

• Insira qualquer CLABE de 18 dígitos que deseje verificar
• A ferramenta realiza três verificações: validação de formato (18 dígitos), verificação de código de banco (registro oficial da ABM), e validação de dígito verificador (algoritmo de módulo 10 ponderado)
• CLABEs válidas exibem um detalhamento completo dos componentes
• CLABEs inválidas mostram mensagens de erro específicas explicando o que falhou

Quando usar isso: Depurar por que uma API bancária rejeitou uma CLABE, validar CLABEs recebidas de fontes externas, ensinar membros da equipe sobre validação de CLABE, ou verificar se sua própria lógica de geração produz dígitos verificadores corretos.

Processo de Verificação de CLABE

Ao verificar uma CLABE, nossa ferramenta realiza várias verificações:

1. Verificação de Formato: Garante que a entrada consista em exatamente 18 dígitos
2. Validação do Código do Banco: Verifica se os primeiros três dígitos correspondem a um banco mexicano real
3. Validação do Dígito de Verificação: Recalcula o dígito de verificação e o compara com o fornecido

1def validate_clabe(clabe):
2    # Verifica se a CLABE tem 18 dígitos
3    if not re.match(r'^\d{18}$', clabe):
4        return {"isValid": False, "errors": ["CLABE deve ter exatamente 18 dígitos"]}
5    
6    # Extrai componentes
7    bank_code = clabe[0:3]
8    branch_code = clabe[3:6]
9    account_number = clabe[6:17]
10    provided_check_digit = clabe[17]
11    
12    # Valida código do banco
13    if bank_code not in MEXICAN_BANKS:
14        return {"isValid": False, "errors": ["Código de banco inválido"]}
15    
16    # Valida dígito de verificação
17    calculated_check_digit = calculate_check_digit(clabe[0:17])
18    if int(provided_check_digit) != calculated_check_digit:
19        return {"isValid": False, "errors": ["Dígito de verificação inválido"]}
20    
21    # Se todas as verificações passarem
22    return {
23        "isValid": True,
24        "bankCode": bank_code,
25        "bankName": MEXICAN_BANKS[bank_code],
26        "branchCode": branch_code,
27        "accountNumber": account_number,
28        "checkDigit": provided_check_digit
29    }
30

Casos Práticos de Uso do Gerador de CLABE

Desenvolvimento de Software e Testes

Integração de Sistemas de Pagamento: Quando você está integrando com gateways de pagamento mexicanos como Conekta, OpenPay ou APIs bancárias diretas, você precisará de CLABEs válidas para testar sem afetar sistemas de produção. Um cenário comum: você está construindo um recurso de pagamento que transfere dinheiro para contas bancárias mexicanas. Usar CLABEs geradas no seu ambiente de staging permite verificar se suas chamadas de API estão formatadas corretamente, sua lógica de validação funciona e seu tratamento de erros captura casos extremos - tudo sem arriscar transferências de dinheiro reais.

Teste de Validação de Formulário: Construindo um formulário web que aceita CLABEs? Gere um lote de números válidos para testar sua validação de frontend. Então, corrompa-os intencionalmente (altere um dígito, modifique o comprimento) para verificar se suas mensagens de erro são exibidas corretamente. Uma dica profissional: teste com CLABEs de diferentes bancos para garantir que sua validação não favoreça acidentalmente o formato de um banco específico.

Preenchimento de Banco de Dados: Ao popular bancos de dados de teste com dados realistas de clientes mexicanos, CLABEs geradas aleatoriamente tornam seus dados de teste autênticos. Isso é especialmente útil para ambientes de demonstração onde os clientes precisam ver dados representativos. Apenas lembre-se de marcar claramente esses ambientes como de teste para evitar confusão.

Teste de Carga: Precisa estressar um sistema de processamento de pagamentos? Gere 100 CLABEs únicas e simule transações simultâneas. Isso ajuda a identificar condições de corrida ou problemas de bloqueio de banco de dados que podem não surgir com uma única conta de teste.

Teste de Aplicações Financeiras

Sistemas de Pagamento Transfronteiriços: Se você está construindo plataformas de remessa ou serviços de pagamento internacional que transferem para o México, encontrará validação de CLABE em múltiplos estágios: validação no lado do cliente, verificações no lado do servidor e, finalmente, no nível da API bancária. Ter um conjunto de CLABEs de teste válidas garante que sua aplicação lida corretamente com todo o fluxo antes de entrar em operação.

Cenários de Tratamento de Erros: Aqui está um erro que vi repetidamente: desenvolvedores só testam o "caminho feliz" com CLABEs válidas. O que acontece quando um usuário insere 17 dígitos? Ou 19? Ou inclui traços ou espaços? Use esta ferramenta para gerar CLABEs válidas e, então, crie variações inválidas para testar completamente seu tratamento de erros. Seus usuários agradecerão quando seu aplicativo fornecer mensagens de erro claras e úteis em vez de falhas genéricas.

Teste de Conformidade e Auditoria: Aplicações financeiras frequentemente precisam de trilhas de auditoria mostrando validação de transação. CLABEs geradas permitem criar logs de teste abrangentes que demonstram que sua lógica de validação atende aos requisitos de conformidade sem expor dados reais de clientes.

Propósitos Educacionais e de Treinamento

Aprendendo Padrões Bancários Mexicanos: Entender a estrutura da CLABE é essencial para qualquer pessoa que trabalhe com sistemas financeiros mexicanos. Use esta ferramenta para gerar exemplos, dissecar seus componentes e entender como o algoritmo de dígito de verificação funciona na prática.

Programas de Treinamento em Fintech: Ao treinar novos desenvolvedores em sistemas de pagamento mexicanos, ter CLABEs válidas imediatamente disponíveis torna os workshops mais eficazes. Os participantes podem se concentrar em entender a lógica de negócios em vez de lutar para encontrar dados de teste.

Limitações e Considerações Importantes

Nosso gerador de CLABE cria números tecnicamente válidos que passam em verificações padrão, mas existem limites importantes a entender:

Não Conectado a Contas Reais: Isso é crucial—CLABEs geradas são estruturalmente válidas, mas não estão vinculadas a contas bancárias reais. Pense nelas como endereços corretamente formatados para casas que não existem. Elas passarão na validação de formato, mas você não pode enviar dinheiro para elas. APIs bancárias rejeitarão esses números durante o processamento real de transações quando consultarem o banco de dados de contas.

Apenas Ambientes de Teste: Use essas CLABEs exclusivamente em ambientes de desenvolvimento, staging e QA. Nunca insira CLABEs de teste geradas em código de produção ou arquivos de configuração. Um erro comum é deixar CLABEs de teste em configurações de produção, o que pode causar falhas silenciosas quando o sistema tentar fazer transferências reais.

Moeda do Código Bancário: A Associação Bancária Mexicana ocasionalmente atualiza códigos bancários oficiais à medida que instituições se fundem, mudam de marca ou recebem novas licenças. Atualizamos nossa lista de códigos bancários regularmente, mas pode haver um curto atraso. Se você estiver trabalhando em um projeto com prazo em um banco mexicano específico, verifique o código bancário na documentação oficial de CLABE do Banco do México.

Limites de Teste de Segurança: CLABEs geradas funcionam para testes funcionais, mas não devem substituir testes de segurança adequados. Por exemplo, testar proteção contra injeção de SQL requer dados de teste diferentes de CLABEs com formato válido. Além disso, tenha cuidado ao registrar CLABEs geradas—embora sejam falsas, um rótulo claro evita confusão durante auditorias de segurança.

Variações Regionais: O sistema bancário mexicano tem regras específicas que diferem de outros países latino-americanos. Não assuma que a lógica de validação de CLABE funcionará para chaves PIX brasileiras, números CBU argentinos ou outros identificadores de pagamento regionais. Cada país tem padrões distintos.

Alternativas à CLABE

Embora a CLABE seja o padrão para transferências interbancárias no México, outros sistemas de identificação existem no mundo financeiro:

1. IBAN (Número Internacional de Conta Bancária): Usado principalmente na Europa e em alguns outros países, mas não no México.

2. Códigos SWIFT/BIC: Usados para transferências internacionais, frequentemente em conjunto com a CLABE para transferências para o México.

3. Números de Roteamento ABA: Usados no sistema bancário dos Estados Unidos.

4. Números de Conta: Números simples de conta bancária sem o formato padronizado da CLABE.

Para testar sistemas financeiros mexicanos especificamente, a CLABE é o padrão necessário.

História da CLABE no México

O sistema CLABE foi introduzido no México em 2004 pela Associação Bancária Mexicana (Asociación de Bancos de México, ABM) para padronizar as transferências eletrônicas de fundos entre bancos mexicanos. Antes da CLABE, cada banco tinha seu próprio sistema de numeração de contas, tornando as transferências interbancárias complicadas e propensas a erros.

A implementação da CLABE coincidiu com o desenvolvimento do Sistema de Pagamentos Eletrônicos Interbancários (Sistema de Pagos Electrónicos Interbancarios, SPEI), o sistema de liquidação bruta em tempo real do México, operado pelo banco central, Banco do México.

Desde sua introdução, a CLABE tornou-se obrigatória para todas as transferências eletrônicas interbancárias no México, melhorando significativamente a eficiência e a confiabilidade do sistema bancário mexicano.

Melhores Práticas para Testes com CLABEs

Criar uma Biblioteca de Dados de Teste: Em vez de gerar CLABEs no momento do teste, mantenha um conjunto de CLABEs de teste conhecidas e válidas em seus fixtures de teste. Isso torna os testes reproduzíveis e mais fáceis de depurar. Quando um teste falha, você pode examinar a CLABE exata que causou o problema.

Testar com Múltiplos Bancos: Não teste exclusivamente com CLABEs de um único banco. Diferentes bancos podem ter peculiaridades de validação distintas em suas APIs. Gere CLABEs de pelo menos 3-4 bancos mexicanos importantes (como BBVA Bancomer, Banamex, Santander e Banorte) para garantir que sua integração lide com todos os casos.

Documentar Fontes de CLABEs de Teste: Ao compartilhar ambientes de teste com membros da equipe, documente claramente quais CLABEs são geradas para teste e quais (se houver) vêm de APIs bancárias sandbox. Isso previne confusões durante testes de integração e evita tratar credenciais sandbox como dados de produção.

Implementar Respostas de Mock Adequadas: Ao testar a validação de CLABE em sua aplicação, faça mock não apenas de validações bem-sucedidas, mas também de respostas de erro realistas: dígitos de verificação inválidos, códigos de banco desconhecidos e entradas mal formatadas. APIs bancárias reais retornam códigos de erro específicos para cada tipo de falha.

Controle de Versão para Dados de Teste: Se você estiver usando um conjunto específico de CLABEs para testes de regressão, faça commit delas no controle de versão. Isso garante que todos os desenvolvedores e pipelines de CI/CD usem dados de teste idênticos, tornando as falhas de build reproduzíveis.

Erros Comuns a Evitar

Ao trabalhar com números CLABE em seus aplicativos, fique atento a estes erros frequentes:

Aceitando CLABEs com Caracteres de Formatação: Os usuários geralmente inserem CLABEs com espaços ou traços (por exemplo, "012-345-67890123456-7" ou "012 345 67890123456 7"). Sua validação deve remover esses caracteres antes da validação, não rejeitá-los sumariamente. Aplicativos bancários mexicanos reais geralmente permitem entrada formatada para melhor legibilidade.

Ignorando Mudanças no Código Bancário: Bancos se fundem, mudam de marca ou são adquiridos. Por exemplo, quando o Scotiabank adquiriu o Grupo Financiero ING no México, os códigos bancários mudaram. Se seu aplicativo armazena códigos bancários em cache, implemente um mecanismo de atualização ou você rejeitará CLABEs recentemente válidas.

Teste Insuficiente do Dígito de Verificação: O algoritmo do dígito de verificação é específico e não negociável. Teste casos de borda como CLABEs onde o dígito de verificação calculado é 0 (o algoritmo retorna 0, não 10). Verifique também se sua implementação lida corretamente com a operação de módulo 10 quando a soma é exatamente divisível por 10.

Assumindo que Todos os Números de 18 Dígitos São CLABEs: Nem todo número de 18 dígitos é uma CLABE válida. Sempre valide o código bancário no registro oficial e verifique o dígito de verificação. Um número aleatório de 18 dígitos tem menos de 0,1% de chance de passar na validação adequada de CLABE.

Hardcoding de Nomes de Bancos: Os códigos bancários são estáveis, mas os nomes dos bancos mudam devido a rebranding. Armazene os códigos bancários em seu banco de dados, mas busque os nomes atuais dos bancos em uma referência ou API atualizada ao exibir para os usuários.

Registrando CLABEs Completas em Produção: Mesmo que CLABEs de teste não sejam reais, estabelecer boas práticas é importante. Em sistemas de produção, registre apenas CLABEs parciais (por exemplo, primeiros 6 e últimos 2 dígitos) para manter os padrões de privacidade e cumprir as regulamentações de proteção de dados financeiros.

Perguntas Frequentes

Para que serve um número CLABE?

Um número CLABE é usado para identificar contas bancárias no sistema bancário mexicano para transferências eletrônicas de fundos. Ele garante que o dinheiro seja enviado para a conta correta no banco e agência corretos.

Como posso identificar a qual banco uma CLABE pertence?

Os primeiros três dígitos de um número CLABE identificam o banco. Por exemplo, 012 indica BBVA Bancomer, 072 indica Banorte e 002 indica Banamex.

As CLABEs geradas estão conectadas a contas reais?

Não. As CLABEs criadas por esta ferramenta são estruturalmente válidas, mas não estão conectadas a nenhuma conta bancária real. Elas devem ser usadas apenas para fins de teste.

Como sei se uma CLABE é válida?

Uma CLABE válida passa por três verificações essenciais:

1. Validação de comprimento: Exatamente 18 dígitos (nem mais, nem menos)
2. Verificação do código do banco: Os primeiros 3 dígitos devem corresponder a um código de banco mexicano oficial registrado na ABM
3. Validação do dígito de verificação: O 18º dígito deve corresponder ao valor calculado usando o algoritmo de módulo 10 ponderado

Nossa ferramenta de verificação verifica todos os três critérios. Tenha em mente que isso valida a estrutura e o formato — não confirma a existência da conta no banco.

Posso usar essas CLABEs geradas para transações reais?

Não. Estas são CLABEs de teste apenas e nunca devem ser usadas para transações financeiras reais. Elas não serão direcionadas para contas reais.

Com que frequência os códigos de banco são atualizados?

Sincronizamos nosso banco de dados de códigos de banco com o registro oficial da Associação Bancária Mexicana (ABM) trimestralmente, embora mudanças importantes (novos bancos, fusões, aquisições) sejam refletidas em poucos dias. Mudanças de código de banco são relativamente infrequentes — o México tem aproximadamente o mesmo conjunto de instituições principais há vários anos. Se você estiver integrando com um banco mexicano específico e precisar das informações mais recentes sobre código de banco, faça uma verificação cruzada com a documentação oficial de CLABE do Banco do México.

Por que meu aplicativo bancário rejeita uma CLABE que sua ferramenta diz ser válida?

Nossa ferramenta verifica a validade estrutural — comprimento correto, código de banco válido, cálculo correto do dígito de verificação. No entanto, os aplicativos bancários realizam verificações adicionais: verificam se a conta existe em seu banco de dados, confirmam se a conta está ativa (não bloqueada ou fechada) e verificam permissões. Uma CLABE estruturalmente perfeita falhará nessas verificações do mundo real porque não está conectada a uma conta real. Esse comportamento é esperado e exatamente por isso essas são CLABEs apenas para teste.

Posso gerar CLABEs para um banco específico?

Sim, nossa ferramenta permite selecionar um banco específico ao gerar CLABEs, garantindo que a parte do código do banco corresponda à instituição selecionada.

Como o dígito de verificação é calculado?

O dígito de verificação usa um algoritmo de módulo 10 ponderado definido no padrão CLABE oficial. Cada um dos primeiros 17 dígitos é multiplicado por um padrão de peso repetitivo (3, 7, 1, 3, 7, 1, ...), mantendo apenas o último dígito de cada produto. Esses dígitos são somados, e o dígito de verificação é calculado como (10 - (soma mod 10)) mod 10. Este algoritmo fornece forte detecção de erros — captura todos os erros de dígito único e a maioria dos erros de transposição, que são os erros de entrada de dados mais comuns.

Há um limite para quantas CLABEs posso gerar de uma vez?

A ferramenta gera até 100 CLABEs por lote, o que atende à maioria dos cenários de teste. Se você precisar de milhares de CLABEs para testes de carga em larga escala, basta executar o gerador várias vezes ou integrar o algoritmo de dígito de verificação em suas fábricas de dados de teste. O algoritmo é simples o suficiente para ser implementado diretamente na sua estrutura de teste.

Referências

1. Banco do México. "CLABE - Chave Bancária Padronizada." https://www.banxico.org.mx/servicios/clabe-estandarizada.html

2. Associação de Bancos do México (ABM). "Catálogo de Chaves de Instituições de Crédito." https://www.abm.org.mx/

3. Sistema de Pagamentos Eletrônicos Interbancários (SPEI). "Regras de Operação." https://www.banxico.org.mx/sistemas-de-pago/servicios/sistema-de-pagos-electronicos-interbancarios-spei/

4. Comissão Nacional Bancária e de Valores (CNBV). "Disposições de caráter geral aplicáveis às instituições de crédito." https://www.gob.mx/cnbv

---

Pronto para testar sua integração de pagamento mexicana? Use este gerador de CLABE para criar dados de teste válidos que correspondam exatamente ao formato e às regras de validação usadas por bancos mexicanos reais. Gere CLABEs individuais para testes rápidos, crie em lote até 100 para cenários de teste abrangentes ou verifique CLABEs existentes para entender por que podem estar falhando na validação.

Para sistemas de produção, lembre-se de substituir todos os CLABEs de teste por números de conta reais fornecidos por seus parceiros bancários mexicanos ou obtidos por meio de ambientes sandbox oficiais. Esses números gerados são especificamente projetados para ambientes de desenvolvimento e QA, onde você precisa de dados de teste realistas sem se conectar a contas bancárias reais.