ForHosting KIT · Outils pour développeurs

Chiffre de contrôle ABA

Obtenez ou vérifiez le neuvième chiffre d'un numéro de routing bancaire américain avec les poids officiels 3-7-1 : 02100002 reçoit le 1 et devient 021000021. Un chiffre mal saisi est repéré avant l'envoi d'une paie. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Nombre: 02100002

Vous obtenez

Mode de calcul: Compute
Entrée: 02100002
Chiffre de contrôle: 1
Avec chiffre de contrôle: 021000021

Les numéros de routing de transit bancaire des États-Unis (RTN), aussi appelés numéros de routing ABA, comptent neuf chiffres : huit chiffres de charge utile qui identifient le district de la Federal Reserve, l’institution et la série du chiffre de contrôle, plus un chiffre final qui prouve que la chaîne a été saisie ou collée sans une erreur d’un seul chiffre. Cette capacité applique la pondération officielle trois-sept-un de l’American Bankers Association et de la Federal Reserve : les positions cyclent les poids trois, sept et un, et la somme des neuf chiffres doit être divisible par dix.

Comment le chiffre de contrôle de routing ABA est calculé

Un numéro de routing de transit ABA compte toujours neuf chiffres. Les huit premiers forment le corps institutionnel (district de la Federal Reserve, identifiant de la banque et série associée) ; le neuvième est le chiffre de contrôle. Pour le calculer, parcourez les huit chiffres de gauche à droite et multipliez par la séquence de poids répétée trois, sept, un, trois, sept, un, trois, sept.

Additionnez ces huit produits, puis prenez le chiffre de contrôle comme dix moins cette somme modulo dix, modulo dix à nouveau afin qu’un reste zéro donne le chiffre de contrôle zéro. De façon équivalente, la chaîne complète de neuf chiffres incluant le chiffre de contrôle doit avoir une somme pondérée divisible par dix lorsque la neuvième position utilise aussi le poids un (en poursuivant le cycle trois-sept-un). Ce n’est pas la même règle que UPC, EAN ou Luhn : ceux-ci utilisent d’autres motifs de poids et d’autres longueurs.

Cet outil ne prouve pas qu’une banque utilise encore un RTN donné, n’étend pas les symboles MICR et n’affirme pas qu’une somme de contrôle valide signifie que les fonds se liquideront—il prouve seulement que la chaîne de chiffres est bien formée sous la règle ABA trois-sept-un.

Face aux validateurs multi-formats de numéros de paiement, l’intention de recherche ici est étroite : ceux qui ont besoin d’un calculateur de chiffre de contrôle de routing ABA pour des charges de huit chiffres ou des RTN de neuf, pas un vérificateur général d’IBAN ou de carte.

Où les chiffres de contrôle ABA s’insèrent dans les flux réels

Les plateformes de paie et d’avantages reçoivent des numéros de routing bancaire des employés et doivent rejeter les neuvièmes chiffres mal saisis avant que le premier fichier de dépôt direct ne soit soumis à l’ODFI. Les équipes trésorerie et comptes fournisseurs valident chaque colonne de routing dans une exportation CSV de fournisseurs, mettent en quarantaine les lignes où valid est false, et évitent les lots ACH échoués qui coûtent retards et frais de reprise.

Les environnements sandbox et démo ont souvent besoin de numéros de routing synthétiques mais valides en somme de contrôle ; le mode compute transforme tout corps de huit chiffres en une chaîne de neuf qui passe les portes de format locales sans inventer une relation bancaire réelle. Ne traitez pas un contrôle ABA réussi comme preuve de compte ouvert, d’autorisation OFAC ou d’affectation actuelle de la Federal Reserve ; il prouve seulement que le chiffre trois-sept-un est cohérent avec la charge sous les poids standard.

Cas d’usage

Auditer les colonnes de routing dans les exports paie et fournisseurs

Validez par lots chaque RTN ABA à neuf chiffres dans un CSV et mettez en quarantaine les lignes dont le chiffre de contrôle ne correspond plus à la valeur attendue recalculée avant l’envoi ACH.

Questions fréquentes

Qu’est-ce que le chiffre de contrôle d’un numéro de routing ABA ?

C’est le neuvième chiffre d’un numéro de routing de transit bancaire américain (RTN), calculé avec la règle mod-10 pondérée 3-7-1 afin de capturer habituellement les erreurs d’un chiffre à la saisie ou au collage avant stockage ou envoi en ACH.

Que se passe-t-il avec une mauvaise longueur, des lettres ou des tirets ?

Les tâches de validation échouées ne sont pas facturées.

L’outil de chiffre de contrôle de routing ABA est-il gratuit ?

L’outil navigateur est gratuit et s’exécute en local.

Comment se calcule le chiffre de contrôle d'un routing ABA ?

