The Transaction object

Attributes

idstring
Unique identifier for the object.

objectstring, value is "v2.money_management.transaction"
String representing the object’s type. Objects of the same type share the same value of the object field.

amountobject
The amount of the Transaction.

balance_impactobject
The delta to the FinancialAccount’s balance. The balance_impact for the Transaction is equal to sum of its TransactionEntries that have effective_ats in the past.

categoryenum

A descriptive category used to classify the Transaction.

Possible enum values

adjustment

This Transaction is the main Transaction for an Adjustment.

inbound_transfer

This Transaction is the main Transaction for an InboundTransfer.

outbound_payment

This Transaction is the main Transaction for an OutboundPayment.

outbound_transfer

This Transaction is the main Transaction for an OutboundTransfer.

received_credit

This Transaction is the main Transaction for a ReceivedCredit.

received_debit

This Transaction is the main Transaction for a ReceivedDebit.

return

This Transaction is for the return of funds, such as when an OutboundPayment is returned by the recipient’s bank.

stripe_fee

This Transaction is for a fee assessed by Stripe.

createdtimestamp
Time at which the object was created. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.

financial_accountstring
Indicates the FinancialAccount affected by this Transaction.

flowobject
Details about the Flow object that created the 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

Current status of the Transaction. A Transaction is pending if either balance_impact.inbound_pending or balance_impact.outbound_pending is non-zero. A Transaction is posted if only balance_impact.available is non-zero. A Transaction is void if there is no balance impact. posted and void are terminal states, and no additional entries will be added to the Transaction.

Possible enum values

pending

This Transaction’s balance impact is still pending (non-zero impact to either inbound_pending or outbound_pending). Further entries may still be added that move funds between availability states.

posted

This Transaction’s balance impact is fully posted (only cash will be non-zero). This status is final and no further entries will be added.

void

This Transaction’s balance impact has been voided (all values are zero). This status is final and no further entries will be added.

status_transitionsobject
Timestamps for when the Transaction transitioned to a particular status.

The Transaction object

{
  "id": "trxn_65NygiBHKcUPGUI8A5Q16NoTesLDSQ1IgNPigisRKq0GAq",
  "object": "v2.money_management.transaction",
  "amount": {
    "value": -1000,
    "currency": "usd"
  },
  "balance_impact": {
    "available": {
      "value": -1000,
      "currency": "usd"
    },
    "inbound_pending": {
      "value": 0,
      "currency": "usd"
    },
    "outbound_pending": {
      "value": 0,
      "currency": "usd"
    }
  },
  "category": "outbound_transfer",
  "created": "2023-03-24T22:06:37.343Z",
  "financial_account": "fa_65NvnnT0stRlwPDg2kc16NoTesLDSQ1IgNPigisRKq00Km",
  "flow": {
    "outbound_transfer": "obt_65NygiAXfaPmQ5ev3oz16NoTesLDSQ1IgNPigisRKq07Fg",
    "type": "outbound_transfer"
  },
  "status": "posted",
  "status_transitions": {
    "posted_at": "2023-03-24T22:06:35.409Z",
    "void_at": null
  }
}

Retrieve a Transaction object v2

Retrieves the details of a Transaction by ID.

Learn more about calling API v2 endpoints.

Parameters

idstringRequired
The ID of the Transaction to retrieve.

Returns

Response attributes

idstring
Unique identifier for the object.

objectstring, value is "v2.money_management.transaction"
String representing the object’s type. Objects of the same type share the same value of the object field.

amountobject
The amount of the Transaction.

balance_impactobject
The delta to the FinancialAccount’s balance. The balance_impact for the Transaction is equal to sum of its TransactionEntries that have effective_ats in the past.

categoryenum

A descriptive category used to classify the Transaction.

Possible enum values

adjustment

This Transaction is the main Transaction for an Adjustment.

inbound_transfer

This Transaction is the main Transaction for an InboundTransfer.

outbound_payment

This Transaction is the main Transaction for an OutboundPayment.

outbound_transfer

This Transaction is the main Transaction for an OutboundTransfer.

received_credit

This Transaction is the main Transaction for a ReceivedCredit.

received_debit

This Transaction is the main Transaction for a ReceivedDebit.

return

This Transaction is for the return of funds, such as when an OutboundPayment is returned by the recipient’s bank.

stripe_fee

This Transaction is for a fee assessed by Stripe.

createdtimestamp
Time at which the object was created. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.

financial_accountstring
Indicates the FinancialAccount affected by this Transaction.

flowobject
Details about the Flow object that created the 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

Possible enum values

pending

posted

This Transaction’s balance impact is fully posted (only cash will be non-zero). This status is final and no further entries will be added.

void

This Transaction’s balance impact has been voided (all values are zero). This status is final and no further entries will be added.

status_transitionsobject
Timestamps for when the Transaction transitioned to a particular status.

Error Codes

404not_found

The resource wasn’t found.

GET /v2/money_management/transactions/:id

curl https://api.stripe.com/v2/money_management/transactions/trxn_65NygiBHKcUPGUI8A5Q16NoTesLDSQ1IgNPigisRKq0GAq \
  -H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
  -H "Stripe-Version: 2025-04-30.preview"

Response

