Transactions

Transactions represent changes to a FinancialAccount’s balance.

Was this section helpful? Yes No

Retrieve a Transaction

GET / v1 / treasury / transactions /:id

List all Transactions

GET / v1 / treasury / transactions

The Transaction object

Attributes

id string Unique identifier for the object.
object string, value is "treasury.transaction" String representing the object’s type. Objects of the same type share the same value.
amount integer Amount (in cents) transferred.
balance _ impact object The change made to each of the FinancialAccount’s sub-balances by the Transaction.
created timestamp Time at which the object was created. Measured in seconds since the Unix epoch.
currency enum Three-letter ISO currency code, in lowercase. Must be a supported currency.
description string An arbitrary string attached to the object. Often useful for displaying to users.
entries nullable object Includable A list of TransactionEntries that are part of this Transaction. This cannot be expanded in any list endpoints.
financial _ account string The FinancialAccount associated with this object.
flow nullable string ID of the flow that created the Transaction.
flow _ details nullable object Includable Details of the flow that created the Transaction.
flow _ type enum Type of the flow that created the Transaction. Possible enum values credit_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. other The 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.
livemode boolean If the object exists in live mode, the value is true. If the object exists in test mode, the value is false.
status enum Status of the Transaction. Possible enum values open The 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. posted Funds have successfully entered or left the account. The current balance was affected. void The 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 _ transitions object Hash containing timestamps of when the object transitioned to a particular status.

The Transaction object

{ "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 }}

Retrieve a Transaction

GET / v1 / treasury / transactions /:id

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.

Response

{ "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 }}