Skip to content

entrecode/iban-to-bic

 
 

Repository files navigation

iban-to-bic

GitHub license npm Unit tests workflow status

Determines the SWIFT BIC of an IBAN. Currently supports IBANs from the following countries: Austria, Belgium, Germany, Luxembourg, Netherlands, Spain, France.

Usage

const { ibanToBic } = require('iban-to-bic');

const bic = ibanToBic('DE51500105179975341634');
// bic is now "INGDDEFFXXX"

ibanToBic returns undefined if the IBAN is invalid (checked internally using ibantools) or if no corresponding BIC was found.

Usage in the browser

iban-to-bic is really simple to use inside a browser. You can either pull the package from npm and build it with your favorite packaging tool or you can use it from a CDN like this:

<script type="text/javascript" src="https://unpkg.com/iban-to-bic@latest/dist/iban-to-bic.js">

Or

<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/iban-to-bic@latest/dist/iban-to-bic.js">

And then invoke it like this:

<script type="text/javascript">
	window.ibanToBic.ibanToBic('********');
</script>

Using this code makes it super comfortable to validate user input and provide auto-fill to your application.

Updating the dataset

The following will fetch the newest data from the respective national bank authorities (e.g. Bundesbank in Germany or OeNB in Austria) and regenerate the files in the datasets and the datasets-extended directory:

npm run generate

For Spain and France, data directly from the European Central Bank is used, see here.

programmatically update the dataset

You can also update the dataset at runtime whenever you want (e.g. at start-up):

const { ibanToBic, generate } = require('iban-to-bic');

await generate();

License

MIT

About

Determines the SWIFT BIC of an IBAN.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%