{
  "id": "trxn_65NygiBHKcUPGUI8A5Q16NoTesLDSQ1IgNPigisRKq0GAq",
  "object": "v2.money_management.transaction",
  "amount": {
    "value": -1000,
    "currency": "usd"
  },
  "balance_impact": {
    "available": {
      "value": -1000,
      "currency": "usd"
    },
    "inbound_pending": {
      "value": 0,
      "currency": "usd"
    },
    "outbound_pending": {
      "value": 0,
      "currency": "usd"
    }
  },
  "category": "outbound_transfer",
  "created": "2023-03-24T22:06:37.343Z",
  "financial_account": "fa_65NvnnT0stRlwPDg2kc16NoTesLDSQ1IgNPigisRKq00Km",
  "flow": {
    "outbound_transfer": "obt_65NygiAXfaPmQ5ev3oz16NoTesLDSQ1IgNPigisRKq07Fg",
    "type": "outbound_transfer"
  },
  "status": "posted",
  "status_transitions": {
    "posted_at": "2023-03-24T22:06:35.409Z",
    "void_at": null
  }
}

List all Transaction objects v2

Returns a list of Transactions that match the provided filters.

Learn more about calling API v2 endpoints.

Parameters

createdtimestamp
Filter for Transactions created at an exact time.

created_gttimestamp
Filter for Transactions created after the specified timestamp.

created_gtetimestamp
Filter for Transactions created at or after the specified timestamp.

created_lttimestamp
Filter for Transactions created before the specified timestamp.

created_ltetimestamp
Filter for Transactions created at or before the specified timestamp.

financial_accountstring
Filter for Transactions belonging to a FinancialAccount.

flowstring
Filter for Transactions corresponding to a Flow.

limitinteger
The page limit.

pagestring
The page token.

Returns

Response attributes

dataarray of objects
List of Transaction objects.

next_page_urlnullable string
The next page URL.

previous_page_urlnullable string
The previous page URL.

Error Codes

404not_found

The resource wasn’t found.

GET /v2/money_management/transactions

curl https://api.stripe.com/v2/money_management/transactions \
  -H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
  -H "Stripe-Version: 2025-04-30.preview"

Response

{
  "data": [
    {
      "id": "trxn_65NygiBHKcUPGUI8A5Q16NoTesLDSQ1IgNPigisRKq0GAq",
      "object": "v2.money_management.transaction",
      "amount": {
        "value": -1000,
        "currency": "usd"
      },
      "balance_impact": {
        "available": {
          "value": -1000,
          "currency": "usd"
        },
        "inbound_pending": {
          "value": 0,
          "currency": "usd"
        },
        "outbound_pending": {
          "value": 0,
          "currency": "usd"
        }
      },
      "category": "outbound_transfer",
      "created": "2023-03-24T22:06:37.343Z",
      "financial_account": "fa_65NvnnT0stRlwPDg2kc16NoTesLDSQ1IgNPigisRKq00Km",
      "flow": {
        "outbound_transfer": "obt_65NygiAXfaPmQ5ev3oz16NoTesLDSQ1IgNPigisRKq07Fg",
        "type": "outbound_transfer"
      },
      "status": "posted",
      "status_transitions": {
        "posted_at": "2023-03-24T22:06:35.409Z",
        "void_at": null
      }
    },
    {
      "id": "trxn_65NygdWJ4oXvPH8YeYq16NoTesLDSQ1IgNPigisRKq0Flo",
      "object": "v2.money_management.transaction",
      "amount": {
        "value": 1000,
        "currency": "usd"
      },
      "balance_impact": {
        "available": {
          "value": 1000,
          "currency": "usd"
        },
        "inbound_pending": {
          "value": 0,
          "currency": "usd"
        },
        "outbound_pending": {
          "value": 0,
          "currency": "usd"
        }
      },
      "category": "received_credit",
      "created": "2023-03-24T22:01:48.394Z",
      "financial_account": "fa_65NygYWKxfJHZ49zLiX16NoTesLDSQ1IgNPigisRKq0Vqy",
      "flow": {
        "received_credit": "rc_61NygdVsGgIDm9k6816NoTesLDSQ1IgNPigisRKq06Cu",
        "type": "received_credit"
      },
      "status": "posted",
      "status_transitions": {
        "posted_at": "2023-03-24T22:01:46.107Z",
        "void_at": null
      }
    }
  ],
  "next_page_url": null,
  "previous_page_url": null
}

Transaction event types v2

This is a list of all public thin events we currently send for updates to Transaction, which are continually evolving and expanding. The payload of thin events is unversioned. During processing, you must fetch the versioned event from the API or fetch the resource’s current state.

Event types

Type

Filter events by type

Type

v2.money_management.transaction.created

Occurs when a Transaction is created.

v2.money_management.transaction.updated

Occurs when a Transaction is updated.

The Transaction object

Attributes

idstring

objectstring, value is "v2.money_management.transaction"

amountobject

balance_impactobject

categoryenum

createdtimestamp

financial_accountstring

flowobject

livemodeboolean

statusenum

status_transitionsobject

Retrieve a Transaction object v2

Parameters

idstringRequired

Returns

Response attributes

idstring

objectstring, value is "v2.money_management.transaction"

amountobject

balance_impactobject

categoryenum

createdtimestamp

financial_accountstring

flowobject

livemodeboolean

statusenum

status_transitionsobject

List all Transaction objects v2

Parameters

createdtimestamp

created_gttimestamp

created_gtetimestamp

created_lttimestamp

created_ltetimestamp

financial_accountstring

flowstring

limitinteger

pagestring

Returns

Response attributes

dataarray of objects

next_page_urlnullable string

previous_page_urlnullable string

Transaction event types v2

Event types