# The Card object #### Virtual #### Virtual ### The Card object ```json { "id": "ic_1MvSieLkdIwHu7ixn6uuO0Xu", "object": "issuing.card", "brand": "Visa", "cancellation_reason": null, "cardholder": { "id": "ich_1MsKAB2eZvKYlo2C3eZ2BdvK", "object": "issuing.cardholder", "billing": { "address": { "city": "Anytown", "country": "US", "line1": "123 Main Street", "line2": null, "postal_code": "12345", "state": "CA" } }, "company": null, "created": 1680415995, "email": null, "individual": null, "livemode": false, "metadata": {}, "name": "John Doe", "phone_number": null, "requirements": { "disabled_reason": "requirements.past_due", "past_due": [ "individual.card_issuing.user_terms_acceptance.ip", "individual.card_issuing.user_terms_acceptance.date", "individual.first_name", "individual.last_name" ] }, "spending_controls": { "allowed_categories": [], "blocked_categories": [], "spending_limits": [], "spending_limits_currency": null }, "status": "active", "type": "individual" }, "created": 1681163868, "currency": "usd", "exp_month": 8, "exp_year": 2024, "last4": "4242", "livemode": false, "metadata": {}, "replaced_by": null, "replacement_for": null, "replacement_reason": null, "shipping": null, "spending_controls": { "allowed_categories": null, "blocked_categories": null, "spending_limits": [], "spending_limits_currency": null }, "status": "active", "type": "virtual", "wallets": { "apple_pay": { "eligible": false, "ineligible_reason": "missing_cardholder_contact" }, "google_pay": { "eligible": false, "ineligible_reason": "missing_cardholder_contact" }, "primary_account_identifier": null } } ``` #### Physical #### Physical ### The Card object ```json { "id": "ic_1MvSieLkdIwHu7ixn6uuO0Xu", "object": "issuing.card", "brand": "Visa", "cancellation_reason": null, "cardholder": { "id": "ich_1MsKAB2eZvKYlo2C3eZ2BdvK", "object": "issuing.cardholder", "billing": { "address": { "city": "Anytown", "country": "US", "line1": "123 Main Street", "line2": null, "postal_code": "12345", "state": "CA" } }, "company": null, "created": 1680415995, "email": null, "individual": null, "livemode": false, "metadata": {}, "name": "John Doe", "phone_number": null, "requirements": { "disabled_reason": "requirements.past_due", "past_due": [ "individual.card_issuing.user_terms_acceptance.ip", "individual.card_issuing.user_terms_acceptance.date", "individual.first_name", "individual.last_name" ] }, "spending_controls": { "allowed_categories": [], "blocked_categories": [], "spending_limits": [], "spending_limits_currency": null }, "status": "active", "type": "individual" }, "created": 1681163868, "currency": "usd", "exp_month": 8, "exp_year": 2024, "last4": "4242", "livemode": false, "personalization_design": "ipcd_1QhT4vRkL7wZcM8bJqF3gN2Y", "metadata": {}, "replaced_by": null, "replacement_for": null, "replacement_reason": null, "shipping": { "address": { "city": "Anytown", "country": "US", "line1": "123 Main Street", "line2": null, "postal_code": "12345", "state": "CA" }, "address_validation": { "mode": "validation_and_normalization", "normalized_address": { "city": "ANYTOWN", "country": "US", "line1": "123 MAIN ST", "line2": null, "postal_code": "12345", "state": "CA" }, "result": "likely_deliverable" }, "carrier": "usps", "customs": { "eori_number": null }, "eta": 1680415995, "name": "John Doe", "phone": null, "phone_number": "+12345678910", "require_signature": false, "service": "standard", "status": "pending", "tracking_number": null, "tracking_url": null, "type": "individual" }, "spending_controls": { "allowed_categories": null, "blocked_categories": null, "spending_limits": [], "spending_limits_currency": null }, "status": "active", "type": "physical", "wallets": { "apple_pay": { "eligible": false, "ineligible_reason": "missing_cardholder_contact" }, "google_pay": { "eligible": false, "ineligible_reason": "missing_cardholder_contact" }, "primary_account_identifier": null } } ``` ## Attributes - `id` (string) Unique identifier for the object. - `object` (string) String representing the object’s type. Objects of the same type share the same value. - `brand` (string) The brand of the card. - `cancellation_reason` (enum, nullable) The reason why the card was canceled. Possible enum values: - `design_rejected` The design of this card was rejected by Stripe for violating our [partner guidelines](https://docs.stripe.com/issuing/cards/physical.md#design-review). - `fulfillment_error` There was an error in fulfilling the card. This reason is only valid for cards of type `physical`. - `lost` The card was lost. - `stolen` The card was stolen. - [`cardholder`](https://docs.stripe.com/api/issuing/cards/object.md?query=cardholder) (object) The [Cardholder](https://docs.stripe.com/api.md#issuing_cardholder_object) object to which the card belongs. - `created` (timestamp) Time at which the object was created. Measured in seconds since the Unix epoch. - `currency` (enum) Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Supported currencies are `usd` in the US, `eur` in the EU, and `gbp` in the UK. - `cvc` (string, nullable, expandable (can be expanded into an object with the `expand` request parameter)) The card’s CVC. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with [the `expand` parameter](https://docs.stripe.com/api/expanding_objects.md). Additionally, it’s only available via the [“Retrieve a card” endpoint](https://docs.stripe.com/api/issuing/cards/retrieve.md), not via “List all cards” or any other endpoint. - `exp_month` (integer) The expiration month of the card. - `exp_year` (integer) The expiration year of the card. - `last4` (string) The last 4 digits of the card number. - [`latest_fraud_warning`](https://docs.stripe.com/api/issuing/cards/object.md?query=latest_fraud_warning) (object, nullable) Stripe’s assessment of whether this card’s details have been compromised. If this property isn’t null, cancel and reissue the card to prevent fraudulent activity risk. - [`lifecycle_controls`](https://docs.stripe.com/api/issuing/cards/object.md?query=lifecycle_controls) (object, nullable) Rules that control the lifecycle of this card, such as automatic cancellation. Refer to our [documentation](https://docs.stripe.com/issuing/controls/lifecycle-controls.md) for more details. - `livemode` (boolean) If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`. - `metadata` (map) Set of [key-value pairs](https://docs.stripe.com/api/metadata.md) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. - `number` (string, nullable, expandable (can be expanded into an object with the `expand` request parameter)) The full unredacted card number. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with [the `expand` parameter](https://docs.stripe.com/api/expanding_objects.md). Additionally, it’s only available via the [“Retrieve a card” endpoint](https://docs.stripe.com/api/issuing/cards/retrieve.md), not via “List all cards” or any other endpoint. - `personalization_design` (string, nullable, expandable (can be expanded into an object with the `expand` request parameter)) The personalization design object belonging to this card. - `replaced_by` (string, nullable, expandable (can be expanded into an object with the `expand` request parameter)) The latest card that replaces this card, if any. - `replacement_for` (string, nullable, expandable (can be expanded into an object with the `expand` request parameter)) The card this card replaces, if any. - `replacement_reason` (enum, nullable) The reason why the previous card needed to be replaced. Possible enum values: - `damaged` The physical card has been damaged and cannot be used at terminals. This reason is only valid for cards of type `physical`. - `expired` The expiration date has passed or is imminent. - `fulfillment_error` There was an error in fulfilling the card. This reason is only valid for cards of type `physical`. - `lost` The card was lost. This status is only valid if the card it replaces is marked as lost. - `stolen` The card was stolen. This status is only valid if the card it replaces is marked as stolen. - `second_line` (string, nullable) Text separate from cardholder name, printed on the card. - [`shipping`](https://docs.stripe.com/api/issuing/cards/object.md?query=shipping) (object, nullable) Where and how the card will be shipped. - [`spending_controls`](https://docs.stripe.com/api/issuing/cards/object.md?query=spending_controls) (object) Rules that control spending for this card. Refer to our [documentation](https://docs.stripe.com/issuing/controls/spending-controls.md) for more details. - `status` (enum) Whether authorizations can be approved on this card. May be blocked from activating cards depending on past-due Cardholder requirements. Defaults to `inactive`. Possible enum values: - `active` The card can approve authorizations. If the card is linked to a cardholder with past-due requirements, you may be unable to change the card’s status to ‘active’. - `canceled` The card will decline authorizations with the `card_canceled` reason. This status is permanent. - `inactive` The card will decline authorizations with the `card_inactive` reason. - `type` (enum) The type of the card. Possible enum values: - `physical` A physical card will be printed and shipped. It can be used at physical terminals. - `virtual` No physical card will be printed. The card can be used online and can be [added to digital wallets](https://docs.stripe.com/issuing/cards/digital-wallets.md). - [`wallets`](https://docs.stripe.com/api/issuing/cards/object.md?query=wallets) (object, nullable) Information relating to digital wallets (like Apple Pay and Google Pay).