@biza-ai/saudi-iban

Zero-dependency universal TypeScript utility for Saudi Arabian IBAN validation, formatting, and bank identification under SAMA (Saudi Central Bank) standards.

Works seamlessly across Browser, Node.js, Deno, Bun, and Edge Workers (Cloudflare, Vercel, Supabase).

Maintained with ❤️ by BIZA App — The AI ERP & Cloud Accounting platform for Saudi Arabia & GCC.

---

Features

• ⚡ Zero Dependencies: Pure TypeScript implementation under 8 KB.
• 🛡️ Mathematical MOD-97 Checksum: Full ISO 7064 Mod 97-10 verification.
• 🏦 Complete SAMA Bank Registry: Identifies all 24+ Saudi commercial banks, digital banks (D360, Vision, STC Bank), and licensed foreign branches with Arabic & English names, short names, and SWIFT/BIC codes.
• 🧹 Robust Sanitization: Automatically cleans whitespace, hyphens, and standardizes letter casing.
• 📦 Dual ESM & CommonJS: Native tree-shakeable imports.

---

Installation

npm install @biza-ai/saudi-iban

Or using pnpm / yarn / bun:

pnpm add @biza-ai/saudi-iban
bun add @biza-ai/saudi-iban

---

Quick Usage

1. Validate a Saudi IBAN

import { validateSaudiIban } from '@biza-ai/saudi-iban'

const result = validateSaudiIban('SA0380000000608010167519')

if (result.isValid) {
  console.log(result.bank?.nameEn)       // 'Al Rajhi Bank'
  console.log(result.bank?.nameAr)       // 'مصرف الراجحي'
  console.log(result.bank?.bic)          // 'RJHISARI'
  console.log(result.formatted)          // 'SA03 8000 0000 6080 1016 7519'
  console.log(result.accountNumber)      // '000000608010167519'
} else {
  console.error(result.error)            // E.g. 'Invalid checksum: IBAN failed MOD-97 mathematical validation.'
}

2. Identify Bank from IBAN

import { getBankFromIban } from '@biza-ai/saudi-iban'

const bank = getBankFromIban('SA9210000000000000000000')

console.log(bank)
// {
//   code: '10',
//   nameEn: 'Saudi National Bank (SNB)',
//   nameAr: 'البنك الأهلي السعودي',
//   shortName: 'SNB',
//   bic: 'NCBKSARI'
// }

3. Format IBAN for Display

import { formatIban } from '@biza-ai/saudi-iban'

formatIban('sa0380000000608010167519')
// Output: 'SA03 8000 0000 6080 1016 7519'

---

Supported Banks in SAMA Registry

Code	Bank Name (English)	اسم البنك (العربية)	BIC / SWIFT
80	Al Rajhi Bank	مصرف الراجحي	RJHISARI
10	Saudi National Bank (SNB)	البنك الأهلي السعودي	NCBKSARI
45	Saudi Awwal Bank (SAB)	البنك السعودي الأول	SABBRI
20	Riyad Bank	بنك الرياض	RIBLSARI
05	Alinma Bank	مصرف الإنماء	INMASARI
50	Banque Saudi Fransi (BSF)	البنك السعودي الفرنسي	BSFRSARI
40	Arab National Bank (ANB)	البنك العربي الوطني	ARNBSARI
15	Bank AlJazira	بنك الجزيرة	BJAZSARI
60	Bank AlBilad	بنك البلاد	ALBISARI
65	The Saudi Investment Bank (SAIB)	البنك السعودي للاستثمار	SIBCSARI
75	STC Bank	بنك إس تي سي	STCBSARI
76	D360 Bank	بنك د360 الرقمي	DTHRSARI
78	Vision Bank	بنك فيجن الرقمي	VISNSARI
55	Emirates NBD	بنك الإمارات دبي الوطني	EBILSARI
66	Gulf International Bank (GIB / meem)	بنك الخليج الدولي (ميم)	GULFSARI
58	First Abu Dhabi Bank (FAB)	بنك أبوظبي الأول	FABISARI
82	Deutsche Bank	دويتشه بنك	DEUTSARI
83	BNP Paribas	بي إن بي باريبا	BNPASARI
84	J.P. Morgan Chase Bank	جي بي مورغان تشيس بنك	CHASSARI
86	Industrial and Commercial Bank of China	البنك الصناعي والتجاري الصيني	ICBKSARI

---

Looking for Complete Payroll & ERP Automation in Saudi Arabia?

Stop worrying about bank transfer errors and SAMA compliance.

BIZA App (biza.app) provides:

• Instant Bank Reconciliation: Match statements against invoices and payments automatically.
• WPS Wages Protection System (مدد): Generates compliant SIF payroll files for all Saudi commercial banks.
• ZATCA Phase 2 E-Invoicing: Full clearance and reporting with live cryptographic validation.
• Multi-Currency & VAT 15% Accounting: Fully bilingual enterprise ERP.

Visit https://biza.app to get started.

---

License

MIT © BIZA App