Transactions 

A Transaction represents a real transaction that affects a Financial Connections Account balance.

The Transaction object 

Attributes

  • idstring

    Unique identifier for the object.

  • objectstring

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

  • accountstring

    The ID of the Financial Connections Account this transaction belongs to.

  • amountinteger

    The amount of this transaction, in cents.

  • currencystring

    Three-letter ISO currency code, in lowercase. Must be a supported currency.

  • descriptionstring

    The description of this transaction.

  • livemodeboolean

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

  • statusenum

    The status of the transaction.

    Possible enum values
    pending

    This transaction is processing and does not yet affect the account’s balance.

    posted

    This transaction has processed and affects the account’s balance.

    void

    This transaction has disappeared and no longer affects the account’s balance.

  • status_transitionsobject

    The timestamps at which the transaction status was updated.

  • transacted_attimestamp

    Time at which the transaction was transacted. Measured in seconds since the Unix epoch.

  • transaction_refreshstring

    The token of the transaction refresh that last updated or created this transaction.

  • updatedtimestamp

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

The Transaction object
{
"id": "fctxn_1MwVKd2eZvKYlo2ChNw2UxSa",
"object": "financial_connections.transaction",
"account": "fca_1MwVKd2eZvKYlo2CnlgoF3I4",
"amount": 300,
"currency": "usd",
"description": "Rocket Rides",
"livemode": false,
"status": "posted",
"status_transitions": {
"posted_at": 1681412239,
"void_at": null
},
"transacted_at": 1681412239,
"transaction_refresh": "fctxnref_NhvAgiKSFDg9jOe6eIlj41X5",
"updated": 1681412239
}

Retrieve a Transaction 

Retrieves the details of a Financial Connections Transaction

Parameters

No parameters.

Returns

Returns a Transaction object if a valid identifier was provided, and raises an error otherwise.

GET /v1/financial_connections/transactions/:id
curl https://api.stripe.com/v1/financial_connections/transactions/fctxn_1MwVKd2eZvKYlo2ChNw2UxSa \
-u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:"
Response
{
"id": "fctxn_1MwVKd2eZvKYlo2ChNw2UxSa",
"object": "financial_connections.transaction",
"account": "fca_1MwVKd2eZvKYlo2CnlgoF3I4",
"amount": 300,
"currency": "usd",
"description": "Rocket Rides",
"livemode": false,
"status": "posted",
"status_transitions": {
"posted_at": 1681412239,
"void_at": null
},
"transacted_at": 1681412239,
"transaction_refresh": "fctxnref_NhvAgiKSFDg9jOe6eIlj41X5",
"updated": 1681412239
}

List Transactions 

Returns a list of Financial Connections Transaction objects.

Parameters

  • accountstringRequired

    The ID of the Financial Connections Account whose transactions will be retrieved.

  • transacted_atobject

    A filter on the list based on the object transacted_at field. The value can be a string with an integer Unix timestamp, or it can be a dictionary with the following options:

  • transaction_refreshobject

    A filter on the list based on the object transaction_refresh field. The value can be a dictionary with the following options:

More parameters

  • ending_beforestring

  • limitinteger

  • starting_afterstring

Returns

A dictionary with a data property that contains an array of up to limit Transaction objects, starting after transaction starting_after. Each entry in the array is a separate Transaction object. If no more transactions are available, the resulting array will be empty.

GET /v1/financial_connections/transactions
curl -G https://api.stripe.com/v1/financial_connections/transactions \
-u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
-d account=fca_1NpHiT2eZvKYlo2C6pRwOFjr \
-d limit=3
Response
{
"object": "list",
"url": "/v1/financial_connections/transactions",
"has_more": false,
"data": [
{
"id": "fctxn_1NpHiT2eZvKYlo2CZFvnM3HJ",
"object": "financial_connections.transaction",
"account": "fca_1NpHiT2eZvKYlo2C6pRwOFjr",
"amount": 300,
"currency": "usd",
"description": "Rocket Rides",
"livemode": false,
"status": "posted",
"status_transitions": {
"posted_at": 1694467941,
"void_at": null
},
"transacted_at": 1694467941,
"transaction_refresh": "fctxnref_OcWmGrWptAdJ2bmpYE2P0Hws",
"updated": 1694467941
}
]
}

Tax Calculations 

A Tax Calculation allows you to calculate the tax to collect from your customer.

Related guide: Calculate tax in your custom payment flow