Deprecation of OrderTransaction.authorizationCode in favor of OrderTransaction.paymentId

Starting with the 2026-01 API version, the authorizationCode field on the OrderTransaction object is deprecated. We recommend using the paymentId field instead.

The paymentId field provides a consistent, standardized identifier for payment reconciliation across all payment providers on Shopify. Adopting paymentId ensures your integration relies on the most stable and supported field for tracking and reconciling transactions, regardless of the underlying payment gateway.

Warning: paymentId returns a Shopify-specific identifier, which differs from the provider-specific value in authorizationCode. Ensure your systems are updated to store and reconcile using this new ID format.

Recommended migration

Developers should update their queries to use the paymentId field when accessing OrderTransaction objects in the Admin GraphQL API. Replace instances of authorizationCode with paymentId. By making these changes, you ensure your app relies on the standard identifier for payment transactions.

For example, update your query from:

query TransactionDetails {
  order(id: "gid://shopify/Order/12345") {
    transactions {
      id
      authorizationCode
    }
  }
}

to:

query TransactionDetails {
  order(id: "gid://shopify/Order/12345") {
    transactions {
      id
      paymentId
    }
  }
}