Iranian Bank

Normalize card and Shaba values, validate their checksums, and identify the issuing Iranian bank from a card prefix or IBAN bank code.

Last updated August 12, 2026

Overview

Installation

$ npx shadcn@latest add https://ui.persian-labs.ir/r/iranian-bank.json

Usage

import {
  formatCardNumber,
  getIranianBankByCardNumber,
  validateIranianCard,
} from "@/lib/iranian-bank"
 
formatCardNumber("6219861918949297") // "6219 8619 1894 9297"
getIranianBankByCardNumber("62198619")?.name // "بلوبانک"
validateIranianCard("6219861918949297") // true

API Reference

iranian-bank

Prop	Type	Default	Description
iranianBanks	IranianBank[]	—	The supported banks, each with an id, Persian name, card prefixes, and IBAN bank codes.
normalizeCardNumber(value)	string \| number \| null \| undefined → string	—	Converts Persian/Arabic numerals, removes non-digits, and returns at most 16 card digits.
formatCardNumber(value, separator?)	value, string → string	separator = "-"	Normalizes a card value and groups it in four-digit blocks for display.
normalizeShaba(value)	string \| null \| undefined → string	—	Removes an optional IR prefix and separators, then returns the 24-digit Shaba account portion.
formatShaba(value, separator?)	value, string → string	separator = " "	Normalizes a Shaba value and groups its account portion in four-digit blocks.
getIranianBankByCardNumber(value)	card value → IranianBank \| undefined	—	Matches the entered card prefix and returns its bank when recognized.
getIranianBankByShaba(value)	Shaba value → IranianBank \| undefined	—	Reads the IBAN bank code from a Shaba value and returns its bank when recognized.
validateIranianCard(value)	card value → boolean	—	Returns true only for a complete 16-digit card number with a valid checksum.
validateIranianShaba(value)	Shaba value → boolean	—	Returns true only for a complete IR Shaba number that passes the IBAN mod-97 check.

Edit this page on GitHub

PreviousWheel Picker NextHitbox