binlookup

    2.0.1 • Public • Published

    BIN/IIN look up

    Lookup card BIN numbers using https://www.binlist.net

    IIN (Issuer Identification Number) is the more modern name.

    Useful for querying information from a credit card such as:

    • brand (Visa, MasterCard, American Express, etc.)
    • expected card number length and LUHN algorithm support
    • type (debit or credit)
    • category (prepaid or classic)
    • country
    • issuing bank

    What is a BIN?

    The BIN is the first digits of a card number: 0000 0000 **** ****. You can pass any card number prefix of 4-9 digits. More numbers will return more information.

    Use

    Works in browser environments using Browserify or similar.

    var lookup = require('binlookup')();
     
    // using callbacks
    lookup('45717360',
        function( err, data ){
            console.log(data);
        });
     
    // using promises
    lookup('45717360').then(
        data => console.log(data));

    Example data returned:

    {
        number: {
            length: 16,
            luhn: true
        },
        scheme: 'visa',
        type: 'debit',
        brand: 'Visa/Dankort',
        prepaid: false,
        country: {
            numeric: '208',
            alpha2: 'DK',
            name: 'Denmark',
            emoji: '🇩🇰',
            currency: 'DKK',
            latitude: 56,
            longitude: 10
        },
        bank: {
            name: 'Jyske Bank',
            url: 'www.jyskebank.dk',
            phone: '+4589893300',
            city: 'Hjørring'
        }
    }

    Caching

    You can cache the response using AsyncCache or similar:

    var lookup = require('binlookup')();
    var AsyncCache = require('async-cache');
     
    var cache = new AsyncCache({
        load: lookup,
    });
     
    cache.get(bin, function( err, data ){
        console.log(data);
    });

      Oh noes! Something went wrong.

      Illustration of wombats

      The package file size seems to be too large or the last published date is too old.

      We may support exploring this package in the future. Check back soon.

      Install

      npm i binlookup

      DownloadsWeekly Downloads

      2,976

      Version

      2.0.1

      License

      MIT

      Last publish

      Collaborators

      • thomas-jensen