Générateur et Validateur de CBU pour l'Argentine | Codes Bancaires de la BCRA

Qu'est-ce qu'un CBU argentin et pourquoi le valider ?

Travailler avec le système bancaire argentin signifie traiter avec le CBU (Clave Bancaria Uniforme) — un code de 22 chiffres qui identifie de manière unique chaque compte bancaire du pays. Si vous avez déjà eu besoin de tester une intégration de paiement, de vérifier des détails bancaires avant un transfert, ou de comprendre pourquoi une transaction a échoué, vous savez à quel point il est crucial de travailler avec des CBU correctement formatés.

Cet outil vous aide à générer des CBU structurellement valides pour les environnements de test et à valider des codes existants par rapport au format officiel spécifié par la Banque centrale d'Argentine (BCRA). Lorsque vous développez des applications financières ou traitez des paiements, détecter les erreurs de format dès le début permet de gagner des heures de débogage et d'éviter les transactions échouées.

Comprendre le Format CBU

Le CBU (Clave Bancaria Uniforme) est la réponse de l'Argentine aux identificateurs bancaires internationaux comme l'IBAN ou les numéros de routage américains. Pensez-y comme un package complet qui regroupe les informations de la banque, de la succursale et du compte dans un seul code de 22 chiffres. La Banque Centrale d'Argentine (BCRA) a lancé ce système en novembre 2000 pour standardiser les transferts électroniques à travers le réseau financier du pays.

Structure et Format du CBU

Chaque CBU valide se compose exactement de 22 chiffres divisés en deux blocs principaux :

