ngx-iban-validator

IBAN Validator

IBAN Validator for your reactive Angular forms, comes without any dependencies and can be used even outside of Angular as standalone function in any JS project. It can perform format, digit and length IBAN validations. Currently supports 105 countries

Install

npm install ngx-iban-validator --save

Use as a form validator

Import validateIBAN function from ngx-iban-validator package into your component file. Add validateIBAN to your form validators array.

import { Component, OnInit } from "@angular/core";
import { FormBuilder, FormGroup, Validators } from "@angular/forms";

import { validateIBAN } from "ngx-iban-validator";

@Component({
  selector: "app-root",
  templateUrl: "./app.component.html",
  styleUrls: ["./app.component.scss"],
})
export class AppComponent implements OnInit {
  ibanForm: FormGroup;

  constructor(private formBuilder: FormBuilder) {}

  ngOnInit() {
    this.ibanForm = this.formBuilder.group({
      iban: ["", [Validators.required, validateIBAN]],
    });
  }
}

Display error

Validator is returning object as result of checks.

export interface IBANValidationResult {
  ibanInvalid: boolean;
  error: IBANError;
}

export interface IBANError {
  countryUnsupported: boolean;
  codeLengthInvalid: boolean;
  patternInvalid: boolean;
}

Error object contains more details about validation error. You can display errors easily as with any other validator.

<form [formGroup]="ibanForm">
  <input type="text" formControlName="iban" />
  <small
    *ngIf="ibanForm.get('iban').errors && ibanForm.get('iban').errors.ibanInvalid"
  >
    <span *ngIf="ibanForm.get('iban').errors.error.countryUnsupported">
      Country not supported
    </span>
    <span *ngIf="ibanForm.get('iban').errors.error.codeLengthInvalid">
      IBAN Code length is invalid
    </span>
    <span *ngIf="ibanForm.get('iban').errors.error.patternInvalid">
      IBAN Code pattern is invalid
    </span>
  </small>
</form>

Use as standalone function

You can use validateIBAN function independently from any forms. Function will check IBAN and return object { ibanInvalid: boolean }

const ibanIsInvalid = validateIBAN({
  value: "AL35202111090000000001234567",
}).ibanInvalid;

NodeJS

const ibanValidator = require("ngx-iban-validator");
const ibanIsInvalid = ibanValidator.validateIBAN({
  value: "BA393385804800211234",
}).ibanInvalid;

Supported countries

Country	Country Code	Length
Albania	AL	28
Algeria	DZ	26
Andorra	AD	24
Angola	AO	25
Austria	AT	20
Azerbaijan	AZ	28
Bahrain	BH	22
Belarus	BY	28
Belgium	BE	16
Benin	BJ	28
Bosnia and Herzegovina	BA	20
Brazil	BR	29
Bulgaria	BG	22
Burundi	BI	16
Burkina Faso	BF	28
Cameroon	CM	27
Cape Verde	CV	25
Central African Republic	CF	27
Chad	TD	27
Comoros	KM	27
Congo	CG	27
Costa Rica	CR	22
Croatia	HR	21
Cyprus	CY	28
Czech Republic	CZ	24
Denmark	DK	18
Dominican Republic	DO	28
Egypt	EG	29
El Salvador	SV	28
Equatorial Guinea	GQ	27
Estonia	EE	20
Faroe Islands	FO	18
Finland	FI	18
France	FR	27
Gabon	GA	27
Georgia	GE	22
Germany	DE	22
Gibraltar	GI	23
Greece	GR	27
Greenland	GL	18
Guatemala	GT	28
Guinea-Bissau	GW	25
Vatican	VA	22
Honduras	HN	28
Hungary	HU	28
Iceland	IS	26
Iran	IR	26
Iraq	IQ	23
Ireland	IE	22
Israel	IL	23
Italy	IT	27
Ivory Coast	CI	28
Jordan	JO	30
Kazakhstan	KZ	20
Kosovo	XK	20
Kuwait	KW	30
Latvia	LV	21
Lebanon	LB	28
Libya	LY	25
Liechtenstein	LI	21
Lithuania	LT	20
Luxembourg	LU	20
Madagascar	MG	27
Mali	ML	28
Malta	MT	31
Mauritania	MR	27
Mauritius	MU	30
Moldova	MD	24
Monaco	MC	27
Mongolia	MN	20
Montenegro	ME	22
Morocco	MA	28
Mozambique	MZ	25
Netherlands	NL	18
Nicaragua	NI	32
Niger	NE	28
North Macedonia	MK	19
Norway	NO	15
Pakistan	PK	24
Palestine	PS	29
Poland	PL	28
Portugal	PT	25
Qatar	QA	29
Romania	RO	24
Russia	RU	33
Saint Lucia	LC	32
San Marino	SM	27
Sao Tome and Principe	ST	25
Saudi Arabia	SA	24
Senegal	SN	28
Serbia	RS	22
Seychelles	SC	31
Slovak Republic	SK	24
Slovenia	SI	19
Spain	ES	24
Sudan	SD	18
Sweden	SE	24
Switzerland	CH	21
Timor-Leste	TL	23
Togo	TG	28
Tunisia	TN	24
Turkey	TR	26
Ukraine	UA	29
United Arab Emirates	AE	23
United Kingdom	GB	22
Virgin Islands, British	VG	24

Development

Install dependencies

npm i

Test

npm run test

Build

npx tsc

v 1.1.5

Added additional pattern validation Added more tests to improve test coverage Added support for new countries: Algeria, Angola, Benin, Burkina Faso, Burundi, Cameroon, Cape Verde, Central African Republic, Chad, Comoros, Congo, Equatorial Guinea, Gabon, Guinea-Bissau, Honduras, Iran, Ivory Coast, Madagascar, Mali, Mongolia, Morocco, Mozambique, Nicaragua, Niger, Russia, Senegal, Togo

v 1.1.4

Avoid Angular warnings for old CommonJS module usage (see https://angular.io/guide/build#configuring-commonjs-dependencies)

Replaced mocha and chai with JEST for tests

v 1.1.3

Added support for new countries: Vatican, Libya, Sao Tome and Principe, Sudan Updated length for LC Saint Lucia from 30 to 32

Added Tests Added Mocha and Chai for testing

v 1.1.2

Updated length for CR to 22 - @freddy36

Read more

IBAN Examples