Attributes
- idstring
Unique identifier for the object.
- cardnullable object
Hash describing the card used to make the charge.
- card.
idstring Unique identifier for the object.
- card.
objectstring String representing the object’s type. Objects of the same type share the same value.
- card.
address_ citynullable string City/District/Suburb/Town/Village.
- card.
address_ countrynullable string Billing address country, if provided when creating card.
- card.
address_ line1nullable string Address line 1 (Street address/PO Box/Company name).
- card.
address_ line1_ checknullable string If
address_
was provided, results of the check:line1 pass
,fail
,unavailable
, orunchecked
. - card.
address_ line2nullable string Address line 2 (Apartment/Suite/Unit/Building).
- card.
address_ statenullable string State/County/Province/Region.
- card.
address_ zipnullable string ZIP or postal code.
- card.
address_ zip_ checknullable string If
address_
was provided, results of the check:zip pass
,fail
,unavailable
, orunchecked
. - card.
brandstring Card brand. Can be
American Express
,Diners Club
,Discover
,Eftpos Australia
,Girocard
,JCB
,MasterCard
,UnionPay
,Visa
, orUnknown
. - card.
countrynullable string 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.
- card.
currencynullable enum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- card.
cvc_ checknullable string If a CVC was provided, results of the check:
pass
,fail
,unavailable
, orunchecked
. 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. - card.
dynamic_ last4nullable string (For tokenized numbers only.) The last four digits of the device account number.
- card.
exp_ monthinteger Two-digit number representing the card’s expiration month.
- card.
exp_ yearinteger Four-digit number representing the card’s expiration year.
- card.
fingerprintnullable string 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.
As of May 1, 2021, card fingerprint in India for Connect changed to allow two fingerprints for the same card—one for India and one for the rest of the world.
- card.
fundingstring Card funding type. Can be
credit
,debit
,prepaid
, orunknown
. - card.
iinnullable string Issuer identification number of the card.
- card.
last4string The last four digits of the card.
- card.
metadatanullable object Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- card.
namenullable string Cardholder name.
- card.
networksnullable object Contains information about card networks used to process the payment.
- card.
networks. preferrednullable string The preferred network for co-branded cards. Can be
cartes_
,bancaires mastercard
,visa
orinvalid_
if requested network is not valid for the card.preference
- card.
regulated_ statusnullable enum Status of a card based on the card issuer.
Possible enum valuesregulated
The card falls under a regulated account range.
unregulated
The card does not fall under a regulated account range.
- card.
tokenization_ methodnullable string If the card number is tokenized, this is the method that was used. Can be
android_
(includes Google Pay),pay apple_
,pay masterpass
,visa_
, or null.checkout - card.
walletnullable objectPreview feature If this Card is part of a card wallet, this contains the details of the card wallet.
- card.
wallet. apple_ paynullable object If this is a
apple_
card wallet, this hash contains details about the wallet.pay - card.
wallet. typeenum The type of the card wallet, one of
apple_
orpay link
. An additional hash is included on the Wallet subhash with a name matching this value. It contains additional information specific to the card wallet type.Possible enum valuesapple_
pay link
More attributes
- objectstring
String representing the object’s type. Objects of the same type share the same value.
- bank_
accountnullable object Hash describing the bank account.
- bank_account.
idstring Unique identifier for the object.
- bank_account.
objectstring String representing the object’s type. Objects of the same type share the same value.
- bank_account.
account_ holder_ namenullable string The name of the person or business that owns the bank account.
- bank_account.
account_ holder_ typenullable string The type of entity that holds the account. This can be either
individual
orcompany
. - bank_account.
account_ typenullable string The bank account type. This can only be
checking
orsavings
in most countries. In Japan, this can only befutsu
ortoza
. - bank_account.
bank_ namenullable string Name of the bank associated with the routing number (e.g.,
WELLS FARGO
). - bank_account.
countrystring Two-letter ISO code representing the country the bank account is located in.
- bank_account.
currencyenum Three-letter ISO code for the currency paid out to the bank account.
- bank_account.
fingerprintnullable string Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same.
- bank_account.
last4string The last four digits of the bank account number.
- bank_account.
routing_ numbernullable string The routing transit number for the bank account.
- bank_account.
statusstring For bank accounts, possible values are
new
,validated
,verified
,verification_
, orfailed errored
. A bank account that hasn’t had any activity or validation performed isnew
. If Stripe can determine that the bank account exists, its status will bevalidated
. Note that there often isn’t enough information to know (e.g., for smaller credit unions), and the validation is not always run. If customer bank account verification has succeeded, the bank account status will beverified
. If the verification failed for any reason, such as microdeposit failure, the status will beverification_
. If a payout sent to this bank account fails, we’ll set the status tofailed errored
and will not continue to send scheduled payouts until the bank details are updated.For external accounts, possible values are
new
,errored
andverification_
. If a payout fails, the status is set tofailed errored
and scheduled payouts are stopped until account details are updated. In the US and India, if we can’t verify the owner of the bank account, we’ll set the status toverification_
. Other validations aren’t run against external accounts because they’re only used for payouts. This means the other statuses don’t apply.failed
- client_
ipnullable string IP address of the client that generates the token.
- createdtimestamp
Time at which the object was created. Measured in seconds since the Unix epoch.
- descriptionnullable string
An arbitrary string attached to the object. Often useful for displaying to users.
- livemodeboolean
Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - typestring
Type of the token:
account
,bank_
,account card
, orpii
. - usedboolean
Determines if you have already used this token (you can only use tokens once).
{ "id": "tok_1N3T00LkdIwHu7ixt44h1F8k", "object": "token", "card": { "id": "card_1N3T00LkdIwHu7ixRdxpVI1Q", "object": "card", "address_city": null, "address_country": null, "address_line1": null, "address_line1_check": null, "address_line2": null, "address_state": null, "address_zip": null, "address_zip_check": null, "brand": "Visa", "country": "US", "cvc_check": "unchecked", "dynamic_last4": null, "exp_month": 5, "exp_year": 2026, "fingerprint": "mToisGZ01V71BCos", "funding": "credit", "last4": "4242", "metadata": {}, "name": null, "tokenization_method": null, "wallet": null }, "client_ip": "52.35.78.6", "created": 1683071568, "livemode": false, "type": "card", "used": false}