Multipliez les huit chiffres, de gauche à droite, par les poids répétés trois, sept et un, puis additionnez les produits. Le chiffre de contrôle vaut dix moins le reste de cette somme divisée par dix ; un résultat de dix devient zéro.

Un validateur Luhn ou de code UPC convient-il à un numéro de routing ?

Non. Luhn, UPC et EAN utilisent d'autres poids et d'autres longueurs : leur verdict ne dit rien d'un numéro de routing, qui exige le cycle 3-7-1 sur exactement neuf chiffres.

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/enc/aba-routing

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/enc/aba-routing \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"02100002"}'

const res = await fetch("https://api.kit.forhosting.com/enc/aba-routing", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "number": "02100002"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/enc/aba-routing",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "number": "02100002"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/aba-routing", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"number":"02100002"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"number":"02100002"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/aba-routing", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "number": "02100002"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.aba_routing",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Les entrées non numériques et les mauvaises longueurs échouent avec invalid_input au lieu d’un nettoyage silencieux, afin que vous ne stockiez jamais un RTN à moitié nettoyé. La même arithmétique pure s’exécute gratuitement dans le navigateur et au prix API publié.

Contrat d’entrée, modes et comportement d’erreur

Envoyez un champ number ne contenant que les caractères de zéro à neuf. Une mauvaise longueur est une erreur explicite qui nomme le mode et la longueur envoyée—huit pour compute, neuf pour validate—afin que les formulaires affichent « il faut huit chiffres » sans deviner. Chaînes vides, number manquant et valeurs de mode invalides échouent avant toute somme pondérée et ne sont pas facturés. Préférez compute pour créer des RTN de test ou compléter des identifiants institutionnels partiels ; préférez validate pour filtrer la configuration ACH ou l’import sur un code complet de neuf chiffres venant d’un utilisateur ou d’un fichier partenaire. Espaces, tirets, lettres et points décimaux sont rejetés comme entrée non numérique avec invalid_input afin qu’une valeur silencieusement tronquée n’atteigne jamais le stockage. Le mode compute est le défaut : le moteur exige exactement huit chiffres, renvoie check_digit comme chaîne d’un caractère et with_check comme le numéro de routing à neuf chiffres que vous pouvez imprimer ou persister. Le mode validate exige exactement neuf chiffres ; la réponse indique valid true lorsque le chiffre final correspond à expected_check_digit recalculé, et inclut toujours payload (les huit premiers chiffres), check_digit, expected_check_digit, length neuf, algorithm aba-3-7-1 et weights 3-7-1. Des alias tels que digits, routing, rtn et code sont acceptés pour le même champ de charge, afin que les intégrations qui parlent déjà de « routing » n’aient pas besoin de renommer. Comme le chemin est purement parse sans horloge, source aléatoire ni réseau, le même corps JSON produit toujours le même résultat JSON sur l’outil gratuit du navigateur et sur l’API à $0.002 par requête réussie.

Où les chiffres de contrôle ABA s’insèrent dans les flux réels

Les formulaires d’onboarding fintech recalculent expected_check_digit et affichent une correction amicale lorsqu’un client colle un RTN de neuf chiffres avec une seule transposition.

Cas d'intégration

Compléter un corps de 8 chiffres en RTN de neuf

Appelez le mode compute avec la charge de huit chiffres, stockez with_check et utilisez le numéro de routing ABA à neuf chiffres dans des formulaires ACH, fixtures de test ou modèles d’étiquette.

Valider les routing saisis ou collés à l’entrée

Lorsqu’un formulaire ou un fichier partenaire envoie neuf chiffres, appelez le mode validate et bloquez l’enregistrement si valid est false, en montrant expected_check_digit pour corriger une seule faute de frappe.

Questions techniques

Comment calculer un chiffre de contrôle de routing ABA avec cette API ?

Faites un POST avec number de exactement huit chiffres et mode compute (ou omettez mode). La réponse inclut check_digit et with_check (le routing complet à neuf chiffres).

Comment valider un numéro de routing ABA complet à neuf chiffres ?

Faites un POST avec la chaîne de neuf chiffres et mode validate. La réponse inclut valid, check_digit, expected_check_digit et payload (chiffres sans le dernier).

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Comment le chiffre de contrôle de routing ABA est calculé

Où les chiffres de contrôle ABA s’insèrent dans les flux réels

Cas d’usage

Auditer les colonnes de routing dans les exports paie et fournisseurs

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Erreurs

Notes techniques

Contrat d’entrée, modes et comportement d’erreur

Où les chiffres de contrôle ABA s’insèrent dans les flux réels

Cas d'intégration

Compléter un corps de 8 chiffres en RTN de neuf

Valider les routing saisis ou collés à l’entrée

Questions techniques

merci