Stripe: Retrieve a transaction

Stripe issuing.getIssuingTransactionsTransaction: arguments, response, policy and SDK examples.

Operation stripe.getissuingtransactionstransaction

Provider route: GET /v1/issuing/transactions/{transaction}. Alter supplies the connection’s credentials and routing.

Call through Alter

Install @alter-ai/sdk @alter-ai/stripe with npm, or alter-sdk-stripe with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { StripeIntegration } from "@alter-ai/stripe";

async function execute(input: Parameters<StripeIntegration["issuing"]["getIssuingTransactionsTransaction"]>[0]) {
  const app = new App({ apiKey: process.env.ALTER_API_KEY! });
  try {
    const provider = new StripeIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
    const call = await provider.issuing.getIssuingTransactionsTransaction(input);
    const result = await call.wait();
    return result.bodyJson();
  } finally {
    await app.close();
  }
}

import os
from alter_sdk import App
from alter_sdk_stripe import StripeIntegration

async def execute(arguments):
    async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
        provider = StripeIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
        call = await provider.issuing.get_issuing_transactions_transaction(arguments)
        result = await call.wait()
        return result.body_json()

Input

Field	Type	Presence	Description and constraints
`$`	object	Root	Additional keys: not allowed
`path`	object	Required within parent	Additional keys: not allowed
`path.transaction`	string	Required within parent	Maximum length: 5000
`query`	object	Optional	Additional keys: not allowed
`query.expand`	array	Optional
`query.expand[]`	string	Each item	Maximum length: 5000

Response

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

Field	Type	Presence	Description and constraints
`$`	Model	Root	Expand Update a transaction — response body

Referenced models: Update a transaction — response body

Schemas

707 more schemas are linked from the tables above, on the schema pages.

Update a transaction — response body

