@alibaba-aero/griphook

Griphook

Griphook is a tool to validate and visualize Iranian bank information.

It can validate IBANs and PANs, find issuer bank and more while caching the results.

Griphook was a goblin who worked at Gringotts Wizarding Bank in Diagon Alley.

Methods

PAN

validatePAN(value)

Will check if value is a valid PAN or not (returns a boolean).

import { validatePAN } from 'griphook';

console.log(validatePAN('6219861032799560')); // true

visualizePAN(value, options)

Will format a PAN (Returns a String).

import { visualizePAN } from 'griphook';

console.log(visualizePAN('6219861032799560')); // '6219-8610-3279-9560'

you can pass an optional object to this method:

option	type	default value	description
spacerChar	String	'-'	a character to use as spacer between each 4 digits
censor	Boolean	false	whether should censor a part of PAN or not
censorChar	String	'*'	a character to use as replacement of real digits
censorLength	Number	4	number of censored digits (will censor from center)

findBankByPAN(value)

Will Find Bank Info With PAN IIN+ (Returns an Object)

import { findBankByPAN } from 'griphook';

console.log(findBankByPAN('6219861032799560'));
// {
//    "name": "saman",
//    "name_farsi": "سامان",
//    "icon": "Saman.svg",
//    "iban_nbc": "056",
//    "pan_iin": [ "621986" ]
// }

You should download icons from here and host them locally (for now).

IBAN

validateIBAN(value)

Will check if value is a valid IBAN or not (returns a boolean).

import { validateIBAN } from 'griphook';

console.log(validateIBAN('IR410560090180001896622001')); // true

visualizeIBAN(value, options)

Will format a IBAN (Returns a String).

import { visualizeIBAN } from 'griphook';

console.log(visualizeIBAN('IR410560090180001896622001')); // 'IR41-0560-0901-8000-1896-6220-01'

you can pass an optional object to this method:

option	type	default value	description
spacerChar	String	'-'	a character to use as spacer between each 4 digits

findBankByIBAN(value)

Will Find Bank Info With IBAN NBC+ (Returns an Object)

import { findBankByIBAN } from 'griphook';

console.log(findBankByIBAN('IR410560090180001896622001'));
// {
//    "name": "saman",
//    "name_farsi": "سامان",
//    "icon": "Saman.svg",
//    "iban_nbc": "056",
//    "pan_iin": [ "621986" ]
// }

You should download icons from here and host them locally (for now).

Other

findBankByName(value)

Will Find Bank Info With Their English Name (Returns an Object). English Name Must Be Lower Case.

import { findBankByName } from 'griphook';

console.log(findBankByName('saman'));
// {
//    "name": "saman",
//    "name_farsi": "سامان",
//    "icon": "Saman.svg",
//    "iban_nbc": "056",
//    "pan_iin": [ "621986" ]
// }

findBankByFarsiName(value)

Will Find Bank Info With Their Farsi Name (Returns an Object).

import { findBankByFarsiName } from 'griphook';

console.log(findBankByFarsiName('سامان'));
// {
//    "name": "saman",
//    "name_farsi": "سامان",
//    "icon": "Saman.svg",
//    "iban_nbc": "056",
//    "pan_iin": [ "621986" ]
// }

You should download icons from here and host them locally (for now).