Premier Bloc (8 chiffres) : Identifie l'institution financière et la succursale
- Premiers 3 chiffres : Code de la banque attribué par la BCRA
- 4 chiffres suivants : Code de la succursale au sein de la banque
- Dernier chiffre : Chiffre de vérification pour le premier bloc
Deuxième Bloc (14 chiffres) : Identifie le compte spécifique
- Premiers 13 chiffres : Numéro de compte (peut inclure le type de compte et d'autres identificateurs)
- Dernier chiffre : Chiffre de vérification pour le deuxième bloc

Les chiffres de vérification utilisent un algorithme de modulo-10 pondéré qui détecte les erreurs de frappe courantes — comme les chiffres inversés ou les erreurs de chiffre unique — avant tout mouvement d'argent. Cette protection s'est avérée remarquablement efficace : la plupart des erreurs de saisie de CBU sont interceptées à l'étape de validation plutôt que de provoquer des transferts échoués.

Comment générer un CBU de test

Le générateur crée des CBU aléatoires mais structurellement valides qui passent tous les contrôles de format. Voici ce qui se passe en coulisses :

Des chiffres aléatoires remplissent les sections du code bancaire, du code d'agence et du numéro de compte
L'outil calcule les deux chiffres de vérification en utilisant l'algorithme officiel de la BCRA
Vous obtenez un CBU correctement formaté de 22 chiffres prêt pour les tests

Quand cela vous sera utile :

Tests d'intégration de paiement : Besoin de dizaines de CBU valides pour votre suite de tests ? Générez-les instantanément sans calcul manuel.
Environnements de QA et de staging : Peuplez des bases de données de test avec des données bancaires réalistes qui ne correspondront pas accidentellement à des comptes réels.
Comprendre le format : Voyez comment différents CBU sont structurés et comprenez la logique de vérification.
Documentation et démonstrations : Créez des données d'exemple qui semblent authentiques sans exposer d'informations bancaires réelles.

Étape par étape : Générer un CBU

Accédez à l'onglet "Générateur" de l'outil
Cliquez sur le bouton "Générer CBU"
Un CBU aléatoire valide de 22 chiffres apparaîtra dans la zone d'affichage
Utilisez le bouton "Copier" pour copier le CBU dans votre presse-papiers pour l'utiliser dans vos applications

Comment valider un CBU argentin

Le validateur effectue les mêmes vérifications que les systèmes bancaires argentins utilisent pour vérifier l'intégrité du CBU. Voici ce qui est vérifié :

Vérification de la longueur : Confirme exactement 22 chiffres (une erreur courante est de copier avec des espaces ou des traits d'union)
Contenu numérique uniquement : S'assure qu'aucune lettre ou caractère spécial ne s'est glissé
Somme de contrôle du premier bloc : Valide le 8ème chiffre par rapport aux 7 premiers chiffres
Somme de contrôle du deuxième bloc : Valide le 22ème chiffre par rapport aux chiffres 9-21

Lorsque la validation échoue, vous verrez quel contrôle spécifique n'a pas été validé. Cela est particulièrement utile pour comprendre pourquoi une API bancaire a rejeté un CBU—souvent, c'est quelque chose de simple comme un espace supplémentaire ou un chiffre inversé.

Étape par étape : Validation d'un CBU

Accédez à l'onglet "Validateur" de l'outil
Entrez le CBU de 22 chiffres que vous souhaitez valider
Cliquez sur le bouton "Valider CBU"
Examinez le résultat de la validation :
- Indicateur vert pour les CBU valides
- Indicateur rouge avec des messages d'erreur spécifiques pour les CBU invalides

L'algorithme de vérification CBU expliqué

La BCRA utilise un algorithme de somme de contrôle pondéré modulo-10 pour calculer les chiffres de vérification. Si vous implémentez la validation CBU dans votre application, voici la logique exacte :

Vérification du premier bloc

Pour le premier bloc (premiers 8 chiffres), le chiffre de vérification est calculé comme suit :

Prendre les 7 premiers chiffres du CBU
Multiplier chaque chiffre par son poids correspondant : [7, 1, 3, 9, 7, 1, 3]
Additionner les produits résultants
Calculer : 10 - (somme % 10)
Si le résultat est 10, le chiffre de vérification est 0 ; sinon, c'est la valeur calculée

Vérification du deuxième bloc

Pour le deuxième bloc (derniers 14 chiffres), le chiffre de vérification est calculé comme suit :

Prendre les 13 premiers chiffres du deuxième bloc
Multiplier chaque chiffre par son poids correspondant : [3, 9, 7, 1, 3, 9, 7, 1, 3, 9, 7, 1, 3]
Additionner les produits résultants
Calculer : 10 - (somme % 10)
Si le résultat est 10, le chiffre de vérification est 0 ; sinon, c'est la valeur calculée

Exemples de code de validation de CBU

Voici comment implémenter la validation de CBU dans votre application. Ces exemples suivent la spécification officielle de la BCRA et fonctionneront avec des données bancaires de production :

1// JavaScript : Calculer le chiffre de contrôle du CBU
2function calculateCheckDigit(number, weights) {
3  if (number.length !== weights.length) {
4    throw new Error('La longueur du nombre doit correspondre à la longueur des poids');
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// Valider le premier bloc du 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 : Valider un CBU complet
2import re
3
4def validate_cbu(cbu):
5    # Vérifier le format de base
6    if not cbu or not re.match(r'^\d{22}$', cbu):
7        return {
8            'isValid': False,
9            'errors': ['Le CBU doit comporter 22 chiffres']
10        }
11    
12    # Diviser en blocs
13    first_block = cbu[:8]
14    second_block = cbu[8:]
15    
16    # Valider chaque bloc
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('Le premier bloc (code de banque/succursale) est invalide')
23    if not second_block_valid:
24        errors.append('Le deuxième bloc (numéro de compte) est invalide')
25    
26    return {
27        'isValid': first_block_valid and second_block_valid,
28        'errors': errors
29    }
30

1// Java : Générer un CBU valide aléatoire
2import java.util.Random;
3
4public class CBUGenerator {
5    private static final Random random = new Random();
6    
7    public static String generateCBU() {
8        // Générer les 7 premiers chiffres (code de banque et de succursale)
9        StringBuilder firstBlockBase = new StringBuilder();
10        for (int i = 0; i < 7; i++) {
11            firstBlockBase.append(random.nextInt(10));
12        }
13        
14        // Calculer le chiffre de contrôle pour le premier bloc
15        int[] firstBlockWeights = {7, 1, 3, 9, 7, 1, 3};
16        int firstBlockCheckDigit = calculateCheckDigit(
17            firstBlockBase.toString(), 
18            firstBlockWeights
19        );
20        
21        // Générer les 13 premiers chiffres du deuxième bloc
22        StringBuilder secondBlockBase = new StringBuilder();
23        for (int i = 0; i < 13; i++) {
24            secondBlockBase.append(random.nextInt(10));
25        }
26        
27        // Calculer le chiffre de contrôle pour le deuxième bloc
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        // Combiner toutes les parties
35        return firstBlockBase.toString() + firstBlockCheckDigit + 
36               secondBlockBase.toString() + secondBlockCheckDigit;
37    }
38    
39    // Implémentation de la méthode calculateCheckDigit...
40}
41

1// PHP : Formater un CBU pour l'affichage
2function formatCBU($cbu) {
3    if (!$cbu || strlen($cbu) !== 22) {
4        return $cbu;
5    }
6    
7    // Formater comme : XXXXXXXX XXXXXXXXXXXXXX
8    return substr($cbu, 0, 8) . ' ' . substr($cbu, 8);
9}
10
11// Exemple d'utilisation
12$cbu = '0123456789012345678901';
13echo formatCBU($cbu); // Affiche : 01234567 89012345678901
14

1' Excel VBA : Valider un CBU
2Function ValidateCBU(cbu As String) As Boolean
3    ' Vérifier la longueur
4    If Len(cbu) <> 22 Then
5        ValidateCBU = False
6        Exit Function
7    End If
8    
9    ' Vérifier si tous les caractères sont des chiffres
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    ' Extraire les blocs
19    Dim firstBlock As String
20    Dim secondBlock As String
21    firstBlock = Left(cbu, 8)
22    secondBlock = Right(cbu, 14)
23    
24    ' Valider les deux blocs
25    ValidateCBU = ValidateFirstBlock(firstBlock) And ValidateSecondBlock(secondBlock)
26End Function
27

Cas d'utilisation réels pour la validation de CBU

Test des intégrations de paiement

Lors de la création d'applications fintech ou de plateformes de commerce électronique qui traitent des paiements argentins, vous avez besoin de CBU valides pour votre environnement de test. Un scénario courant : votre environnement de staging nécessite 50 comptes de test avec des CBU valides pour les tests de charge. Calculer manuellement les chiffres de contrôle pour chacun prendrait des heures. Le générateur gère cela en quelques secondes, vous fournissant des données de test correctement formatées qui se comportent comme des CBU de production sans le risque d'utiliser accidentellement de vrais numéros de compte.

Conseil pro : Conservez un ensemble de CBU générés dans vos fixtures de test. Cela garantit des données de test cohérentes au sein de votre équipe et facilite le débogage lorsque les tests échouent.

Prévention des erreurs de transaction

Voici ce qui se passe typiquement : un client fournit son CBU pour un virement, mais il a accidentellement inclus des espaces ou inversé deux chiffres. Si vous traitez le transfert sans validation, la banque le rejette — mais seulement après un délai, et vous avez déjà enregistré l'intention de transaction dans votre système. Vous voilà maintenant confronté à des maux de tête de rapprochement.

Valider le format du CBU avant soumission permet de détecter immédiatement ces erreurs. Le validateur ne vous dira pas si le compte existe ou appartient à la bonne personne (cela nécessite un accès à l'API bancaire), mais il confirmera que la structure est correcte selon les normes de la BCRA.

Comprendre les exigences d'intégration bancaire

Pour les développeurs nouveaux dans le système financier argentin, cet outil offre un apprentissage pratique. Vous pouvez voir exactement comment fonctionnent les chiffres de contrôle, comprendre pourquoi certains numéros sont invalides et expérimenter avec des cas limites avant d'écrire du code de production.

Erreur courante : Supposer que la validation de CBU est identique à la validation IBAN. Bien que les deux utilisent des chiffres de contrôle, les algorithmes diffèrent complètement. Tester avec cet outil vous aide à comprendre les exigences spécifiques des codes bancaires argentins.

Validation de formulaire dans les interfaces bancaires

Lors de la conception de formulaires de saisie qui acceptent des CBU, vous devez tester comment le système gère différents états d'erreur. Que se passe-t-il lorsqu'un utilisateur colle un CBU avec des espaces ? Quel message d'erreur apparaît lorsque le chiffre de contrôle est incorrect ? Cet outil vous aide à tester ces scénarios et à concevoir une meilleure rétroaction utilisateur.

Outils de Validation Bancaire Connexes

Selon vos besoins, vous pourriez également avoir besoin de ces outils complémentaires :

Validateur CUIT/CUIL : Valide les numéros d'identification fiscale argentins—essentiel lorsque vous avez besoin de la vérification à la fois bancaire et fiscale
Validateur CVU : Similaire au CBU mais pour les portefeuilles numériques (Mercado Pago, Ualá, etc.) utilisant le même format de 22 chiffres
Validateur IBAN : Pour les paiements transfrontaliers impliquant des comptes européens ou internationaux
Services d'API Bancaires : Pour les systèmes de production qui doivent vérifier la propriété du compte et effectuer des vérifications de solde, pas seulement la validation du format

Limitation importante : Cet outil ne valide que le format et les chiffres de contrôle. Il ne peut pas confirmer si un CBU correspond à un compte bancaire actif ou vérifier l'identité du titulaire du compte. Pour ces vérifications, vous aurez besoin d'une intégration avec les API bancaires argentines ou les processeurs de paiement.

Comment le système bancaire argentin a adopté le CBU

Avant novembre 2000, l'envoi d'argent entre les banques argentines était étonnamment compliqué. Chaque institution financière utilisait son propre système de numérotation de compte — certaines avec 10 chiffres, d'autres avec 15, et aucune méthode standardisée pour identifier la banque ou l'agence détenant un compte. Les transferts interbancaires nécessitaient une vérification manuelle et prenaient souvent plusieurs jours pour être traités.

La BCRA a introduit le CBU pour résoudre cette fragmentation. En imposant un format unique de 22 chiffres pour toutes les institutions financières, l'Argentine s'est alignée sur les normes internationales comme le système IBAN européen. Les chiffres de contrôle intégrés étaient particulièrement intelligents : ils détectent automatiquement la plupart des erreurs de saisie, réduisant les transferts échoués et les coûts associés à l'investigation et à l'annulation des transactions.

Ce qui est intéressant : Le format CBU n'a presque pas changé depuis plus de 20 ans. Bien que la technologie bancaire ait considérablement évolué — applications mobiles, transferts instantanés, portefeuilles numériques — la structure sous-jacente du CBU reste la même. Cette stabilité témoigne de la qualité de la conception originale qui a anticipé les besoins futurs.

Aujourd'hui, les Argentins utilisent les CBU pour pratiquement toutes les transactions financières électroniques : dépôts de salaire, paiements de factures, déclarations fiscales, prestations gouvernementales et e-commerce. Le format s'est avéré si efficace que lorsque les portefeuilles numériques ont émergé (comme Mercado Pago), les régulateurs ont adopté la même structure pour les CVU (Clave Virtual Uniforme) plutôt que d'en inventer une nouvelle.

Questions fréquemment posées

Quelle est la différence entre un CBU et un CVU ?

Les CBU identifient les comptes bancaires traditionnels, tandis que les CVU (Clave Virtual Uniforme) identifient les comptes de portefeuille numérique des fournisseurs de fintech comme Mercado Pago, Ualá ou Brubank. Le format est identique — 22 chiffres avec le même algorithme de validation — ce qui a du sens car ils sont interopérables. Vous pouvez transférer de l'argent d'un CBU à un CVU et vice versa comme n'importe quel autre transfert bancaire. Les trois premiers chiffres révèlent si vous regardez une banque traditionnelle ou un fournisseur de portefeuille numérique.

Puis-je connaître le nom de la banque à partir d'un CBU ?

Oui. Les trois premiers chiffres sont l'identifiant bancaire attribué par la BCRA. Par exemple, les codes commençant par « 011 » appartiennent à Banco Nación, tandis que « 017 » indique BBVA Argentina. La BCRA publie un registre officiel de ces codes, que les applications bancaires utilisent généralement pour afficher automatiquement le nom de la banque lorsque vous entrez un CBU.

Un CBU est-il identique à un numéro de compte ?

Pas tout à fait. Votre numéro de compte est intégré dans le CBU, mais le CBU l'accompagne d'informations de routage supplémentaires. Pensez-y comme à la différence entre une adresse de rue et des coordonnées GPS — les deux identifient un emplacement, mais l'un inclut plus de contexte. Le CBU regroupe votre code bancaire, code d'agence, numéro de compte et deux chiffres de vérification dans une chaîne unique transférable.

Est-il sûr de partager mon CBU ?

Votre CBU est conçu pour être partagé — c'est tout le point. Les destinataires en ont besoin pour déposer de l'argent sur votre compte. Contrairement aux mots de passe ou aux codes PIN, un CBU ne permet que les transferts entrants, pas les retraits. Cela dit, traitez-le comme toute information financière : partagez-le avec des personnes ou des entreprises en qui vous avez confiance, et soyez prudent à propos de le publier en ligne. Certaines personnes préfèrent donner leur CBU de manière sélective plutôt que de le publier ouvertement.

Un CBU peut-il expirer ou changer ?

Votre CBU reste avec vous tant que le compte reste ouvert. Le seul moment où il change est si vous fermez ce compte et en ouvrez un nouveau, ou dans de rares cas lorsque les banques fusionnent ou restructurent leurs systèmes de numérotation. Même alors, les banques maintiennent généralement l'ancien CBU pendant une période de transition pour éviter de perturber les paiements récurrents.

Comment trouver mon propre CBU ?

Consultez l'application mobile de votre banque — il se trouve généralement dans la section détails du compte. La plupart des banques argentines l'affichent également de manière bien visible dans les services bancaires en ligne, l'impriment sur les relevés mensuels, et certaines l'incluent même au dos des cartes de débit. Si vous ne le trouvez pas, n'importe quel représentant bancaire peut vous le fournir immédiatement ; ce n'est pas considéré comme une information sensible comme un code PIN.

Les étrangers peuvent-ils avoir un CBU en Argentine ?

Oui. Ouvrir un compte bancaire en Argentine en tant qu'étranger vous donne un CBU comme tout autre titulaire de compte. Les exigences varient selon l'institution — certaines banques ne nécessitent qu'un passeport, tandis que d'autres demandent une preuve de résidence ou un CDI (numéro d'identification fiscale). Les portefeuilles numériques (CVU) sont souvent plus faciles d'accès pour les étrangers que les comptes bancaires traditionnels.

Que se passe-t-il si je fais un transfert vers un CBU invalide ?

Les systèmes bancaires modernes effectuent une validation de format avant de soumettre le transfert. Si les chiffres de contrôle ne correspondent pas ou si la longueur est incorrecte, vous recevrez une erreur immédiate — le transfert ne quitte pas votre compte. C'est pourquoi la validation en amont est si précieuse ; elle détecte les fautes de frappe avant qu'elles ne causent des problèmes.

La situation plus délicate est lorsqu'un CBU passe la validation de format mais ne correspond pas à un compte actif. Le transfert est soumis au réseau interbancaire, puis revient des heures ou des jours plus tard. Vous l'avez déjà enregistré comme « envoyé » dans votre comptabilité, et maintenant vous devez rapprocher le retour. C'est pourquoi certaines applications vérifient également les CBU par rapport aux bases de données bancaires avant d'autoriser les transferts, bien que cela nécessite un accès API payant.

Puis-je avoir plusieurs CBU ?

Absolument. Chaque compte génère son propre CBU. Si vous avez un compte courant et un compte d'épargne dans la même banque, vous aurez deux CBU distincts. Différents comptes dans différentes banques ? Plus de CBU. Chacun identifie uniquement un compte spécifique dans une agence spécifique d'une institution spécifique.

Le système CBU est-il utilisé en dehors de l'Argentine ?

Non, les CBU sont spécifiques à l'Argentine. Chaque pays a son propre système : l'Europe utilise l'IBAN, les États-Unis utilisent des numéros de routage plus des numéros de compte, l'Australie utilise des codes BSB, et ainsi de suite. Lors de l'envoi d'argent à l'international, vous aurez généralement besoin du code SWIFT du destinataire plus de son identifiant de compte local — qui dans le cas de l'Argentine serait le CBU.

Références et Documentation Officielle

Pour des informations faisant autorité sur les normes bancaires argentines :

Banque Centrale d'Argentine (BCRA) - Réglementations du Système Financier - Documentation officielle de la BCRA sur les normes de système de paiement et les réglementations bancaires
Loi n° 25,345 - "Prévention de l'Évasion Fiscale et Modernisation des Paiements" (Novembre 2000) - La législation qui a établi le cadre des systèmes de paiement électronique en Argentine
Communication "A" de la BCRA - Circulaires techniques définissant les exigences de mise en œuvre du CBU pour les institutions financières
Interbanking S.A. - L'organisation qui exploite le réseau de paiement électronique interbancaire argentin et maintient les tables de routage CBU

Ces sources fournissent les spécifications techniques utilisées pour mettre en œuvre ce validateur et sont régulièrement mises à jour par les autorités financières argentines.

Prêt à Valider ou Générer des CBU ?

Que vous construisiez une intégration de paiement, testiez une application fintech, ou appreniez à connaître le système bancaire argentin, comprendre la validation de CBU est essentiel. Cet outil implémente exactement les mêmes algorithmes de somme de contrôle que les banques argentines utilisent, afin que vous puissiez détecter les erreurs de format avant qu'elles ne provoquent des échecs de transaction.

Rappelez-vous : la validation du format n'est que la première étape. Un CBU correctement formaté ne garantit pas que le compte existe ou que vous avez le bon destinataire. Pour les systèmes de production traitant de l'argent réel, combinez la validation du format avec une vérification supplémentaire via des API bancaires ou des processeurs de paiement.

L'outil ne nécessite aucune inscription ou installation — ouvrez-le simplement et commencez à valider ou générer des CBU selon les normes officielles de la BCRA.