Field	Type	Presence	Description and constraints
`$`	object	Root	Any use of an [issued card](https://docs.stripe.com/issuing) that results in funds entering or leaving your Stripe account, such as a completed purchase or refund, is represented by an Issuing `Transaction` object. Related guide: [Issued card transactions](https://docs.stripe.com/issuing/purchases/transactions)
`amount`	JSON	Required within parent
`amount (anyOf 1)`	integer	Alternative	The transaction amount, which will be reflected in your balance. This amount is in your currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
`amount (anyOf 2)`	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
`amount_details`	JSON	Optional
`amount_details (anyOf 1)`	JSON	Alternative	Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
`amount_details (anyOf 1) (anyOf 1)`	Model	Alternative	Expand Update a transaction — response body — amount details value atm fee, cashback amount
`amount_details (anyOf 2)`	null	Alternative
`authorization`	JSON	Optional
`authorization (anyOf 1)`	JSON	Alternative	The `Authorization` object that led to this transaction.
`authorization (anyOf 1) (anyOf 1)`	string	Alternative	Maximum length: 5000
`authorization (anyOf 1) (anyOf 2)`	Model	Alternative	Expand Update an authorization — response body
`authorization (anyOf 2)`	null	Alternative
`balance_transaction`	JSON	Optional
`balance_transaction (anyOf 1)`	JSON	Alternative	ID of the [balance transaction](https://docs.stripe.com/api/balance_transactions) associated with this transaction.
`balance_transaction (anyOf 1) (anyOf 1)`	string	Alternative	Maximum length: 5000
`balance_transaction (anyOf 1) (anyOf 2)`	Model	Alternative	Expand Retrieve a balance transaction — balance get Balance History Id — response body
`balance_transaction (anyOf 2)`	null	Alternative
`card`	JSON	Required within parent	The card used to make this transaction.
`card (anyOf 1)`	string	Alternative	Maximum length: 5000
`card (anyOf 2)`	Model	Alternative	Expand Fail a testmode card — response body
`cardholder`	JSON	Optional
`cardholder (anyOf 1)`	JSON	Alternative	The cardholder to whom this transaction belongs.
`cardholder (anyOf 1) (anyOf 1)`	string	Alternative	Maximum length: 5000
`cardholder (anyOf 1) (anyOf 2)`	Model	Alternative	Expand Create a cardholder — response body
`cardholder (anyOf 2)`	null	Alternative
`created`	JSON	Required within parent
`created (anyOf 1)`	integer	Alternative	Time at which the object was created. Measured in seconds since the Unix epoch. Format: unix-time
`created (anyOf 2)`	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
`currency`	string	Required within parent	Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). Format: currency
`dispute`	JSON	Optional
`dispute (anyOf 1)`	JSON	Alternative	If you've disputed the transaction, the ID of the dispute.
`dispute (anyOf 1) (anyOf 1)`	string	Alternative	Maximum length: 5000
`dispute (anyOf 1) (anyOf 2)`	Model	Alternative	Expand Create a dispute — response body
`dispute (anyOf 2)`	null	Alternative
`id`	string	Required within parent	Unique identifier for the object. Maximum length: 5000
`livemode`	boolean	Required within parent	If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
`merchant_amount`	JSON	Required within parent
`merchant_amount (anyOf 1)`	integer	Alternative	The amount that the merchant will receive, denominated in `merchant_currency` and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). It will be different from `amount` if the merchant is taking payment in a different currency.
`merchant_amount (anyOf 2)`	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
`merchant_currency`	string	Required within parent	The currency with which the merchant is taking payment. Format: currency
`merchant_data`	Model	Required within parent	Expand Update a transaction — response body — merchant data
`metadata`	object	Required within parent	Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Additional keys: see wildcard field
`metadata.*`	string	Additional keys	Maximum length: 500
`network_data`	JSON	Optional
`network_data (anyOf 1)`	JSON	Alternative	Details about the transaction, such as processing dates, set by the card network.
`network_data (anyOf 1) (anyOf 1)`	Model	Alternative	Expand Update a transaction — response body — network data value authorization code, processing date, transaction id
`network_data (anyOf 2)`	null	Alternative
`object`	string	Required within parent	String representing the object's type. Objects of the same type share the same value. Known values: issuing.transaction
`purchase_details`	JSON	Optional
`purchase_details (anyOf 1)`	JSON	Alternative	Additional purchase information that is optionally provided by the merchant.
`purchase_details (anyOf 1) (anyOf 1)`	Model	Alternative	Expand Update a transaction — response body — purchase details value fleet, flight, fuel, lodging, receipt, reference
`purchase_details (anyOf 2)`	null	Alternative
`token`	JSON	Optional
`token (anyOf 1)`	JSON	Alternative	[Token](https://docs.stripe.com/api/issuing/tokens/object) object used for this transaction. If a network token was not used for this transaction, this field will be null.
`token (anyOf 1) (anyOf 1)`	string	Alternative	Maximum length: 5000
`token (anyOf 1) (anyOf 2)`	Model	Alternative	Expand Update a token status — response body
`token (anyOf 2)`	null	Alternative
`treasury`	JSON	Optional
`treasury (anyOf 1)`	JSON	Alternative	[Treasury](https://docs.stripe.com/api/treasury) details related to this transaction if it was created on a [FinancialAccount](/docs/api/treasury/financial_accounts
`treasury (anyOf 1) (anyOf 1)`	Model	Alternative	Expand Update a transaction — response body — treasury value received credit, received debit
`treasury (anyOf 2)`	null	Alternative
`type`	string	Required within parent	The nature of the transaction. Known values: capture, refund
`wallet`	JSON	Optional
`wallet (anyOf 1)`	string	Alternative	The digital wallet used for this transaction. One of `apple_pay`, `google_pay`, or `samsung_pay`. Known values: apple_pay, google_pay, samsung_pay
`wallet (anyOf 2)`	null	Alternative

Referenced models: Retrieve a balance transaction — balance get Balance History Id — response body, Update an authorization — response body, Fail a testmode card — response body, Create a cardholder — response body, Create a dispute — response body, Update a token status — response body, Update a transaction — response body — amount details value atm fee, cashback amount, Update a transaction — response body — merchant data, Update a transaction — response body — network data value authorization code, processing date, transaction id, Update a transaction — response body — purchase details value fleet, flight, fuel, lodging, receipt, reference, Update a transaction — response body — treasury value received credit, received debit

Update a transaction — response body — amount details value atm fee, cashback amount

Field	Type	Presence	Description and constraints
`$`	object	Root
`atm_fee`	JSON	Optional
`atm_fee (anyOf 1)`	JSON	Alternative
`atm_fee (anyOf 1) (anyOf 1)`	integer	Alternative	The fee charged by the ATM for the cash withdrawal.
`atm_fee (anyOf 1) (anyOf 2)`	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
`atm_fee (anyOf 2)`	null	Alternative
`cashback_amount`	JSON	Optional
`cashback_amount (anyOf 1)`	JSON	Alternative
`cashback_amount (anyOf 1) (anyOf 1)`	integer	Alternative	The amount of cash requested by the cardholder.
`cashback_amount (anyOf 1) (anyOf 2)`	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
`cashback_amount (anyOf 2)`	null	Alternative

Policy, approvals and errors

SDK function policy ID: stripe.getissuingtransactionstransaction. Catalog operation: GetIssuingTransactionsTransaction. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Pinned headers: {"Stripe-Version": "2026-09-30.endive"}

Official provider source

Report an issue with this page