2月 21, 2026

Storefront APIのカートがギフトカードの適用をサポートしました

2月 21, 2026

Storefront API カートがギフトカードの適用をサポート

ShopifyのStorefront APIの新たなバージョン、2024-07において、カートがギフトカードの追加とクエリをサポートするようになりました。これにより、顧客はギフトカードをカートに適用し、その結果をクエリで取得することが可能になります。

技術的課題の定義と現状分析

これまでの Shopify Storefront APIでは、カートにギフトカードを適用する機能がサポートされていませんでした。これにより、顧客はギフトカードをカートで使用することができず、購入体験が制約される問題がありました。

具体的な技術的ソリューションの提案

新しいバージョンのAPIでは、カートにギフトカードを適用する機能が追加されています。具体的には、CartInputのgiftCardCodesプロパティを使用してカートの作成時にギフトカードを追加したり、カートが作成された後にcartUpdateGiftCardCodesミューテーションを実行してギフトカードを更新することが可能になりました。

実装手順とコード例


# カートの作成時にギフトカードを追加
mutation {
  cartCreate(input: {
    giftCardCodes: ["GIFT-CARD-CODE"]
  }) {
    cart {
      id
      appliedGiftCards {
        id
        balanceV2 {
          amount
          currencyCode
        }
        lastCharacters
      }
    }
  }
}

# カート作成後にギフトカードを更新
mutation {
  cartUpdateGiftCardCodes(id: "CART-ID", giftCardCodes: ["GIFT-CARD-CODE"]) {
    cart {
      id
      appliedGiftCards {
        id
        balanceV2 {
          amount
          currencyCode
        }
        lastCharacters
      }
    }
  }
}

パフォーマンス・コスト分析

この新機能により、顧客はギフトカードをカートに直接適用して購入することが可能になります。これにより、購入プロセスが簡略化され、ユーザーエクスペリエンスが向上します。また、ギフトカードの使用により、顧客が実際に支払う金額が減るため、購入意欲も高まる可能性があります。これは、売上向上に直結する大きな利点です。