Socket
Socket
Sign inDemoInstall

credit-card-validate

Package Overview
Dependencies
0
Maintainers
1
Versions
4
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

    credit-card-validate

Tool for validating credit cards.


Version published
Weekly downloads
50
decreased by-67.32%
Maintainers
1
Install size
93.8 kB
Created
Weekly downloads
 

Readme

Source

Credit card validate

codecov codecov codecov codecov

This library is for testing the validity of credit cards. It can can check number of digits, luhn algorithm, number of digits in code (CVV, CVC, ...), expiration or type of Credit card.

There are 7 card types built in - American Express, Diners Club, Discover, JCB, Maestro, MasterCard and Visa. I can't guarantee that card type validation will work on 100%. There is not some trustworthy source with information how to detect it right. Most of information comes from https://en.wikipedia.org/wiki/Payment_card_number. You can also add your own credit card types.

You can use package as npm module. Just install it:

npm install credit-card-validate --save-dev

and use it in you project:

var validators = require('credit-card-validate');
var card = new validators.cards.Visa('4111111111111111', new Date('2017-29'), '122');
console.log(card.isValid() ? 'Card is valid' : 'Card is invalid');

You can also install it as bower package:

bower install credit-card-validate

and use is very similar as in npm

var card = new CardValidate.cards.MasterCard('5451418521738499', new Date('2018-29'), '432');
console.log(card.isValid() ? 'Card is valid' : 'Card is invalid');

It can be also used with RequireJS, CommonJS, Browserify or Webpack.

Predefined card types

Following card types are currently build in:

  • American Express
  • Diners Club
  • Discover
  • JCB
  • Maestro
  • MasterCard
  • Visa

You can get various information from classes from static methods:

// will provide list of length card could be
// eg [13, 16, 19]
CardValidate.cards.Visa.getAllowedDigits()

// get length of code (CVV, CVC, ...)
// eg 3
CardValidate.cards.Visa.getAllowedCodeDigits()

// where can be code found? back or front
// eg front
CardValidate.cards.Visa.getCodeLocation()

You can also create object and check validity of various property or all of them by once. To create a card object just push to constructor card number, expire date and code.

var card = CardValidate.cards.AmericanExpress("378282246310005", new Date("2019-12"), "3456");

card.isExpired();
card.isLuhnValid();

// check that card number is in range on card type
card.isCardTypeValid();

card.isNumberOfDigitsValid();

card.isNumberOfCodeDigitsValid();

// check all tests at one
card.isValid();

Custom card type

You can create your own custom credit card. In example I'm using ECMAScript 2015 syntax.

class YouOwnCard extends CardValidate.CreditCard {

    constructor(number, expire, code) {
        super(number, expire, code);
        this.name = 'You Own Card';
        this.allowedDigits = YouOwnCard.getAllowedDigits();
        this.allowedCodeDigits = YouOwnCard.getAllowedCodeDigits();
        this.codeLocation = YouOwnCard.getCodeLocation();
        this.startDigits = YouOwnCard.getStartDigits();
    }

    static getStartDigits() {
        // card have to start with 98 or 99
        return ['99', '98'];
    }

    static getCodeLocation(): string {
        return 'back';
    }

    static getAllowedCodeDigits(): number {
        return 3;
    }

    static getAllowedDigits(): Array<number> {
        return [13, 16, 19];
    }
}

Detect credit card type

With last feature you can detect credit card type based on number. You can to create object of CreditCardFactory a fill it with all credit card you want to support:

var creditCardFactory = CardValidate.CreditCardFactory([CardValidate.cards.DinersClub, CardValidate.cards.JCB]);

// this will return array with both DinersClub and JCB, because number number can be both
console.log(creditCardFactory.find('3');

// this return array with one item JCB card
console.log(creditCardFactory.find('35', new Date('2010-10'), '123');

Keywords

FAQs

Last updated on 30 Mar 2017

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc