razorpay / ifsc
Razorpay IFSC Codes Library
Installs: 179 457
Dependents: 0
Suggesters: 0
Security: 0
Stars: 338
Watchers: 196
Forks: 129
Open Issues: 60
Language:HTML
Requires
- php: ^7.1|^8.0
- php-http/client-implementation: ^1.0
- php-http/discovery: ^1.14
- php-http/message-factory: ^1.0
- psr/http-message: ^1.0
Requires (Dev)
- guzzlehttp/psr7: ^2.0
- php-http/message: ^1.11
- php-http/mock-client: ^1.4
- phpunit/phpunit: ^9.0
- symfony/yaml: ^5.0
- dev-master
- v2.0.34
- v2.0.33
- v2.0.32
- v2.0.31
- v2.0.30
- v2.0.29
- v2.0.28
- v2.0.27
- v2.0.26
- v2.0.25
- v2.0.24
- v2.0.23
- v2.0.22
- v2.0.21
- v2.0.20
- v2.0.19
- v2.0.18
- v2.0.17
- v2.0.16
- v2.0.14
- v2.0.13
- v2.0.12
- v2.0.11
- v2.0.10
- v2.0.9
- v2.0.8
- v2.0.7
- v2.0.6
- v2.0.5
- v2.0.4
- v2.0.3
- v2.0.2
- v2.0.1
- v2.0.0
- v2.0.0-beta
- v2.0.0-alpha2
- v2.0.0-alpha
- 1.6.1
- 1.6.0
- 1.5.13
- 1.5.12
- 1.5.11
- 1.5.10
- 1.5.9
- 1.5.8
- 1.5.7
- 1.5.6
- 1.5.5
- 1.5.4
- 1.5.3
- 1.5.2
- 1.5.1
- 1.5.0
- 1.4.10
- 1.4.9
- 1.4.8
- 1.4.7
- 1.4.6
- 1.4.5
- 1.4.4
- 1.4.3
- 1.4.2
- 1.4.1
- 1.4.0
- 1.3.4
- 1.3.3
- 1.3.2
- 1.3.1
- 1.3.0
- 1.2.3
- 1.2.2
- 1.2.1
- 1.2.0
- 1.1.8
- 1.1.7
- 1.1.6
- 1.1.5
- 1.1.4
- 1.1.3
- 1.1.2
- 1.1.1
- 1.1.0
- 1.0.15
- 1.0.14
- 1.0.13
- 1.0.12
- 1.0.11
- 1.0.10
- 1.0.9
- 1.0.8
- 1.0.7
- 1.0.6
- 1.0.5
- 1.0.4
- 1.0.3
- 1.0.2
- 1.0.1
- 1.0.0
- 0.2.12
- 0.2.11
- 0.2.10
- 0.2.9
- 0.2.8
- 0.2.7
- 0.2.6
- 0.2.5
- 0.2.4
- 0.2.3
- 0.2.2
- 0.2.1
- 0.2.0
- 0.1.8
- 0.1.7
- 0.1.6
- 0.1.5
- 0.1.4
- 0.1.3
- 0.1.2
- 0.1.1
- 0.1.0
- dev-release/2.0.34
- dev-Release/2.0.33
- dev-Release/2.0.32
- dev-IFSC-XNSE-manually-adding
- dev-release/2.0.31
- dev-release/2.0.30
- dev-release/2.0.29
- dev-test_1
- dev-release/2.0.28
- dev-release/2.0.27
- dev-release/2.0.26
- dev-release/2.0.25
- dev-release/2.0.24
- dev-release/2.0.23
- dev-release/2.0.22
- dev-release/2.0.21
- dev-security_akto_integration_1699636023
- dev-release/2.0.20
- dev-release/2.0.19
- dev-release/2.0.18
- dev-release/2.0.17
- dev-dependabot/bundler/scraper/nokogiri-1.15.4
- dev-release/2.0.16
- dev-release/2.0.15
- dev-documentation
- dev-release/2.0.14
- dev-release/2.0.13
- dev-dependabot/go_modules/github.com/stretchr/testify-1.8.4
- dev-dependabot/composer/psr/http-message-tw-1.0or-tw-2.0
- dev-release/2.0.12
- dev-fixing_script_failure
- dev-dummy_20feb
- dev-changes-in-pull_request_template
- dev-dependabot/bundler/scraper/httparty-0.21.0
- dev-district_cleaner
- dev-shivamrazorpay-patch-1
- dev-release/2.0.11
- dev-update_readme
- dev-refactor_ifsc
- dev-sublet-improvements
- dev-release/2.0.10
- dev-bank_name_const
- dev-test-onboarding
- dev-semgrep
- dev-sonarCoverage
- dev-release/2.0.2
- dev-release/2.0.1
- dev-release/1.6.1
- dev-zeroes-in-ifsc
- dev-add-new-ifscs
- dev-adding_ausf
- dev-release/1.5.8
- dev-updates
- dev-release/1.5.2
- dev-release/1.5.1
- dev-elixir-tests
- dev-nbin-possible-changes
- dev-fix-datatype-string
- dev-regex
This package is auto-updated.
Last update: 2024-09-23 12:37:01 UTC
README
This is part of the IFSC toolset released by Razorpay. You can find more details about the entire release at ifsc.razorpay.com.
Dataset
If you are just looking for the dataset, go to the releases section and download the latest release.
The latest scraper
workflow on GitHub should publish a release-artifact
as well.
Source
Various official sources are linked below, with the ones currently used marked with a †
- List of NEFT IFSCs from RBI website†
- List of RTGS IFSCs from RBI website†
- RBI maintains several lists:
- List of banks in India
- Websites of banks in India.
- Bankwise Volumes in ECS/NEFT/RTGS/Mobile
- List of Banks permitted to provide Mobile Banking
- NPCI website has several lists:
SWIFT
SWIFT/BIC codes are supported for a few banks.
SBI
- https://sbi.co.in/web/nri/quick-links/swift-codes †
- https://sbi.co.in/documents/16012/263663/sbinri_merged_bran_swfcodet.xlsx †
- Branch codes from above are checked against the SBI Branch Locator to get the IFSC.
PNB
- https://pnbindia.com/downloadprocess.aspx?fid=Zb7ImdUNlz9Ge73qn1nXQg== †
- https://www.pnbindia.in/document/PNB-helpdesk/bic_code.pdf †
HDFC
Installation
Ruby
Add this line to your application's Gemfile:
gem "ifsc"
And then execute:
$ bundle
Or install it yourself as:
$ gem install ifsc
Inside of your Ruby program do:
require "ifsc"
...to pull it in as a dependency.
PHP
composer require php-http/curl-client razorpay/ifsc
The PHP package has a dependency on the virtual package php-http/client-implementation
which requires you to install an adapter, but we do not care which one. That is an implementation detail in your application. You do not have to use the php-http/curl-client
if you do not want to. You may use the php-http/guzzle6-adapter
. Read more about the virtual packages, why this is a good idea and about the flexibility it brings at the HTTPlug docs. You can find a list of suported providers on packagist.
The minimum PHP version supported is 7.3. The package can be installed on PHP>=7.1 however.
Node.js
$ npm install ifsc
Go
This package is compatible with modern Go releases in module mode, with Go installed:
go get github.com/razorpay/ifsc/v2
will resolve and add the package to the current development module, along with its dependencies.
Alternatively the same can be achieved if you use import in a package:
import "github.com/razorpay/ifsc/v2/src/go"
and run go get without parameters.
Finally, to use the top-of-trunk version of this repo, use the following command:
go get github.com/razorpay/ifsc/v2@master
Support Matrix
Only the latest version of each SDK is considered.
API Documentation
This repository also hosts the source code for 5 modules: PHP/Node.js/Ruby/Go as of now. The API is documented below:
PHP
<?php use Razorpay\IFSC\Bank; use Razorpay\IFSC\IFSC; use Razorpay\IFSC\Client; IFSC::validate('KKBK0000261'); // Returns true IFSC::validate('BOTM0XEEMRA'); // Returns false IFSC::validateBankCode('PUNB'); // Returns true IFSC::validateBankCode('ABCD'); // Returns false IFSC::getBankName('PUNB'); // Returns 'Punjab National Bank' IFSC::getBankName('ABCD'); // Returns null IFSC::getBankName(Bank::PUNB); //Returns Punjab National Bank Bank::getDetails(Bank::PUNB); Bank::getDetails('PUNB'); // Returns an array: // [ // 'code' => 'PUNB', // 'type' => 'PSB', // 'ifsc' => 'PUNB0244200', // 'micr' => '110024001', // 'iin' => '508568', // 'apbs' => true, // 'ach_credit' => true, // 'ach_debit' => true, // 'nach_debit' => true, // 'name' => 'Punjab National Bank', // 'bank_code' => '024', // 'upi' => true // ] $client = new Client(); $res = $client->lookupIFSC('KKBK0000261'); echo $res->bank; // 'KOTAK MAHINDRA BANK LIMITED' echo $res->branch; // 'GURGAON' echo $res->address; // 'KOTAK MAHINDRA BANK LTD. UNIT NO. 8&9, SEWA CORPORATE PARK, MG ROAD, REVENUE STATE OF SARHAUL TEHSIL, DISTT,- GURGAON- 122001' echo $res->contact; // '4131000' echo $res->city; // 'GURGAON' echo $res->district; // 'GURGAON' echo $res->state; // 'HARYANA' echo $res->centre; // 'GURGAON' echo $res->getBankCode(); // KKBK echo $res->getBankName(); // 'Kotak Mahindra Bank' echo $res->micr; // '110485003' // Boolean fields: $res->upi, $res->rtgs, $res->neft, res->imps // You will get a SWIFT code where possible: echo $client->lookupIFSC('https://ifsc.razorpay.com/HDFC0CAGSBK')->swift; // 'HDFCINBB' // lookupIFSC may throw `Razorpay\IFSC\Exception\ServerError` // in case of server not responding in time // or Razorpay\IFSC\Exception\InvalidCode in case // the IFSC code is invalid
Node.js
var ifsc = require('ifsc'); ifsc.validate('KKBK0000261'); // returns true ifsc.validate('BOTM0XEEMRA'); // returns false ifsc.fetchDetails('KKBK0000261').then(function(res) { console.log(res); // { // MICR: '560226263', // BRANCH: 'THE AGS EMPLOYEES COOP BANK LTD', // ADDRESS: 'SANGMESH BIRADAR BANGALORE', // STATE: 'KARNATAKA', // CONTACT: '+91802265658', // UPI: true, // RTGS: true, // CITY: 'BANGALORE', // CENTRE: 'BANGALORE URBAN', // DISTRICT: 'BANGALORE URBAN', // NEFT: true, // IMPS: true, // SWIFT: 'HDFCINBB', // BANK: 'HDFC Bank', // BANKCODE: 'HDFC', // IFSC: 'HDFC0CAGSBK' // } }); console.log(ifsc.bank.PUNB); // prints PUNB // Prints the entire JSON from https://ifsc.razorpay.com/KKBK0000261 // res is an object, not string
Ruby
Make sure you have require 'ifsc'
in your code.
Validating a code offline. (Remember to keep the gem up to date!)
# valid? Razorpay::IFSC::IFSC.valid? 'KKBK0000261' # => true Razorpay::IFSC::IFSC.valid? 'BOTM0XEEMRA' # => false # validate! Razorpay::IFSC::IFSC.validate! 'KKBK0000261' # => true Razorpay::IFSC::IFSC.validate! 'BOTM0XEEMRA' # => Razorpay::IFSC::InvalidCodeError # bank_name_for(code) gets you the bank name offline Razorpay::IFSC::IFSC.bank_name_for 'PUNB0026200' -> "Punjab National Bank" Razorpay::IFSC::IFSC.bank_name_for 'KSCB0006001' -> "Tumkur District Central Bank" # get_details gets you the bank details from `banks.json` Razorpay::IFSC::Bank.get_details 'PUNB' { code: 'PUNB', type: 'PSB', ifsc: 'PUNB0244200', micr: '110024001', bank_code: '024', iin: '508568', apbs: true, ach_credit: true, ach_debit: true, nach_debit: true } # constants Razorpay::IFSC::Bank::PUNB 'PUNB'
Validate online and retrieve details from the server
If you call code.valid?
before calling code.get
, the validation will be performed offline.
# 1. using find code = Razorpay::IFSC::IFSC.find 'KKBK0000261' # 2. using new(...).get code = Razorpay::IFSC::IFSC.new 'KKBK0000261' code.get # result code.valid? # => true code.bank # => "Kotak Mahindra Bank" code.branch # => "GURGAON" code.address # => "KOTAK MAHINDRA BANK LTD. UNIT NO. 8&9, SEWA CORPORATE PARK, MG ROAD, REVENUE STATE OF SARHAUL TEHSIL, DISTT,- GURGAON- 122001" code.contact # => "4131000" code.city # => "GURGAON" code.district # => "GURGAON" code.state # => "HARYANA" code.centre # => GURGAON code.neft # => true code.upi # => true code.imps # => true code.rtgs # => true code.swift # => ""
Sublet Branches
You can use the code.bank_name
method to get the bank name considering sublet branches.
code = Razorpay::IFSC::IFSC.find 'HDFC0CKUB01' code.bank_name "Khamgaon Urban Co-operative Bank"
This works offline, and doesn't need a network call. This information is stored across 2 files:
src/sublet.json
- Autogenerated from the NPCI websitesrc/custom-sublets.json
- Maintained manually. Coverage is not 100%. PRs are welcome.
Sublet (or Sub-Member) branches are IFSC codes belonging to a large bank, but leased out to
smaller banks. In some cases, entire ranges are given to a specific bank.
For eg, all IFSCs starting with YESB0TSS
belong to Satara Shakari Bank
. These are
maintained manually in custom-sublets.json
.
Error handling
# all these `Razorpay::IFSC::InvalidCodeError` for an invalid code Razorpay::IFSC::IFSC.validate! '...' Razorpay::IFSC::IFSC.find '...' code = Razorpay::IFSC::IFSC.new '...'; code.get # these raise `Razorpay::IFSC::ServerError` if there is an error # communicating with the server Razorpay::IFSC::IFSC.find '...' code = Razorpay::IFSC::IFSC.new '...'; code.get
Go
package main import ( ifsc "github.com/razorpay/ifsc/v2/src/go" ) // todo: change funcs not required to lower case. func main() { ifsc.Validate("KKBK0000261") // Returns true ifsc.Validate("BOTM0XEEMRA") // Returns false ifsc.ValidateBankCode("PUNB") // Returns true ifsc.ValidateBankCode("ABCD") // Returns false ifsc.GetBankName("PUNB") // Returns "Punjab National Bank", nil ifsc.GetBankName("ABCD") // Returns "", errors.New(invalid bank code) ifsc.GetBankName(ifsc.HDFC) // Returns "HDFC Bank", nil ifsc.GetBankDetails("PUNB") // or ifsc.GetBankDetails(ifsc.PUNB) /* Returns (*ifsc.Bank){ Name : "Punjab National Bank", BankCode : "024", Code : "PUNB", Type : "PSB", IFSC : "PUNB0244200", MICR : "110024001", IIN : "508568", APBS : true, AchCredit : true, AchDebit : true, NachDebit : true, Upi : true }), nil */ ifsc.LookUP("KKBK0000261") /* Returns (*ifsc.IFSCResponse)({ Bank : "Kotak Mahindra Bank", Branch : "GURGAON", Address : "KOTAK MAHINDRA BANK LTD. UNIT NO. 8&9, SEWA CORPORATE PARK, MG ROAD, REVENUE STATE OF SARHAUL TEHSIL, DISTT,- GURGAON- 122001", Contact : "4131000", City : "GURGAON", District : "GURGAON", State : "HARYANA", IFSC : "KKBK0000261", BankCode : "KKBK" }), nil */ }
Code Notes
Both the packages ship with a 300kb JSON file, that includes the entire list of IFSC codes, in a compressed, but human-readable format.
The Bank Code and Names list is maintained manually, but verified with tests to be accurate as per the latest RBI publications. This lets us add older Bank codes to the name list, without worrying about them getting deleted in newer builds.
API Development
The IFSC API is maintained in a separate repository at https://github.com/razorpay/ifsc-api.
License
The code in this repository is licensed under the MIT License. License
text is available in the LICENSE
file. The dataset itself
is under public domain.