Skip to main content
Schema2020-08-27object

issuing.authorization

When an [issued card](https://stripe.com/docs/issuing) is used to make a purchase, an Issuing `Authorization` object is created. [Authorizations](https://stripe.com/docs/issuing/purchases/authorizations) must be approved for the purchase to be completed successfully. Related guide: [Issued Card Authorizations](https://stripe.com/docs/issuing/purchases/authorizations).

Source
openapi/spec3.json
Commit
d70de345383d
Active snapshot
da69df7e6e11

IssuingCard

object

You can [create physical or virtual cards](https://stripe.com/docs/issuing/cards) that are issued to cardholders.

brand string
required

The brand of the card.

cancellation_reason string
optionalnullable

The reason why the card was canceled.

cardholder IssuingCardholder object
required

An Issuing `Cardholder` object represents an individual or business entity who is [issued](https://stripe.com/docs/issuing) cards. Related guide: [How to create a Cardholder](https://stripe.com/docs/issuing/cards#create-cardholder)

created integer (unix-time)
required

Time at which the object was created. Measured in seconds since the Unix epoch.

currency string
required

Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).

cvc string
optional

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://stripe.com/docs/api/expanding_objects). Additionally, it's only available via the ["Retrieve a card" endpoint](https://stripe.com/docs/api/issuing/cards/retrieve), not via "List all cards" or any other endpoint.

exp_month integer
required

The expiration month of the card.

exp_year integer
required

The expiration year of the card.

id string
required

Unique identifier for the object.

last4 string
required

The last 4 digits of the card number.

livemode boolean
required

Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.

metadata object
required

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.

number string
optional

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://stripe.com/docs/api/expanding_objects). Additionally, it's only available via the ["Retrieve a card" endpoint](https://stripe.com/docs/api/issuing/cards/retrieve), not via "List all cards" or any other endpoint.

object string
required

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

replaced_by
optionalnullable

The latest card that replaces this card, if any.

replacement_for
optionalnullable

The card this card replaces, if any.

replacement_reason string
optionalnullable

The reason why the previous card needed to be replaced.

shipping
optionalnullable

Where and how the card will be shipped.

status string
required

Whether authorizations can be approved on this card.

type string
required

The type of the card.

wallets
optionalnullable

Information relating to digital wallets (like Apple Pay and Google Pay).