com.stripe.android.model

Class Card

java.lang.Object

com.stripe.android.model.Card

public class Card
extends java.lang.Object

A model object representing a Card in the Android SDK.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Card.Builder Builder class for a Card model.
static interface	Card.CardBrand
static interface	Card.FundingType

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	AMERICAN_EXPRESS
static java.lang.String	DINERS_CLUB
static java.lang.String	DISCOVER
static java.lang.String	FUNDING_CREDIT
static java.lang.String	FUNDING_DEBIT
static java.lang.String	FUNDING_PREPAID
static java.lang.String	FUNDING_UNKNOWN
static java.lang.String	JCB
static java.lang.String	MASTERCARD
static int	MAX_LENGTH_AMERICAN_EXPRESS
static int	MAX_LENGTH_DINERS_CLUB
static int	MAX_LENGTH_STANDARD
static java.lang.String[]	PREFIXES_AMERICAN_EXPRESS
static java.lang.String[]	PREFIXES_DINERS_CLUB
static java.lang.String[]	PREFIXES_DISCOVER
static java.lang.String[]	PREFIXES_JCB
static java.lang.String[]	PREFIXES_MASTERCARD
static java.lang.String[]	PREFIXES_VISA
static java.lang.String	UNKNOWN
static java.lang.String	VISA

Constructor Summary

Constructors

Constructor and Description
Card(java.lang.String number, java.lang.Integer expMonth, java.lang.Integer expYear, java.lang.String cvc) Convenience constructor for a Card object with a minimum number of inputs.
Card(java.lang.String number, java.lang.Integer expMonth, java.lang.Integer expYear, java.lang.String cvc, java.lang.String name, java.lang.String addressLine1, java.lang.String addressLine2, java.lang.String addressCity, java.lang.String addressState, java.lang.String addressZip, java.lang.String addressCountry, java.lang.String currency) Convenience constructor with address and currency.
Card(java.lang.String number, java.lang.Integer expMonth, java.lang.Integer expYear, java.lang.String cvc, java.lang.String name, java.lang.String addressLine1, java.lang.String addressLine2, java.lang.String addressCity, java.lang.String addressState, java.lang.String addressZip, java.lang.String addressCountry, java.lang.String brand, java.lang.String last4, java.lang.String fingerprint, java.lang.String funding, java.lang.String country, java.lang.String currency) Card constructor with all available fields.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getAddressCity()
java.lang.String	getAddressCountry()
java.lang.String	getAddressLine1()
java.lang.String	getAddressLine2()
java.lang.String	getAddressState()
java.lang.String	getAddressZip()
java.lang.String	getBrand() Gets the brand of this card.
java.lang.String	getCountry()
java.lang.String	getCurrency()
java.lang.String	getCVC()
java.lang.Integer	getExpMonth()
java.lang.Integer	getExpYear()
java.lang.String	getFingerprint()
java.lang.String	getFunding()
java.lang.String	getLast4()
java.lang.String	getName()
java.lang.String	getNumber()
java.lang.String	getType() Deprecated.
void	setAddressCity(java.lang.String addressCity) Deprecated.
void	setAddressCountry(java.lang.String addressCountry) Deprecated.
void	setAddressLine1(java.lang.String addressLine1) Deprecated.
void	setAddressLine2(java.lang.String addressLine2) Deprecated.
void	setAddressState(java.lang.String addressState) Deprecated.
void	setAddressZip(java.lang.String addressZip) Deprecated.
void	setCurrency(java.lang.String currency) Deprecated.
void	setCVC(java.lang.String cvc) Deprecated.
void	setExpMonth(java.lang.Integer expMonth) Deprecated.
void	setExpYear(java.lang.Integer expYear) Deprecated.
void	setName(java.lang.String name) Deprecated.
void	setNumber(java.lang.String number) Deprecated.
boolean	validateCard() Checks whether this represents a valid card.
boolean	validateCVC() Checks whether or not the cvc field is valid.
boolean	validateExpiryDate() Checks whether or not the expMonth and expYear fields represent a valid expiry date.
boolean	validateExpMonth() Checks whether or not the expMonth field is valid.
boolean	validateExpYear() Checks whether or not the expYear field is valid.
boolean	validateNumber() Checks whether or not the number field is valid.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

AMERICAN_EXPRESS

public static final java.lang.String AMERICAN_EXPRESS

See Also:

Constant Field Values

DISCOVER

public static final java.lang.String DISCOVER

