IBANのMOD 97チェックサムが確認する内容
IBANは2文字の国コード、2桁のチェックデジット、国ごとに定められたBBANで構成されます。MOD 97は文字列とチェックデジットの数学的な関係を確かめる処理です。銀行や決済ネットワークに問い合わせる処理ではありません。
入力文字の構文、登録された国別の長さとBBANの文字パターン、チェックサムは別々に検証します。Swiftは国別形式をまとめたISO 13616 IBANレジストリを公開しています。ISO/IEC 7064は、入力や転記で起きやすい誤りを見つけるチェック文字方式を説明する規格です。チェックサムだけから国別形式の正しさを推測しないでください。
| 検証層 | 確認すること | 失敗の例 |
|---|---|---|
| 入力構文 | 文字と空白の使い方は許可されているか | スラッシュ、句読点、未対応の記号が含まれる。 |
| 国別形式 | その国の長さとBBANパターンに合っているか | 国コードに対して全体の桁数が異なる。 |
| MOD 97チェックサム | 文字がチェックデジットの関係を満たすか | 1文字変わると余りが1ではなくなる。 |
| 銀行・決済の確認 | 口座が存在し、支払いを受け取れるか | MOD 97では確認できず、銀行または認可サービスが必要。 |
IBAN MOD 97チェックサムの計算手順4段階
電子入力用のIBANを使います。印刷用の表示にある許可済みの空白を取り除き、ASCIIの小文字を大文字にします。それ以外の記号は黙って消さず、入力エラーとして扱います。次に先頭4文字を末尾へ移し、AからZを10から35の数字に置き換えます。もとの数字はそのまま残します。
展開した数字を左から1桁ずつ処理します。余りを0から始め、各桁について余り = (余り × 10 + 桁) mod 97 と更新します。途中の値は常に0から96に収まるため、大きな整数を作る必要はありません。最後の余りが1ならチェックサムの関係を満たします。
- 入力を正規化許可された空白を除き、ASCIIの英字を大文字にして、対応外の文字を拒否します。
- 先頭を移動IBANの先頭4文字を文字列の末尾に移します。
- 英字を展開A〜Zを10〜35に置き換え、10進数字は変更しません。
- 97で逐次計算数字ごとに余りを更新し、最後が1のときだけ整合と判定します。
計算例:GB82 WEST 1234 5698 7654 32を検証
これは計算を説明する例であり、口座照会ではありません。空白を除き、先頭4文字を末尾に移すとWEST12345698765432GB82になります。W=32、E=14、S=28、T=29、G=16、B=11として英字を展開すると、数字列は3214282912345698765432161182です。
表では数字列を複数のブロックに分けて処理します。次のブロックを前の余りに加えるときは、そのブロックの桁数に合わせます。全体を1個の巨大な整数として割る必要はありません。
- ブロック先頭のゼロは保持します。ブロックは計算用の文字列であり、数値化して正規化する口座番号ではありません。
- 最終余りは1です。ただし、この値が実在する銀行口座に割り当てられているとは証明できません。
| 計算箇所 | 処理する数字 | 余り |
|---|---|---|
| 最初のブロックの後 | 3214282912 | 23 |
| 次の10桁を追加 | 3456987654 | 58 |
| 最後の8桁を追加 | 32161182 | 1 |
| 最終結果 | 3214282912345698765432161182 mod 97 | チェックサム整合 |
BBANからIBANのチェックデジットを生成する
検証ではチェックデジットを含む完成済みIBANを使います。生成では国コードと、その国の登録形式に合ったBBANから始めます。チェックサムは利用すべき口座や銀行情報を教える計算ではありません。
生成用の一時文字列として、国コード、00、BBANを連結します。先頭4文字を末尾へ移し、英字を展開して余りrを97で計算します。チェックデジットは98 − rを2桁にした値です。国コードの後ろに挿入し、完成したIBANを通常の方法で再検証すると余りは1になります。例のGB BBAN WEST12345698765432では、一時値GB00...の余りは16です。したがって98 − 16 = 82となり、GB82WEST12345698765432が得られます。この計算はチェックデジットを作るだけで、銀行情報を検証しません。
- 正しいBBANを用意登録された国別形式に従う銀行コードと口座欄を取得します。
- 仮の数字を入れる国コード + 00 + BBANを作り、先頭の移動と英字の展開を行います。
- 2桁を計算余りを98から引き、必要なら先頭に0を付けます。
- 完成値を検証数字を挿入し、IBAN全体の余りが1になることを確認します。
大きな整数を使わないJavaScript実装
この関数が確認するのは基本的な構文とチェックサムです。本番の形式検証では、国ごとの最新の長さとBBANパターンも別途確認してください。
function ibanMod97Remainder(input) {
const iban = input.replace(/ /g, "").toUpperCase();
if (!/^[A-Z]{2}[0-9]{2}[A-Z0-9]+$/.test(iban)) {
throw new Error("IBANの構文が正しくありません");
}
let remainder = 0;
const rotated = iban.slice(4) + iban.slice(0, 4);
for (const character of rotated) {
const expanded = character >= "A" && character <= "Z"
? String(character.charCodeAt(0) - 55)
: character;
for (const digit of expanded) {
remainder = (remainder * 10 + Number(digit)) % 97;
}
}
return remainder;
}
ibanMod97Remainder("GB82 WEST 1234 5698 7654 32"); // 1
チェックサム不一致、構文エラー、国別形式エラーを別の結果として扱います。このコードは銀行口座を確認しません。
Pythonで余りを逐次計算
同じ余りの更新方法はPythonでも使えます。例ではIBANを文字列のまま扱い、国ごとの形式ルールは更新されるレジストリに委ねています。
import re
source = "GB82 WEST 1234 5698 7654 32"
iban = re.sub(r" ", "", source).upper()
if re.fullmatch(r"[A-Z]{2}[0-9]{2}[A-Z0-9]+", iban) is None:
raise ValueError("IBANの構文が正しくありません")
rotated = iban[4:] + iban[:4]
remainder = 0
for character in rotated:
expanded = str(ord(character) - 55) if "A" <= character <= "Z" else character
for digit in expanded:
remainder = (remainder * 10 + int(digit)) % 97
print(remainder) # 1
- 例の戻り値は1です。本番コードでは構文解析の失敗とチェックサム不一致を別々に報告します。
国別形式のデータを更新しても算術部分を独立してテストできるようにします。
IBANチェックサム実装のテストと境界条件
ラベル付きの計算例、形式不正な入力、合成データを使って算術とパーサーの両方をテストします。許可された表示用の空白を除く処理やASCII小文字の大文字化は選択できますが、任意の句読点を削除したり、似た文字を置き換えたり、不足文字を推測して補ったりしないでください。
- テストでは合成値を使い、診断ログの顧客銀行情報は伏せます。MOD 97は誤り検出であり、認証や支払い承認ではありません。
| テスト | 期待する動作 | 対象 |
|---|---|---|
| 既知の整合する例 | 余り1 | チェックサム |
| 1文字を変更 | 余りが1以外と報告 | チェックサム |
| 数字項目の先頭ゼロ | ゼロを保持 | パーサーとチェックサム |
| 長さの誤りまたは未対応の句読点 | 形式または構文エラーを報告 | 入力検証 |
IBAN MOD 97の合格で証明できないこと
余りが1なら、文字がチェックサムの数学的な関係を満たすことだけが分かります。銀行がIBANを発行したこと、口座が有効なこと、入力者が名義人であること、支払いを受け取れることは証明できません。
本番の処理には、最新の国別レジストリ、受取人への確認、認可された口座確認サービスが必要な場合があります。「形式一致」「チェックサム合格」「銀行情報未確認」のように状態を分けてください。実際の送金には銀行が提供したIBANを使い、合格させるために数字を変更しないでください。
IBAN MOD 97チェックサムのよくある質問
MOD 97は銀行口座を確認する仕組みですか?
いいえ。IBANの文字列が数学的に整合するかを確認します。銀行への問い合わせは行わず、口座の発行、状態、名義、受取人の本人性、支払い可能性も確認しません。
チェックサムが整合するIBANの余りはいくつですか?
先頭4文字を移動し、英字を展開した後の最終余りは1です。国別の長さとBBAN形式は別に検証します。
BBANからIBANのチェックデジットをどう計算しますか?
国コード + 00 + BBANを作り、先頭4文字を移動して英字を展開し、余りを計算します。98から余りを引いて2桁に整え、挿入後にIBAN全体を再検証します。
すべての国別形式にこのアルゴリズムを使えますか?
国際チェックサムの手順は共通ですが、長さとBBAN構造は国ごとに異なります。完全な形式を判定する前に、Swiftが公開するIBANレジストリなどの最新情報を確認してください。
実装チェックリスト
許可された入力だけを正規化し、国別形式を検証してから文字を移動・展開し、MOD 97を逐次計算します。最終余りが1の場合のみチェックサム整合とします。
実際の文字列を調べるにはIBAN検証ツールを、BBANから数字を生成するにはIBAN計算ツールを使えます。どちらも銀行の確認を代替しません。
規格と形式の参考資料
- SwiftのIBANレジストリと国際銀行口座番号 — Swiftは各国のIBAN形式仕様をまとめたISO 13616レジストリを公開しています。
- ISO/IEC 7064:2003 チェック文字システム — 公式ページでは、転記や入力の誤りを検出するチェック文字方式が説明されています。