Card Identifier

Python library for credit/debit card identification and utilities

Quickstart

>>> card = "5401683100112371"
>>> validate_card(card)
True
>>> format_card("5401 6831 0011 2371")
"5401683100112371"
>>> identify_card_type(card)
"MasterCard"
>>> identify_card_issuer(card)["scheme"]
"MASTERCARD"
>>> identify_card_issuer(card)["bank"]["name"]
"CHASE"
>>> identify_card_issuer(card)["type"]
"CREDIT"

Card Identifier takes out the busy work from simple card operations. This includes validation, formatting, and identification.

Features

• Card number validation
• Card number reformatting
• Identify card type (VISA, MasterCard, etc)
• Identify card issuer using the binlist.net API

Card Identifier supports Python 2.7 and 3.4–3.6.

Installation

To install Card Identifier, use pip:

$ pip install card_identifier

API Documentation

cardutils

cardutils.format_card

Formats card numbers to remove any spaces, unnecessary characters, etc.

Input: Card number, integer or string

Output: Correctly formatted card number, string

Usage

>>> from card_identifier.cardutils import format_card
>>> format_card("5401 6831 0011 2371woops")
"5401683100112371"

cardutils.validate_card

Check if card is valid using the Luhn algorithm.

Input: Card number, integer or string

Output: Valid?, boolean

Usage

>>> from card_identifier.cardutils import validate_card
>>> validate_card("5401683100112371")
True
>>> validate_card("1234567890123456")
False

card_type

card_type.identify_card_type

Identifies the card type based on the card number. This information is provided through the first 6 digits of the card number.

Input: Card number, int or string

Output: Card type, string

Usage

>>> from card_identifier.card_type import identify_card_type
>>> identify_card_type('370000000000002')
'AMEX'

>>> identify_card_type('6011000000000012')
'Discover'

>>> identify_card_type('5424000000000015')
'MasterCard'

>>> identify_card_type('4007000000027')
'Visa'

>>> identify_card_type('400700000002')
'Unknown'

card_issuer

card_issuer.identify_card_issuer

Determines the card issuer using an IIN database (https://binlist.net)

Input: Card number, int or string

Output: Card issuer information, dictionary (spec by binlist.net)

Usage

>>> from card_identifier.card_issuer import identify_card_issuer
>>> identify_card_issuer("5401683100112371")
{
  "bank": {
    "city": "",
    "logo": "",
    "name": "CHASE",
    "phone": "8005243880",
    "url": ""
  },
  "brand": "",
  "country": {
    "alpha2": "US",
    "latitude": 38,
    "longitude": -97,
    "name": "United States",
    "numeric": "840"
  },
  "number": {"length": None, "prefix": "540168"},
  "prepaid": False,
  "scheme": "MASTERCARD",
  "type": "CREDIT"
}