/iban-to-bic

Determines the SWIFT BIC of an IBAN.

Primary LanguageJavaScriptMIT LicenseMIT

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.

License

MIT