Skip to main content
XStore API 是以 GDK 建置之 XBOX 和 PC 遊戲在 Microsoft Store 商務中的執行階段端。XStore API 搭配 Partner Center (您在此建立產品模型) 和 Microsoft Store 服務對服務 (S2S) REST API (您的後端在此查詢和授與權利),為您提供完整的商務平台,涵蓋基礎遊戲、DLC、試用版、消耗性產品、訂閱和組合包。 本節對應 Microsoft Learn 上的主題配置,涵蓋為您的遊戲設計、整合、測試和營運商店商務所需的一切。
在尋找 Microsoft Store 服務對服務 REST 參考 (collections、purchase、clawback、grant、recurrences) 嗎?它位於 API 索引標籤下的 Microsoft Store REST API。

本節內容

開始使用

概觀、產品類型、Partner Center 設定、測試、授權和疑難排解。

基本概念

基本商店作業、DLC、試用版、消耗性產品、組合包、DWOB 和更新。

從您的服務管理

驗證服務、查詢權利、訂閱、退款和 User Store ID。

PC 專屬考量

DRM、授權權杖、不相符商店帳戶處理,以及沙箱切換。

Microsoft Store REST API

v8/v9 collections、purchase、clawback、grant 和 recurrences 端點的參考。完整參考現在位於 API 索引標籤下的 Microsoft Store REST API。

系列遊戲中心

將多個產品歸類在單一商店系列中心之下。

全貌:各部分如何連結

  • Partner Center — 您在此建立產品 (基礎遊戲、附加元件、組合包、季票、訂閱、消耗性產品)、定義定價和供應情況,並指派識別碼 (StoreId、Product ID、BigId、SKU ID)。
  • MicrosoftGame.config — 隨附於您的遊戲套件中,並透過 TitleId、StoreId 和 MSAAppId 將執行中的可執行檔繫結至商店產品。
  • XStore 執行階段 API (XStore*) — 從遊戲發出的用戶端呼叫,用於列舉產品、查詢授權和權利、顯示購買 UI,以及回報消耗性產品履行。
  • XPackage API (XPackage*) — 掛接選用套件 (DLC) 並為其授權、安裝區塊,以及觀察套件狀態變更。
  • Microsoft Store S2S REST API — 您的後端呼叫的伺服器端端點,用於權威性地查詢權利、履行消耗性產品、授與產品、查閱訂閱,以及處理退款/撤銷。
  • User Store ID (UserStoreId) — 短期金鑰,您的遊戲透過 XUserGetTokenAndSignatureAsync (或 XStoreGetUserCollectionsIdAsync / XStoreGetUserPurchaseIdAsync) 取得並交給您的服務,讓服務能代表該使用者呼叫商店。

用戶端與服務

幾乎每個商店案例都同時有用戶端 (XStore) 和服務端 (S2S REST) 路徑。使用用戶端提供即時使用者體驗 (顯示購買按鈕、解除鎖定內容、回報消耗性產品花費);當權威性很重要時則使用服務 (履行必須在遊戲重新安裝後仍保留的虛擬貨幣花費、授與促銷項目、偵測 Game Pass、處理退款)。 可靠的模式:
  1. 用戶端偵測到購買或花費,並顯示即時使用者體驗。
  2. 用戶端將 UserStoreId 傳送至您的服務。
  3. 服務呼叫商店 S2S API 以確認權利或履行消耗性產品,並更新您的記錄資料庫。

後續步驟

如果您是 XStore 新手,請從 GDK 商務系統概觀開始,然後閱讀選擇正確的產品類型。
Last modified on October 6, 2026