Transactions
Any use of an issued card that results in funds entering or leaving your Stripe account, such as a completed purchase or refund, is represented by an Issuing Transaction
object.
Related guide: Issued card transactions
The Transaction object
Attributes
- idstring
Unique identifier for the object.
- amountinteger
The transaction amount, which will be reflected in your balance. This amount is in your currency and in the smallest currency unit.
- authorizationnullable stringExpandable
The
Authorization
object that led to this transaction. - cardstringExpandable
The card used to make this transaction.
- cardholdernullable stringExpandable
The cardholder to whom this transaction belongs.
- currencyenum
Three-letter ISO currency code, in lowercase. Must be a supported currency.
- metadataobject
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.
- typeenum
The nature of the transaction.
More attributes
- objectstring
- amount_
detailsnullable object - balance_
transactionnullable stringExpandable - createdtimestamp
- disputenullable stringExpandable
- livemodeboolean
- merchant_
amountinteger - merchant_
currencyenum - merchant_
dataobject - network_
datanullable object - purchase_
detailsnullable objectExpandable - tokennullable stringPreview featureExpandable
- walletnullable enum
Update a transaction
Updates the specified Issuing Transaction
object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
Parameters
- metadataobject
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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to
metadata
.
Returns
Returns an updated Issuing Transaction
object if a valid identifier was provided.
Retrieve a transaction
Retrieves an Issuing Transaction
object.
Parameters
No parameters.
Returns
Returns an Issuing Transaction
object if a valid identifier was provided.
List all transactions
Returns a list of Issuing Transaction
objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
Parameters
- cardstring
Only return transactions that belong to the given card.
- cardholderstring
Only return transactions that belong to the given cardholder.
More parameters
- createdobject
- ending_
beforestring - limitinteger
- starting_
afterstring - typeenum
Returns
A dictionary with a data
property that contains an array of up to limit
transactions, starting after transaction starting_after
. Each entry in the array is a separate Issuing Transaction
object. If no more transactions are available, the resulting array will be empty.