See Also:

Constant Field Values

JCB

public static final java.lang.String JCB

See Also:

Constant Field Values

DINERS_CLUB

public static final java.lang.String DINERS_CLUB

See Also:

Constant Field Values

VISA

public static final java.lang.String VISA

See Also:

Constant Field Values

MASTERCARD

public static final java.lang.String MASTERCARD

See Also:

Constant Field Values

UNKNOWN

public static final java.lang.String UNKNOWN

See Also:

Constant Field Values

FUNDING_CREDIT

public static final java.lang.String FUNDING_CREDIT

See Also:

Constant Field Values

FUNDING_DEBIT

public static final java.lang.String FUNDING_DEBIT

See Also:

Constant Field Values

FUNDING_PREPAID

public static final java.lang.String FUNDING_PREPAID

See Also:

Constant Field Values

FUNDING_UNKNOWN

public static final java.lang.String FUNDING_UNKNOWN

See Also:

Constant Field Values

PREFIXES_AMERICAN_EXPRESS

public static final java.lang.String[] PREFIXES_AMERICAN_EXPRESS

PREFIXES_DISCOVER

public static final java.lang.String[] PREFIXES_DISCOVER

PREFIXES_JCB

public static final java.lang.String[] PREFIXES_JCB

PREFIXES_DINERS_CLUB

public static final java.lang.String[] PREFIXES_DINERS_CLUB

PREFIXES_VISA

public static final java.lang.String[] PREFIXES_VISA

PREFIXES_MASTERCARD

public static final java.lang.String[] PREFIXES_MASTERCARD

MAX_LENGTH_STANDARD

public static final int MAX_LENGTH_STANDARD

See Also:

Constant Field Values

MAX_LENGTH_AMERICAN_EXPRESS

public static final int MAX_LENGTH_AMERICAN_EXPRESS

See Also:

Constant Field Values

MAX_LENGTH_DINERS_CLUB

public static final int MAX_LENGTH_DINERS_CLUB

See Also:

Constant Field Values

Constructor Detail

Card

public Card(java.lang.String number,
            java.lang.Integer expMonth,
            java.lang.Integer expYear,
            java.lang.String cvc,
            java.lang.String name,
            java.lang.String addressLine1,
            java.lang.String addressLine2,
            java.lang.String addressCity,
            java.lang.String addressState,
            java.lang.String addressZip,
            java.lang.String addressCountry,
            java.lang.String brand,
            java.lang.String last4,
            java.lang.String fingerprint,
            java.lang.String funding,
            java.lang.String country,
            java.lang.String currency)

Card constructor with all available fields.

Parameters:

number - the credit card number

expMonth - the expiry month

expYear - the expiry year

cvc - the CVC number

name - the card name

addressLine1 - first line of the billing address

addressLine2 - second line of the billing address

addressCity - city of the billing address

addressState - state of the billing address

addressZip - zip code of the billing address

addressCountry - country for the billing address

brand - brand of this card

last4 - last 4 digits of the card

fingerprint - the card fingerprint

funding - the funding type of the card

country - ISO country code of the card itself

currency - currency used by the card

Card

public Card(java.lang.String number,
            java.lang.Integer expMonth,
            java.lang.Integer expYear,
            java.lang.String cvc,
            java.lang.String name,
            java.lang.String addressLine1,
            java.lang.String addressLine2,
            java.lang.String addressCity,
            java.lang.String addressState,
            java.lang.String addressZip,
            java.lang.String addressCountry,
            java.lang.String currency)

Convenience constructor with address and currency.

Parameters:

number - the card number

expMonth - the expiry month

expYear - the expiry year

cvc - the CVC code

name - the cardholder name

addressLine1 - the first line of the billing address

addressLine2 - the second line of the billing address

addressCity - the city of the billing address

addressState - the state of the billing address

addressZip - the zip code of the billing address

addressCountry - the country of the billing address

currency - the currency of the card

Card

public Card(java.lang.String number,
            java.lang.Integer expMonth,
            java.lang.Integer expYear,
            java.lang.String cvc)

Convenience constructor for a Card object with a minimum number of inputs.

Parameters:

number - the card number

expMonth - the expiry month

expYear - the expiry year

cvc - the CVC code

Method Detail

validateCard

public boolean validateCard()

Checks whether this represents a valid card.

Returns:

true if valid, false otherwise.

validateNumber

public boolean validateNumber()

Checks whether or not the number field is valid.

