`GiftCardCashOutTransaction` is now resolvable from `GiftCardTransaction`

Shopify Introduces GiftCardCashOutTransaction Type in GraphQL Admin API

Shopify has added a new transaction type to the GraphQL Admin API starting with version 2026-07. The GiftCardCashOutTransaction type now serves as a distinct variant of the GiftCardTransaction interface, specifically representing transactions where gift card balances are paid out through point of sale systems.

Changes from Previous API Versions

In API versions 2026-04 and earlier, POS gift card cash-out transactions were classified under the GiftCardDebitTransaction type. The new GiftCardCashOutTransaction type separates these cash-out operations into their own category, providing more granular transaction classification.

Impact on Shopify App Developers

Developers working with gift card transactions need to update their GraphQL queries to handle the new transaction type. Apps that process or display gift card transaction histories must now account for GiftCardCashOutTransaction as a possible return type when querying the GiftCardTransaction interface.

This change affects apps that:

• Track gift card balance changes
• Generate financial reports involving gift cards
• Integrate with POS systems
• Display transaction histories to merchants

Implementation Considerations

Developers should review their existing code that handles GiftCardDebitTransaction objects. When migrating to API version 2026-07 or later, queries must include logic to resolve GiftCardCashOutTransaction types. Apps maintaining backward compatibility with older API versions will need to handle both the legacy GiftCardDebitTransaction classification and the new GiftCardCashOutTransaction type depending on the API version in use.

Read the full announcement →