@yetuny/credit-card-type-tr v5.0.6

Credit Card Type

Credit Card Type provides a useful utility method for determining a credit card type from both fully qualified and partial numbers. This is not a validation library but rather a smaller component to help you build your own validation or UI library.

This library is designed for type-as-you-go detection (supports partial numbers) and is written in CommonJS so you can use it in Node, io.js, and the browser.

Download

To install via npm:

npm install @yetuny/credit-card-type-tr

Example

var creditCardType = require('@yetuny/credit-card-type-tr');

var visaCards = creditCardType('4111');
console.log(visaCards[0].type);  // 'visa'

var troyCards = creditCardType('9792');
console.log(visaCards[0].type);  // 'troy'

var ambiguousCards = creditCardType('6');
console.log(ambiguousCards.length);       // 3
console.log(ambiguousCards[0].niceType);  // 'Discover'
console.log(ambiguousCards[1].niceType);  // 'UnionPay'
console.log(ambiguousCards[2].niceType);  // 'Maestro'

API

creditCardType(number: String)

creditCardType will return an array of objects, each with the following data:

If no card types are found, this returns an empty array.

creditCardType.getTypeInfo(type: String)

getTypeInfo will return a singular object (with the same structure as creditCardType) corresponding with the specified type, or undefined if the specified type is invalid/unknown.

Card Type "Constants"

Named variables are provided for each of the supported card types:

• VISA
• MASTERCARD
• AMERICAN_EXPRESS
• DINERS_CLUB
• DISCOVER
• JCB
• UNIONPAY
• MAESTRO

code

Card brands provide different nomenclature for their security codes as well as varying lengths.

A full response for a Visa card will look like this:

{
  niceType: 'Visa',
  type: 'visa',
  gaps: [ 4, 8, 12 ],
  lengths: [16],
  code: { name: 'CVV', size: 3 }
}

Note: The response also includes an exactPattern regex and a prefixPattern regex. These are used internally to determine the card type, but they should not be relied on and may be removed in the next major version.

Advanced Usage

CommonJS:

var creditCardType = require('credit-card-type');
var getTypeInfo = require('credit-card-type').getTypeInfo;
var CardType = require('credit-card-type').types;

ES6:

import creditCardType, { getTypeInfo, types as CardType } from 'credit-card-type';

Filtering

creditCardType(cardNumber).filter(function(card) {
  return card.type == CardType.MASTERCARD || card.type == CardType.VISA;
});

Pretty Card Numbers

function prettyCardNumber(cardNumber, cardType) {
  var card = getTypeInfo(cardType);

  if (card) {
    var offsets = [0].concat(card.gaps).concat([cardNumber.length]);
    var components = [];

    for (var i = 0; offsets[i] < cardNumber.length; i++) {
      var start = offsets[i];
      var end = Math.min(offsets[i + 1], cardNumber.length);
      components.push(cardNumber.substring(start, end));
    }

    return components.join(' ');
  }

  return cardNumber;
}

prettyCardNumber('xxxxxxxxxx343', CardType.AMERICAN_EXPRESS); // 'xxxx xxxxxx 343'

Development

We use nvm for managing our node versions, but you do not have to. Replace any nvm references with the tool of your choice below.

nvm install
npm install

All testing dependencies will be installed upon npm install and the test suite executed with npm test.