Gerador e Validador de CBU para Argentina | Códigos Bancários do BCRA

O que é um CBU argentino e por que validá-lo?

Trabalhar com o sistema bancário da Argentina significa lidar com o CBU (Clave Bancaria Uniforme) — um código de 22 dígitos que identifica exclusivamente cada conta bancária do país. Se você já precisou testar uma integração de pagamento, verificar detalhes bancários antes de uma transferência ou entender por que uma transação falhou, sabe o quanto é crítico trabalhar com CBUs formatados corretamente.

Esta ferramenta ajuda você a gerar CBUs estruturalmente válidos para ambientes de teste e validar códigos existentes em relação ao formato oficial especificado pelo Banco Central da Argentina (BCRA). Ao construir aplicações financeiras ou processar pagamentos, identificar erros de formato antecipadamente economiza horas de depuração e previne transações com falha.

Entendendo o Formato CBU

O CBU (Clave Bancaria Uniforme) é a resposta da Argentina aos identificadores bancários internacionais como IBAN ou números de roteamento dos EUA. Pense nele como um pacote abrangente que agrupa as informações do banco, agência e conta em um único código de 22 dígitos. O Banco Central da Argentina (BCRA) implementou esse sistema em novembro de 2000 para padronizar transferências eletrônicas em toda a rede financeira do país.

Estrutura e Formato do CBU

Todo CBU válido consiste exatamente em 22 dígitos divididos em dois blocos principais:

1. Primeiro Bloco (8 dígitos): Identifica a instituição financeira e a agência

   • Primeiros 3 dígitos: Código do banco atribuído pelo BCRA
   • Próximos 4 dígitos: Código da agência dentro do banco
   • Último dígito: Dígito de verificação do primeiro bloco

2. Segundo Bloco (14 dígitos): Identifica a conta específica

   • Primeiros 13 dígitos: Número da conta (pode incluir tipo de conta e outros identificadores)
   • Último dígito: Dígito de verificação do segundo bloco

Os dígitos de verificação usam um algoritmo de módulo-10 ponderado que detecta erros comuns—como dígitos trocados ou erros de dígito único—antes de qualquer movimentação financeira. Essa salvaguarda tem se mostrado notavelmente eficaz: a maioria dos erros de entrada de CBU são detectados no estágio de validação, em vez de resultar em transferências malsucedidas.

Como Gerar um CBU de Teste

O gerador cria CBUs aleatórios, mas estruturalmente válidos, que passam em todas as verificações de formato. Veja o que acontece nos bastidores:

1. Dígitos aleatórios preenchem as seções de código do banco, código da agência e número da conta
2. A ferramenta calcula os dois dígitos verificadores usando o algoritmo oficial do BCRA
3. Você obtém um CBU de 22 dígitos corretamente formatado, pronto para teste

Quando você achará isso útil:

• Testando integrações de pagamento: Precisa de dezenas de CBUs válidos para sua suíte de testes? Gere-os instantaneamente sem cálculo manual.
• Ambientes de QA e staging: Popule bancos de dados de teste com dados bancários realistas que não correspondam acidentalmente a contas reais.
• Aprendendo o formato: Veja como diferentes CBUs são estruturados e entenda a lógica de verificação.
• Documentação e demonstrações: Crie dados de exemplo que pareçam autênticos sem expor informações bancárias reais.

Passo a Passo: Gerando um CBU

1. Navegue até a aba "Gerador" da ferramenta
2. Clique no botão "Gerar CBU"
3. Um CBU aleatório válido de 22 dígitos aparecerá na área de exibição
4. Use o botão "Copiar" para copiar o CBU para sua área de transferência para uso em suas aplicações

Como Validar um CBU Argentino

O validador executa as mesmas verificações que os sistemas bancários da Argentina usam para verificar a integridade do CBU. O que é verificado:

1. Verificação de comprimento: Confirma exatamente 22 dígitos (um erro comum é copiar com espaços ou hífens)
2. Conteúdo apenas numérico: Garante que não haja letras ou caracteres especiais
3. Checksum do primeiro bloco: Valida o 8º dígito em relação aos primeiros 7 dígitos
4. Checksum do segundo bloco: Valida o 22º dígito em relação aos dígitos 9-21

Quando a validação falha, você verá qual verificação específica não passou. Isso é particularmente útil para depurar por que uma API bancária rejeitou um CBU—geralmente é algo simples como um espaço extra ou um dígito trocado.

Passo a Passo: Validando um CBU

