io.card.payment

Enum CardType

java.lang.Object

java.lang.Enum<CardType>

io.card.payment.CardType

All Implemented Interfaces:

Serializable, Comparable<CardType>

public enum CardType
extends Enum<CardType>

Enumerates each supported card type. see http://en.wikipedia.org/wiki/Bank_card_number for more details.

Version:

1.0

Enum Constant Summary

Enum Constants

Enum Constant and Description
AMEX American Express cards start in 34 or 37
DINERSCLUB Diners Club
DISCOVER Discover starts with 6x for some values of x.
INSUFFICIENT_DIGITS Not enough information given.
JCB JCB (see http://www.jcbusa.com/) cards start with 35
MAESTRO Maestro
MASTERCARD Mastercard starts with 51-55
UNKNOWN Unknown card type.
VISA Visa starts with 4

Field Summary

Fields

Modifier and Type	Field and Description
String	name

Method Summary

Modifier and Type	Method and Description
int	cvvLength()
static CardType	fromCardNumber(String numStr) Infer the CardType from the number string.
static CardType	fromString(String typeStr) Infer the card type from a string.
String	getDisplayName(String languageOrLocale) Convenience method to return a CardType string (e.g.
Bitmap	imageBitmap(Context context) Returns the Bitmap of the card logo (e.g.
int	numberLength()
String	toString()
static CardType	valueOf(String name) Returns the enum constant of this type with the specified name.
static CardType[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

compareTo, equals, getDeclaringClass, hashCode, name, ordinal, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

AMEX

public static final CardType AMEX

American Express cards start in 34 or 37

DINERSCLUB

public static final CardType DINERSCLUB

Diners Club

DISCOVER

public static final CardType DISCOVER

Discover starts with 6x for some values of x.

JCB

public static final CardType JCB

JCB (see http://www.jcbusa.com/) cards start with 35

MASTERCARD

public static final CardType MASTERCARD

Mastercard starts with 51-55

VISA

public static final CardType VISA

Visa starts with 4

MAESTRO

public static final CardType MAESTRO

Maestro

UNKNOWN

public static final CardType UNKNOWN

Unknown card type.

INSUFFICIENT_DIGITS

public static final CardType INSUFFICIENT_DIGITS

Not enough information given.

More digits are required to know the card type. (e.g. all we have is a 3, so we don't know if it's JCB or AmEx)

Field Detail

name

public final String name

Method Detail

values

public static CardType[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (CardType c : CardType.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static CardType valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

toString

public String toString()

Overrides:

toString in class Enum<CardType>

getDisplayName

public String getDisplayName(String languageOrLocale)

Convenience method to return a CardType string (e.g. "Visa", "American Express", "JCB", "Maestro", "MasterCard", or "Discover") suitable for display. This string will be translated into the language specified. See CardIOActivity.EXTRA_LANGUAGE_OR_LOCALE for a detailed explanation of languageOrLocale.

Parameters:

languageOrLocale - See CardIOActivity.EXTRA_LANGUAGE_OR_LOCALE.

Returns:

the display name of the card

numberLength

public int numberLength()

Returns:

15 for AmEx, -1 for unknown, 16 for others.

cvvLength

public int cvvLength()

Returns:

4 for Amex, 3 for others, -1 for unknown

imageBitmap

public Bitmap imageBitmap(Context context)

Returns the Bitmap of the card logo (e.g. Visa, MC, etc.), if known. Otherwise, returns null.

Returned bitmap is suitable for display with a masked card number, for example, to indicate a user's chosen card.

Parameters:

context - The application context for retrieving the image density

Returns:

the bitmap icon of the card for display

fromString

public static CardType fromString(String typeStr)

Infer the card type from a string.

Parameters:

typeStr - The String value of this enum

Returns:

the matched real type

fromCardNumber

public static CardType fromCardNumber(String numStr)

Infer the CardType from the number string. See http://en.wikipedia.org/wiki/Bank_card_number for these ranges (last checked: 19 Feb 2013)

Parameters:

numStr - A string containing only the card number.

Returns:

the inferred card type