Transactions v2

Learn more about calling API v2 endpoints.

Use Transactions to view changes to your FinancialAccount balance over time. Every flow that moves money, such as OutboundPayments or ReceivedCredits, will have one or more Transactions that describes how the flow impacted your balance. Note that while the FinancialAccount balance will always be up to date, be aware that Transactions and TransactionEntries are created shortly after to reflect changes.

Endpoints

GET/v2/money_management/transactions/:id

GET/v2/money_management/transactions

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

Learn more about calling API v2 endpoints.

Retrieves the details of a Transaction by ID.

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

Server-side language

curl https://api.stripe.com/v2/money_management/transactions/trxn_65NygiBHKcUPGUI8A5Q16NoTesLDSQ1IgNPigisRKq0GAq \
  -H "Authorization: Bearer {{YOUR_API_KEY}}{{YOUR_API_KEY}}" \
  -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

Learn more about calling API v2 endpoints.

Returns a list of Transactions that match the provided filters.

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

Server-side language

curl https://api.stripe.com/v2/money_management/transactions \
  -H "Authorization: Bearer {{YOUR_API_KEY}}{{YOUR_API_KEY}}" \
  -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

Learn more about calling API v2 endpoints.

This is a list of all the types of events we currently send. We may add more at any time, so in developing and maintaining your code, you should not assume that only these types exist.

Event types

Type

Filter events by type

v2.money_management.transaction.created

Occurs when a Transaction is created.

Attributes

idstring
Unique identifier for the event.

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

contextnullable string
Authentication context needed to fetch the event or related object.

createdtimestamp
Time at which the object was created.

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

reasonnullable object
Reason for the event.

related_objectnullable object
Object containing the reference to API resource relevant to the event.

typestring, value is "v2.money_management.transaction.created"
The type of the event.

Fetched attributes

dataobject
Additional data about the event.

Event handler

Server-side language

# Select a client library to see examples of
# parsing and retrieving event details.

v2.money_management.transaction.updated

Occurs when a Transaction is updated.

Attributes

idstring
Unique identifier for the event.

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

contextnullable string
Authentication context needed to fetch the event or related object.

createdtimestamp
Time at which the object was created.

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

reasonnullable object
Reason for the event.

related_objectnullable object
Object containing the reference to API resource relevant to the event.

typestring, value is "v2.money_management.transaction.updated"
The type of the event.

Fetched attributes

dataobject
Additional data about the event.

Event handler

Server-side language

# Select a client library to see examples of
# parsing and retrieving event details.

Transactions v2

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

Attributes

idstring

objectstring, value is "v2.core.event"

contextnullable string

createdtimestamp

livemodeboolean

reasonnullable object

related_objectnullable object

typestring, value is "v2.money_management.transaction.created"

Fetched attributes

dataobject

Attributes

idstring

objectstring, value is "v2.core.event"

contextnullable string

createdtimestamp

livemodeboolean

reasonnullable object

related_objectnullable object

typestring, value is "v2.money_management.transaction.updated"

Fetched attributes

dataobject