1. Navegue até a aba "Validador" da ferramenta
2. Digite o CBU de 22 dígitos que deseja validar
3. Clique no botão "Validar CBU"
4. Revise o resultado da validação:
   • Indicador verde para CBUs válidos
   • Indicador vermelho com mensagens de erro específicas para CBUs inválidos

O Algoritmo de Verificação do CBU Explicado

O BCRA utiliza um algoritmo de soma de verificação ponderada modulo-10 para calcular dígitos de verificação. Se você está implementando validação de CBU em sua aplicação, aqui está a lógica exata:

Verificação do Primeiro Bloco

Para o primeiro bloco (primeiros 8 dígitos), o dígito de verificação é calculado da seguinte forma:

1. Pegue os primeiros 7 dígitos do CBU
2. Multiplique cada dígito por seu peso correspondente: [7, 1, 3, 9, 7, 1, 3]
3. Some os produtos resultantes
4. Calcule: 10 - (soma % 10)
5. Se o resultado for 10, o dígito de verificação é 0; caso contrário, é o valor calculado

Verificação do Segundo Bloco

Para o segundo bloco (últimos 14 dígitos), o dígito de verificação é calculado da seguinte forma:

1. Pegue os primeiros 13 dígitos do segundo bloco
2. Multiplique cada dígito por seu peso correspondente: [3, 9, 7, 1, 3, 9, 7, 1, 3, 9, 7, 1, 3]
3. Some os produtos resultantes
4. Calcule: 10 - (soma % 10)
5. Se o resultado for 10, o dígito de verificação é 0; caso contrário, é o valor calculado

Exemplos de Código de Validação de CBU

Aqui está como implementar a validação de CBU em sua aplicação. Estes exemplos seguem a especificação oficial do BCRA e funcionarão com dados bancários de produção:

1// JavaScript: Calcular dígito de verificação de CBU
2function calculateCheckDigit(number, weights) {
3  if (number.length !== weights.length) {
4    throw new Error('O comprimento do número deve corresponder ao comprimento dos pesos');
5  }
6  
7  let sum = 0;
8  for (let i = 0; i < number.length; i++) {
9    sum += parseInt(number[i]) * weights[i];
10  }
11  
12  const remainder = sum % 10;
13  return remainder === 0 ? 0 : 10 - remainder;
14}
15
16// Validar primeiro bloco de CBU
17function validateFirstBlock(block) {
18  if (block.length !== 8 || !/^\d{8}$/.test(block)) {
19    return false;
20  }
21  
22  const number = block.substring(0, 7);
23  const checkDigit = parseInt(block[7]);
24  const weights = [7, 1, 3, 9, 7, 1, 3];
25  
26  return checkDigit === calculateCheckDigit(number, weights);
27}
28

1# Python: Validar um CBU completo
2import re
3
4def validate_cbu(cbu):
5    # Verificar formato básico
6    if not cbu or not re.match(r'^\d{22}$', cbu):
7        return {
8            'isValid': False,
9            'errors': ['CBU deve ter 22 dígitos']
10        }
11    
12    # Dividir em blocos
13    first_block = cbu[:8]
14    second_block = cbu[8:]
15    
16    # Validar cada bloco
17    first_block_valid = validate_first_block(first_block)
18    second_block_valid = validate_second_block(second_block)
19    
20    errors = []
21    if not first_block_valid:
22        errors.append('Primeiro bloco (código de banco/agência) é inválido')
23    if not second_block_valid:
24        errors.append('Segundo bloco (número da conta) é inválido')
25    
26    return {
27        'isValid': first_block_valid and second_block_valid,
28        'errors': errors
29    }
30

1// Java: Gerar um CBU válido aleatório
2import java.util.Random;
3
4public class CBUGenerator {
5    private static final Random random = new Random();
6    
7    public static String generateCBU() {
8        // Gerar primeiros 7 dígitos (código de banco e agência)
9        StringBuilder firstBlockBase = new StringBuilder();
10        for (int i = 0; i < 7; i++) {
11            firstBlockBase.append(random.nextInt(10));
12        }
13        
14        // Calcular dígito de verificação para o primeiro bloco
15        int[] firstBlockWeights = {7, 1, 3, 9, 7, 1, 3};
16        int firstBlockCheckDigit = calculateCheckDigit(
17            firstBlockBase.toString(), 
18            firstBlockWeights
19        );
20        
21        // Gerar primeiros 13 dígitos do segundo bloco
22        StringBuilder secondBlockBase = new StringBuilder();
23        for (int i = 0; i < 13; i++) {
24            secondBlockBase.append(random.nextInt(10));
25        }
26        
27        // Calcular dígito de verificação para o segundo bloco
28        int[] secondBlockWeights = {3, 9, 7, 1, 3, 9, 7, 1, 3, 9, 7, 1, 3};
29        int secondBlockCheckDigit = calculateCheckDigit(
30            secondBlockBase.toString(), 
31            secondBlockWeights
32        );
33        
34        // Combinar todas as partes
35        return firstBlockBase.toString() + firstBlockCheckDigit + 
36               secondBlockBase.toString() + secondBlockCheckDigit;
37    }
38    
39    // Implementação do método calculateCheckDigit...
40}
41

