本地货币支持礼品卡现已在 GraphQL 管理 API 中提供

从 API 版本 2026-07 开始，GraphQL Admin API 支持本地货币礼品卡。您可以创建以特定货币发行的礼品卡产品，并控制买家是否可以在不同货币之间兑换这些礼品卡。如果您的应用直接创建礼品卡，请从已弃用的 initialValue 字段迁移到 initialAmount。

变更内容

使用新的 giftCardProductSet 突变来创建和更新礼品卡产品。输入包括 issuanceCurrency 和 crossCurrencyRedeemable，并自动将产品的礼品卡设置应用于其变体。您只能在创建产品时设置 issuanceCurrency 和 crossCurrencyRedeemable；之后无法更改任一字段。

通过 Product.giftCardSettings 检查产品的设置。如果 issuanceCurrency 为 null，Shopify 将以商店的货币发行该产品的礼品卡。如果设置了 issuanceCurrency，Shopify 将以指定货币发行礼品卡，并且买家只能在该货币下购买该产品。仅在支持该货币的市场中发布这些产品。

crossCurrencyRedeemable 跨货币兑换控制各货币的兑换行为：

• 如果 crossCurrencyRedeemable 为 false，发行的礼品卡将使用 NONE 的 crossCurrencyRedemptionStrategy。
• 如果 crossCurrencyRedeemable 为 true 且产品没有发行货币，礼品卡将使用 MARKET_FX。
• 如果 crossCurrencyRedeemable 为 true 且产品有发行货币，礼品卡将使用 SPOT_FX。

礼品卡创建现在接受 initialAmount，它取代了已弃用的 initialValue 字段。initialAmount 包含金额和货币。查询 GiftCard.isRedeemable 和 GiftCard.crossCurrencyRedemptionStrategy 以检查礼品卡是否可兑换以及如何处理跨货币转换。

操作指南

1. 如果您使用 giftCardCreate 创建礼品卡，请在升级到 2026-07 之前将 initialValue 替换为 initialAmount。
2. 如果您提供多货币商店，请决定新的礼品卡产品是否应固定到单个发行货币。在创建产品时配置 issuanceCurrency 和 crossCurrencyRedeemable；之后无法更改任一字段。
3. 更新兑换流程以读取 GiftCard.crossCurrencyRedemptionStrategy，以便向商家和买家展示准确的跨货币转换行为。

相关文档

• giftCardProductSet 突变
• GiftCard 对象
• Product.giftCardSettings
• GiftCardCrossCurrencyRedemptionStrategy 枚举