---
title: >-
  Deprecation of OrderTransaction.authorizationCode in favor of
  OrderTransaction.paymentId - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/deprecation-of-ordertransaction-authorizationcode-in-favor-of-ordertransactionpaymentid
  md: >-
    https://shopify.dev/changelog/deprecation-of-ordertransaction-authorizationcode-in-favor-of-ordertransactionpaymentid.md
metadata:
  effectiveApiVersion: null
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Deprecation Announcement
    handle: deprecation
  indicatesActionRequired: false
  createdAt: '2025-12-09T11:39:35-05:00'
  postedAt: '2025-12-12T12:00:00-05:00'
  updatedAt: '2025-12-09T16:25:43-05:00'
  effectiveAt: '2025-12-10T12:00:00-05:00'
---

December 12, 2025

Tags:

* Admin GraphQL API

# Deprecation of `OrderTransaction.authorizationCode` in favor of `OrderTransaction.paymentId`

Starting with the `2026-01` API version, the [`authorizationCode`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ordertransaction#field-OrderTransaction.fields.authorizationCode) field on the [`OrderTransaction`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ordertransaction#field-OrderTransaction) object is deprecated. We recommend using the [`paymentId`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ordertransaction#field-OrderTransaction.fields.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:

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

to:

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