1// PHP: Formatar um CBU para exibição
2function formatCBU($cbu) {
3    if (!$cbu || strlen($cbu) !== 22) {
4        return $cbu;
5    }
6    
7    // Formatar como: XXXXXXXX XXXXXXXXXXXXXX
8    return substr($cbu, 0, 8) . ' ' . substr($cbu, 8);
9}
10
11// Exemplo de uso
12$cbu = '0123456789012345678901';
13echo formatCBU($cbu); // Exibe: 01234567 89012345678901
14

1' Excel VBA: Validar um CBU
2Function ValidateCBU(cbu As String) As Boolean
3    ' Verificar comprimento
4    If Len(cbu) <> 22 Then
5        ValidateCBU = False
6        Exit Function
7    End If
8    
9    ' Verificar se todos os caracteres são dígitos
10    Dim i As Integer
11    For i = 1 To Len(cbu)
12        If Not IsNumeric(Mid(cbu, i, 1)) Then
13            ValidateCBU = False
14            Exit Function
15        End If
16    Next i
17    
18    ' Extrair blocos
19    Dim firstBlock As String
20    Dim secondBlock As String
21    firstBlock = Left(cbu, 8)
22    secondBlock = Right(cbu, 14)
23    
24    ' Validar ambos os blocos
25    ValidateCBU = ValidateFirstBlock(firstBlock) And ValidateSecondBlock(secondBlock)
26End Function
27

Casos de Uso do Mundo Real para Validação de CBU

Testando Integrações de Pagamento

Ao construir aplicativos fintech ou plataformas de e-commerce que processam pagamentos argentinos, você precisa de CBUs válidos para seu ambiente de teste. Um cenário comum: seu ambiente de staging requer 50 contas de teste com CBUs válidos para teste de carga. Calcular manualmente os dígitos de verificação para cada um levaria horas. O gerador faz isso em segundos, fornecendo dados de teste formatados corretamente que se comportam como CBUs de produção sem o risco de usar acidentalmente números de conta reais.

Dica profissional: Mantenha um conjunto de CBUs gerados em seus fixtures de teste. Isso garante dados de teste consistentes em toda a equipe e facilita a depuração quando os testes falham.

Prevenindo Erros de Transação

Eis o que normalmente acontece: um cliente fornece seu CBU para uma transferência bancária, mas acidentalmente incluiu espaços ou trocou dois dígitos. Se você processar a transferência sem validação, o banco a rejeita — mas apenas após um atraso, e você já registrou a intenção da transação em seu sistema. Agora você está lidando com dores de cabeça de conciliação.

Validar o formato do CBU antes do envio detecta esses erros imediatamente. O validador não dirá se a conta existe ou pertence à pessoa certa (isso requer acesso à API bancária), mas confirmará se a estrutura está correta de acordo com os padrões do BCRA.

Compreendendo os Requisitos de Integração Bancária

Para desenvolvedores novos no sistema financeiro argentino, esta ferramenta oferece aprendizado prático. Você pode ver exatamente como funcionam os dígitos de verificação, entender por que certos números são inválidos e experimentar casos limítrofes antes de escrever código de produção.

Erro comum: Presumir que a validação de CBU é igual à validação de IBAN. Embora ambos usem dígitos de verificação, os algoritmos são completamente diferentes. Testar com esta ferramenta ajuda a entender os requisitos específicos dos códigos bancários argentinos.

Validação de Formulários em UIs Bancárias

Ao projetar formulários de entrada que aceitam CBUs, você precisa testar como o sistema lida com vários estados de erro. O que acontece quando um usuário cola um CBU com espaços? Que mensagem de erro aparece quando o dígito de verificação está errado? Esta ferramenta ajuda você a testar esses cenários e projetar um feedback de usuário melhor.

Ferramentas Relacionadas de Validação Bancária

Dependendo dos seus requisitos, você também pode precisar destas ferramentas complementares:

