---
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
---

[Back to Developer changelog](https://shopify.dev/changelog)

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
    }
  }
}
```