从 GraphQL Admin API 2026-07 版本开始,[GiftCardCashOutTransaction](https://shopify.dev/docs/api/admin-graphql/2026-07/objects/GiftCardCashOutTransaction 类型作为 Gift Card Transaction 接口的新变体被引入。 GiftCardTransaction 该类型专门表示通过销售点(POS)系统支付礼品卡余额的交易。
在之前的API版本(如2026-04及更早版本)中,这些交易被归类为GiftCardDebitTransaction。从2026-07版本开始,它们被识别为GiftCardCashOutTransaction。为了准确区分取现交易与信用和借记交易,请在查询giftCard.transactions时使用__typename字段。
以下是一个示例查询:
giftCard(id: "...") { transactions(first: 10) { nodes { __typename ... on GiftCardCashOutTransaction { id amount { amount currencyCode } } } } }