• Validador de CUIT/CUIL: Valida números de identificação fiscal argentinos—essencial quando você precisa de verificação tanto bancária quanto de identificação fiscal
• Validador de CVU: Semelhante ao CBU, mas para carteiras digitais (Mercado Pago, Ualá, etc.) usando o mesmo formato de 22 dígitos
• Validador de IBAN: Para pagamentos internacionais envolvendo contas europeias ou de outros países
• Serviços de API Bancária: Para sistemas de produção que precisam verificar a propriedade da conta e fazer verificações de saldo, não apenas validação de formato

Limitação importante: Esta ferramenta apenas valida o formato e os dígitos de verificação. Não pode confirmar se um CBU corresponde a uma conta bancária ativa ou verificar a identidade do titular da conta. Para essas verificações, você precisará de integração com APIs bancárias argentinas ou processadores de pagamento.

Como o Sistema Bancário da Argentina Adotou o CBU

Antes de novembro de 2000, enviar dinheiro entre bancos argentinos era surpreendentemente complicado. Cada instituição financeira usava seu próprio sistema de numeração de contas — alguns com 10 dígitos, outros com 15, e nenhuma forma padronizada de identificar qual banco ou agência detinha uma conta. Transferências interbancárias exigiam verificação manual e frequentemente levavam dias para serem processadas.

O BCRA introduziu o CBU para resolver essa fragmentação. Ao exigir um único formato de 22 dígitos em todas as instituições financeiras, a Argentina se alinhou com padrões internacionais como o sistema IBAN europeu. Os dígitos de verificação embutidos eram particularmente inteligentes: eles capturam automaticamente a maioria dos erros de digitação, reduzindo transferências com falhas e os custos associados à investigação e reversão de transações.

O que é interessante: O formato do CBU mal mudou em mais de 20 anos. Embora a tecnologia bancária tenha evoluído drasticamente — aplicativos móveis, transferências instantâneas, carteiras digitais — a estrutura subjacente do CBU permanece a mesma. Essa estabilidade demonstra o quão bem o design original antecipou necessidades futuras.

Atualmente, os argentinos usam CBUs para praticamente todas as transações financeiras eletrônicas: depósitos de salário, pagamentos de contas, declarações fiscais, benefícios governamentais e comércio eletrônico. O formato provou ser tão eficaz que quando as carteiras digitais surgiram (como o Mercado Pago), os reguladores adotaram a mesma estrutura para CVUs (Clave Virtual Uniforme) em vez de inventar algo novo.

Perguntas Frequentes

Qual é a diferença entre um CBU e um CVU?

Os CBUs identificam contas bancárias tradicionais, enquanto os CVUs (Chave Virtual Uniforme) identificam contas de carteiras digitais de provedores de fintech como Mercado Pago, Ualá ou Brubank. O formato é idêntico—22 dígitos com o mesmo algoritmo de validação—o que faz sentido porque são interoperáveis. Você pode transferir dinheiro de um CBU para um CVU e vice-versa, como qualquer outra transferência bancária. Os três primeiros dígitos revelam se você está olhando para um banco tradicional ou um provedor de carteira digital.

Posso descobrir o nome do banco a partir de um CBU?

Sim. Os três primeiros dígitos são o identificador do banco atribuído pelo BCRA. Por exemplo, códigos que começam com "011" pertencem ao Banco Nación, enquanto "017" indica BBVA Argentina. O BCRA publica um registro oficial desses códigos, que os aplicativos bancários normalmente usam para exibir automaticamente o nome do banco quando você insere um CBU.

Um CBU é igual a um número de conta?

Não exatamente. Seu número de conta está embutido no CBU, mas o CBU o empacota com informações adicionais de roteamento. Pense como a diferença entre um endereço de rua e coordenadas GPS—ambos identificam um local, mas um inclui mais contexto. O CBU agrupa seu código de banco, código de agência, número da conta e dois dígitos de verificação em uma única sequência transferível.

Quão seguro é compartilhar meu CBU?

Seu CBU foi projetado para ser compartilhado—esse é o ponto principal. Os destinatários precisam dele para depositar dinheiro em sua conta. Diferentemente de senhas ou PINs, um CBU só permite transferências de entrada, não saques. Dito isso, trate-o como qualquer informação financeira: compartilhe com pessoas ou empresas em quem confia e seja cauteloso ao publicá-lo online. Algumas pessoas preferem fornecer seu CBU seletivamente em vez de publicá-lo abertamente.

Um CBU pode expirar ou mudar?

