juspay / card-validator

Card validation helpers for payment forms.

Card Validator

Generic helpers for card number, expiry and CVV validations

Usage:

Import the library and initialize card object.

Install from npm:

npm i @juspay/simple-card-validator --save

var cardValidator = require('simple-card-validator');

Or, you can simply use the file from dist/validator.js if you are not using node/npm.

var card = new cardValidator('4242-4242-4242-4242');

Getting card details

card.getCardDetails(); This would output, card brand and different validation outputs like below:

{ card_type: 'visa',
  valid: true,
  luhn_valid: true,
  length_valid: true,
  cvv_length: [ 3 ],
  gaps: [ 4, 8, 12 ],
  supported_lengths: [ 16 ],
  max_length: 16 }

Output format

Field	Description	Type
card_type	The card issuer for the provided card	String
valid	Are the card details valid	Boolean
luhn_valid	Is the card number valid	Boolean
length_valid	If the card number length is valid	Boolean
cvv_length	If the CVV/CAVV length is valid	Array [ Integer ]
gaps	Gaps for UI as printed in cards	Array [ Integer ]
supported_lengths	Supported lengths for the card type	Array [ Integer ]
max_length	Maximum length for the card type	Integer

Validations

To simply validate a card, call: card.validateCard(); The result will be a validity boolean.

For validating expiry date, card.validateExpiry('12/2018');

Additionally, the base date can be set for expiry validations. The base month and date can be provided by using, card.setBaseDate(month, year);

eg: card.setBaseDate('02', '2016');

For validating CVV, use: card.validateCvv(111); CVV will be validated based on the brand of the card.

Contribution

Read through the development guidelines.

License

MIT license. Copyright © 2018 - juspay.in.