Skip to main content
Schema2020-08-27object

card

You can store multiple cards on a customer in order to charge the customer later. You can also store multiple debit cards on a recipient in order to transfer to those cards later. Related guide: [Card Payments with Sources](https://stripe.com/docs/sources/cards).

Source
openapi/spec3.json
Commit
d70de345383d
Active snapshot
da69df7e6e11

Card

object

You can store multiple cards on a customer in order to charge the customer later. You can also store multiple debit cards on a recipient in order to transfer to those cards later. Related guide: [Card Payments with Sources](https://stripe.com/docs/sources/cards).

account
optionalnullable

The account this card belongs to. This attribute will not be in the card object if the card belongs to a customer or recipient instead.

address_city string
optionalnullable

City/District/Suburb/Town/Village.

address_country string
optionalnullable

Billing address country, if provided when creating card.

address_line1 string
optionalnullable

Address line 1 (Street address/PO Box/Company name).

address_line1_check string
optionalnullable

If `address_line1` was provided, results of the check: `pass`, `fail`, `unavailable`, or `unchecked`.

address_line2 string
optionalnullable

Address line 2 (Apartment/Suite/Unit/Building).

address_state string
optionalnullable

State/County/Province/Region.

address_zip string
optionalnullable

ZIP or postal code.

address_zip_check string
optionalnullable

If `address_zip` was provided, results of the check: `pass`, `fail`, `unavailable`, or `unchecked`.

available_payout_methods array
optionalnullable

A set of available payout methods for this card. Only values from this set should be passed as the `method` when creating a payout.

brand string
required

Card brand. Can be `American Express`, `Diners Club`, `Discover`, `JCB`, `MasterCard`, `UnionPay`, `Visa`, or `Unknown`.

country string
optionalnullable

Two-letter ISO code representing the country of the card. You could use this attribute to get a sense of the international breakdown of cards you've collected.

currency string
optionalnullable

Three-letter [ISO code for currency](https://stripe.com/docs/payouts). Only applicable on accounts (not customers or recipients). The card can be used as a transfer destination for funds in this currency.

customer
optionalnullable

The customer that this card belongs to. This attribute will not be in the card object if the card belongs to an account or recipient instead.

cvc_check string
optionalnullable

If a CVC was provided, results of the check: `pass`, `fail`, `unavailable`, or `unchecked`. A result of unchecked indicates that CVC was provided but hasn't been checked yet. Checks are typically performed when attaching a card to a Customer object, or when creating a charge. For more details, see [Check if a card is valid without a charge](https://support.stripe.com/questions/check-if-a-card-is-valid-without-a-charge).

default_for_currency boolean
optionalnullable

Whether this card is the default external account for its currency.

dynamic_last4 string
optionalnullable

(For tokenized numbers only.) The last four digits of the device account number.

exp_month integer
required

Two-digit number representing the card's expiration month.

exp_year integer
required

Four-digit number representing the card's expiration year.

fingerprint string
optionalnullable

Uniquely identifies this particular card number. You can use this attribute to check whether two customers who’ve signed up with you are using the same card number, for example. For payment methods that tokenize card information (Apple Pay, Google Pay), the tokenized number might be provided instead of the underlying card number. *Starting May 1, 2021, card fingerprint in India for Connect will change to allow two fingerprints for the same card --- one for India and one for the rest of the world.*

funding string
required

Card funding type. Can be `credit`, `debit`, `prepaid`, or `unknown`.

id string
required

Unique identifier for the object.

last4 string
required

The last four digits of the card.

metadata object
optionalnullable

Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

name string
optionalnullable

Cardholder name.

object string
required

String representing the object's type. Objects of the same type share the same value.

recipient
optionalnullable

The recipient that this card belongs to. This attribute will not be in the card object if the card belongs to a customer or account instead.

tokenization_method string
optionalnullable

If the card number is tokenized, this is the method that was used. Can be `android_pay` (includes Google Pay), `apple_pay`, `masterpass`, `visa_checkout`, or null.