Seu CBU permanece com você enquanto a conta estiver aberta. A única vez que muda é se você fechar essa conta e abrir uma nova, ou em casos raros quando os bancos se fundem ou reestruturam seus sistemas de numeração. Mesmo assim, os bancos geralmente mantêm o CBU antigo por um período de transição para evitar interromper pagamentos recorrentes.

Como encontro meu próprio CBU?

Verifique o aplicativo do seu banco—geralmente está na seção de detalhes da conta. A maioria dos bancos argentinos também o exibe de forma proeminente no internet banking, imprime em extratos mensais e alguns até o incluem no verso dos cartões de débito. Se não conseguir localizá-lo, qualquer representante bancário pode fornecê-lo imediatamente; não é considerado informação sensível como um PIN.

Estrangeiros podem ter um CBU na Argentina?

Sim. Abrir uma conta bancária na Argentina como estrangeiro lhe dá um CBU como qualquer outro titular de conta. Os requisitos variam por instituição—alguns bancos exigem apenas um passaporte, enquanto outros pedem comprovante de residência ou um CDI (número de identificação fiscal). Carteiras digitais (CVU) são frequentemente mais fáceis para estrangeiros acessarem do que contas bancárias tradicionais.

O que acontece se eu fizer uma transferência para um CBU inválido?

Os sistemas bancários modernos realizam validação de formato antes de submeter a transferência. Se os dígitos de verificação não corresponderem ou o comprimento estiver incorreto, você receberá um erro imediato—a transferência nunca sairá de sua conta. É por isso que a validação de front-end é tão valiosa; ela captura erros de digitação antes que causem problemas.

A situação mais complicada é quando um CBU passa na validação de formato, mas não corresponde a uma conta ativa. A transferência é enviada para a rede interbancária e depois retorna após horas ou dias. Você já a registrou como "enviada" em sua contabilidade e agora precisa conciliar o retorno. É por isso que alguns aplicativos também verificam CBUs em bancos de dados antes de permitir transferências, embora isso exija acesso a API pago.

Posso ter múltiplos CBUs?

Absolutamente. Cada conta gera seu próprio CBU. Se você tem uma conta corrente e uma conta poupança no mesmo banco, terá dois CBUs distintos. Contas diferentes em bancos diferentes? Mais CBUs. Cada um identifica exclusivamente uma conta específica em uma agência específica de uma instituição específica.

O sistema de CBU é usado fora da Argentina?

Não, os CBUs são específicos da Argentina. Cada país tem seu próprio sistema: a Europa usa IBAN, os EUA usam números de roteamento mais números de conta, a Austrália usa códigos BSB, e assim por diante. Ao enviar dinheiro internacionalmente, você normalmente precisará do código SWIFT do destinatário mais seu identificador de conta local—que no caso da Argentina seria o CBU.

Referências e Documentação Oficial

Para informações autorizadas sobre os padrões bancários da Argentina:

1. Banco Central da Argentina (BCRA) - Regulamentos do Sistema Financeiro - Documentação oficial do BCRA sobre padrões de sistemas de pagamento e regulamentos bancários

2. Lei nº 25.345 - "Prevenção de Evasão Fiscal e Modernização de Pagamentos" (Novembro de 2000) - A legislação que estabeleceu a estrutura de sistemas de pagamento eletrônico da Argentina

3. Comunicação "A" do BCRA - Circulares técnicas que definem os requisitos de implementação de CBU para instituições financeiras

4. Interbanking S.A. - A organização que opera a rede de pagamento eletrônico interbancário da Argentina e mantém as tabelas de roteamento de CBU

Essas fontes fornecem as especificações técnicas utilizadas para implementar este validador e são regularmente atualizadas pelas autoridades financeiras argentinas.

Pronto para Validar ou Gerar CBUs?

Seja você que está construindo uma integração de pagamento, testando uma aplicação fintech ou aprendendo sobre o sistema bancário argentino, entender a validação de CBU é essencial. Esta ferramenta implementa exatamente os mesmos algoritmos de checksum que os bancos argentinos usam, para que você possa identificar erros de formato antes que causem falhas de transação.

Lembre-se: a validação de formato é apenas o primeiro passo. Um CBU formatado corretamente não garante que a conta exista ou que você tenha o destinatário correto. Para sistemas de produção que lidam com dinheiro real, combine a validação de formato com verificações adicionais por meio de APIs bancárias ou processadores de pagamento.

A ferramenta não requer registro ou instalação — basta abri-la e começar a validar ou gerar CBUs de acordo com os padrões oficiais do BCRA.