Transactions represent changes to a FinancialAccount’s balance.
Attributes
- idstring
Unique identifier for the object.
- objectstring
String representing the object’s type. Objects of the same type share the same value.
- amountinteger
Amount (in cents) transferred.
- balance_
impactobject The change made to each of the FinancialAccount’s sub-balances by the Transaction.
- createdtimestamp
Time at which the object was created. Measured in seconds since the Unix epoch.
- currencyenum
Three-letter ISO currency code, in lowercase. Must be a supported currency.
- descriptionstring
An arbitrary string attached to the object. Often useful for displaying to users.
- entriesnullable objectExpandable
A list of TransactionEntries that are part of this Transaction. This cannot be expanded in any list endpoints.
- financial_
accountstring The FinancialAccount associated with this object.
- flownullable string
ID of the flow that created the Transaction.
- flow_
detailsnullable objectExpandable Details of the flow that created the Transaction.
- flow_
typeenum Type of the flow that created the Transaction.
Possible enum valuescredit_reversal The Transaction is associated with a CreditReversal.
debit_reversal The Transaction is associated with a DebitReversal.
inbound_transfer The Transaction is associated with an InboundTransfer.
issuing_authorization The Transaction is associated with an Issuing authorization.
otherThe Transaction is associated with some other money movement not listed above.
outbound_payment The Transaction is associated with an OutboundPayment.
outbound_transfer The Transaction is associated with an OutboundTransfer.
received_credit The Transaction is associated with a ReceivedCredit.
received_debit The Transaction is associated with a ReceivedDebit.
- livemodeboolean
If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - statusenum
Status of the Transaction.
Possible enum valuesopenThe initial state for all Transactions. The Transaction results in updates to the sub-balance amounts, but the current balance is not affected until the Transaction posts.
postedFunds have successfully entered or left the account. The current balance was affected.
voidThe Transaction never impacted the balance. For example, a Transaction would enter this state if an OutboundPayment was initiated but then canceled before the funds left the account.
- status_
transitionsobject Hash containing timestamps of when the object transitioned to a particular
status.
{ "id": "trxn_1MtkYw2eZvKYlo2ClMGIO54z", "object": "treasury.transaction", "amount": -100, "balance_impact": { "cash": -100, "inbound_pending": 0, "outbound_pending": 100 }, "created": 1680755802, "currency": "usd", "description": "Jane Austen (6789) | Outbound transfer | transfer", "financial_account": "fa_1MtkYw2eZvKYlo2CrqmzUo3O", "flow": "obt_1MtkYw2eZvKYlo2CqsyBpQts", "flow_type": "outbound_transfer", "livemode": false, "status": "open", "status_transitions": { "posted_at": null, "void_at": null }}Retrieves the details of an existing Transaction.
Parameters
No parameters.
Returns
Returns a Transaction object if a valid identifier was provided. Otherwise, returns an error.
curl https://api.stripe.com/v1/treasury/transactions/{{TRANSACTION_ID}} \ -u "sk_test_Hrs6SAopgFPF0bZXSN3f6ELNsk_test_Hrs6SAopgFPF0bZXSN3f6ELN:"{ "id": "trxn_1MtkYw2eZvKYlo2ClMGIO54z", "object": "treasury.transaction", "amount": -100, "balance_impact": { "cash": -100, "inbound_pending": 0, "outbound_pending": 100 }, "created": 1680755802, "currency": "usd", "description": "Jane Austen (6789) | Outbound transfer | transfer", "financial_account": "fa_1MtkYw2eZvKYlo2CrqmzUo3O", "flow": "obt_1MtkYw2eZvKYlo2CqsyBpQts", "flow_type": "outbound_transfer", "livemode": false, "status": "open", "status_transitions": { "posted_at": null, "void_at": null }}