objectissuing.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
IssuingAuthorization
objectWhen 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).
The total amount that was authorized or rejected. This amount is in the card's currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
Whether the authorization has been approved.
How the card details were provided.
List of balance transactions associated with this authorization.
You can [create physical or virtual cards](https://stripe.com/docs/issuing/cards) that are issued to cardholders.
The cardholder to whom this authorization belongs.
Time at which the object was created. Measured in seconds since the Unix epoch.
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).
Unique identifier for the object.
Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
The total amount that was authorized or rejected. This amount is in the `merchant_currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
The currency that was presented to the cardholder for the authorization. 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).
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.
String representing the object's type. Objects of the same type share the same value.
The pending authorization request. This field will only be non-null during an `issuing_authorization.request` webhook.
History of every time `pending_request` was approved/denied, either by you directly or by Stripe (e.g. based on your `spending_controls`). If the merchant changes the authorization by performing an [incremental authorization](https://stripe.com/docs/issuing/purchases/authorizations), you can look at this field to see the previous requests for the authorization.
The current status of the authorization in its lifecycle.
List of [transactions](https://stripe.com/docs/api/issuing/transactions) associated with this authorization.
The digital wallet used for this authorization. One of `apple_pay`, `google_pay`, or `samsung_pay`.