---
title: OrderTransaction - GraphQL Admin
description: >-
  The `OrderTransaction` object represents a payment transaction that's
  associated with an order. An order

  transaction is a specific action or event that happens within the context of
  an order, such as a customer paying

  for a purchase or receiving a refund, or other payment-related activity.


  Use the `OrderTransaction` object to capture the complete lifecycle of a
  payment, from initial

  authorization to final settlement, including refunds and currency exchanges.
  Common use cases for using the

  `OrderTransaction` object include:


  - Processing new payments for orders

  - Managing payment authorizations and captures

  - Processing refunds for returned items

  - Tracking payment status and errors

  - Managing multi-currency transactions

  - Handling payment gateway integrations


  Each `OrderTransaction` object has a
  [`kind`](https://shopify.dev/docs/api/admin-graphql/latest/enums/OrderTransactionKind)

  that defines the type of transaction and a
  [`status`](https://shopify.dev/docs/api/admin-graphql/latest/enums/OrderTransactionStatus)

  that indicates the current state of the transaction. The object stores
  detailed information about payment

  methods, gateway processing, and settlement details.


  Learn more about [payment
  processing](https://help.shopify.com/manual/payments)

  and [payment gateway
  integrations](https://www.shopify.com/ca/payment-gateways).
api_version: 2026-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderTransaction'
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderTransaction.md
---

# Order​Transaction

object

Requires `read_orders` access scope or `read_marketplace_orders` access scope.

The `OrderTransaction` object represents a payment transaction that's associated with an order. An order transaction is a specific action or event that happens within the context of an order, such as a customer paying for a purchase or receiving a refund, or other payment-related activity.

Use the `OrderTransaction` object to capture the complete lifecycle of a payment, from initial authorization to final settlement, including refunds and currency exchanges. Common use cases for using the `OrderTransaction` object include:

* Processing new payments for orders
* Managing payment authorizations and captures
* Processing refunds for returned items
* Tracking payment status and errors
* Managing multi-currency transactions
* Handling payment gateway integrations

Each `OrderTransaction` object has a [`kind`](https://shopify.dev/docs/api/admin-graphql/latest/enums/OrderTransactionKind) that defines the type of transaction and a [`status`](https://shopify.dev/docs/api/admin-graphql/latest/enums/OrderTransactionStatus) that indicates the current state of the transaction. The object stores detailed information about payment methods, gateway processing, and settlement details.

Learn more about [payment processing](https://help.shopify.com/manual/payments) and [payment gateway integrations](https://www.shopify.com/ca/payment-gateways).

## Fields

* accountNumber
* amountRoundingSet
* amountSet
* authorizationExpiresAt
* createdAt
* currencyExchangeAdjustment
* device
* errorCode
* fees
* formattedGateway
* gateway
* id
* kind
* location
* manuallyCapturable
* manualPaymentGateway
* maximumRefundableV2
* multiCapturable
* order
* parentTransaction
* paymentDetails
* paymentIcon
* paymentId
* processedAt
* receiptJson
* settlementCurrency
* settlementCurrencyRate
* shopifyPaymentsSet
* status
* test
* totalUnsettledSet
* user

### Deprecated fields

* amount: deprecated
* amountV2: deprecated
* authorizationCode: deprecated
* maximumRefundable: deprecated
* paymentMethod: deprecated
* totalUnsettled: deprecated
* totalUnsettledV2: deprecated

***

## Map

### Fields and connections with this object

* [CashTrackingSession.cashTransactions](https://shopify.dev/docs/api/admin-graphql/latest/objects/CashTrackingSession#field-CashTrackingSession.fields.cashTransactions)
* [Order.transactions](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order#field-Order.fields.transactions)
* [OrderPaymentStatus.transactions](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderPaymentStatus#field-OrderPaymentStatus.fields.transactions)
* [OrderTransaction.parentTransaction](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderTransaction#field-OrderTransaction.fields.parentTransaction)
* [OrderTransactionConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/OrderTransactionConnection#returns-nodes)
* [OrderTransactionEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderTransactionEdge#field-OrderTransactionEdge.fields.node)
* [Refund.transactions](https://shopify.dev/docs/api/admin-graphql/latest/objects/Refund#field-Refund.fields.transactions)
* [Return.transactions](https://shopify.dev/docs/api/admin-graphql/latest/objects/Return#field-Return.fields.transactions)
* [SubscriptionBillingAttempt.transactions](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingAttempt#field-SubscriptionBillingAttempt.fields.transactions)
* [SuggestedOrderTransaction.parentTransaction](https://shopify.dev/docs/api/admin-graphql/latest/objects/SuggestedOrderTransaction#field-SuggestedOrderTransaction.fields.parentTransaction)

### Possible type in

* [Store​Credit​Account​Transaction​Origin](https://shopify.dev/docs/api/admin-graphql/latest/unions/StoreCreditAccountTransactionOrigin)

***

## Mutations

* orderCapture
* transactionVoid

***

## OrderTransaction Mutations

### Mutated by

* [order​Capture](https://shopify.dev/docs/api/admin-graphql/latest/mutations/orderCapture)
* [transaction​Void](https://shopify.dev/docs/api/admin-graphql/latest/mutations/transactionVoid)

***

## Interfaces

* Node

***

## OrderTransaction Implements

### Implements

* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)