Returns:

true if valid, false otherwise.

validateExpiryDate

public boolean validateExpiryDate()

Checks whether or not the expMonth and expYear fields represent a valid expiry date.

Returns:

true if valid, false otherwise

validateCVC

public boolean validateCVC()

Checks whether or not the cvc field is valid.

Returns:

true if valid, false otherwise

validateExpMonth

public boolean validateExpMonth()

Checks whether or not the expMonth field is valid.

Returns:

true if valid, false otherwise.

validateExpYear

public boolean validateExpYear()

Checks whether or not the expYear field is valid.

Returns:

true if valid, false otherwise.

getNumber

public java.lang.String getNumber()

Returns:

the number of this card

setNumber

@Deprecated
public void setNumber(java.lang.String number)

Deprecated.

Setter for the card number. Note that mutating the number of this card object invalidates the brand and last4.

Parameters:

number - the new number

getCVC

public java.lang.String getCVC()

Returns:

the cvc for this card

setCVC

@Deprecated
public void setCVC(java.lang.String cvc)

Deprecated.

Parameters:

cvc - the new cvc code for this card

getExpMonth

@Nullable
public java.lang.Integer getExpMonth()

Returns:

the expMonth for this card

setExpMonth

@Deprecated
public void setExpMonth(@Nullable
                                    java.lang.Integer expMonth)

Deprecated.

Parameters:

expMonth - sets the expMonth for this card

getExpYear

public java.lang.Integer getExpYear()

Returns:

the expYear for this card

setExpYear

@Deprecated
public void setExpYear(java.lang.Integer expYear)

Deprecated.

Parameters:

expYear - sets the expYear for this card

getName

public java.lang.String getName()

Returns:

the cardholder name for this card

setName

@Deprecated
public void setName(java.lang.String name)

Deprecated.

Parameters:

name - sets the cardholder name for this card

getAddressLine1

public java.lang.String getAddressLine1()

Returns:

the addressLine1 of this card

setAddressLine1

@Deprecated
public void setAddressLine1(java.lang.String addressLine1)

Deprecated.

Parameters:

addressLine1 - sets the addressLine1 for this card

getAddressLine2

public java.lang.String getAddressLine2()

Returns:

the addressLine2 of this card

setAddressLine2

@Deprecated
public void setAddressLine2(java.lang.String addressLine2)

Deprecated.

Parameters:

addressLine2 - sets the addressLine2 for this card

getAddressCity

public java.lang.String getAddressCity()

Returns:

the addressCity for this card

setAddressCity

@Deprecated
public void setAddressCity(java.lang.String addressCity)

Deprecated.

Parameters:

addressCity - sets the addressCity for this card

getAddressZip

public java.lang.String getAddressZip()

Returns:

the addressZip of this card

setAddressZip

@Deprecated
public void setAddressZip(java.lang.String addressZip)

Deprecated.

Parameters:

addressZip - sets the addressZip for this card

getAddressState

public java.lang.String getAddressState()

Returns:

the addressState of this card

setAddressState

@Deprecated
public void setAddressState(java.lang.String addressState)

Deprecated.

Parameters:

addressState - sets the addressState for this card

getAddressCountry

public java.lang.String getAddressCountry()

Returns:

the addressCountry of this card

setAddressCountry

@Deprecated
public void setAddressCountry(java.lang.String addressCountry)

Deprecated.

Parameters:

addressCountry - sets the addressCountry for this card

getCurrency

public java.lang.String getCurrency()

Returns:

the currency of this card. Only supported for Managed accounts.

setCurrency

@Deprecated
public void setCurrency(java.lang.String currency)

Deprecated.

Parameters:

currency - sets the currency of this card. Only supported for Managed accounts.

getLast4

public java.lang.String getLast4()

Returns:

the last4 digits of this card. Sets the value based on the number if it has not already been set.

getType

@Deprecated
public java.lang.String getType()

Deprecated.

Gets the brand of this card, changed from the "type" field. Use getBrand() instead.

Returns:

the brand of this card

getBrand

public java.lang.String getBrand()

Gets the brand of this card. Updates the value if none has yet been set, or if the number has been changed.

Returns:

the brand of this card

getFingerprint

public java.lang.String getFingerprint()

Returns:

the fingerprint of this card

getFunding

@Nullable
public java.lang.String getFunding()

Returns:

the funding type of this card

getCountry

public java.lang.String getCountry()

Returns:

the country of this card