> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XStore 商務概觀

> 了解 XStore API、Partner Center 和 Microsoft Store REST 服務如何為 XBOX 和 PC 商務、基礎遊戲、DLC 等搭配運作。

**XStore** API 是以 GDK 建置之 XBOX 和 PC 遊戲在 Microsoft Store 商務中的執行階段端。XStore API 搭配 Partner Center (您在此建立產品模型) 和 Microsoft Store 服務對服務 (S2S) REST API (您的後端在此查詢和授與權利)，為您提供完整的商務平台，涵蓋基礎遊戲、DLC、試用版、消耗性產品、訂閱和組合包。

本節對應 Microsoft Learn 上的主題配置，涵蓋為您的遊戲設計、整合、測試和營運商店商務所需的一切。

<Info>
  在尋找 **Microsoft Store 服務對服務 REST 參考** (collections、purchase、clawback、grant、recurrences) 嗎？它位於 **API** 索引標籤下的 [Microsoft Store REST API](/zh-TW/reference/microsoft-store-apis/index)。
</Info>

## 本節內容

<CardGroup cols={2}>
  <Card title="開始使用" icon="rocket" href="/zh-TW/publishing/xstore-commerce/xstore-initial-configuration">
    概觀、產品類型、Partner Center 設定、測試、授權和疑難排解。
  </Card>

  <Card title="基本概念" icon="cube" href="/zh-TW/publishing/xstore-commerce/xstore-basic-operations">
    基本商店作業、DLC、試用版、消耗性產品、組合包、DWOB 和更新。
  </Card>

  <Card title="從您的服務管理" icon="network-wired" href="/zh-TW/publishing/xstore-commerce/xstore-authenticating-service">
    驗證服務、查詢權利、訂閱、退款和 User Store ID。
  </Card>

  <Card title="PC 專屬考量" icon="windows" href="/zh-TW/publishing/xstore-commerce/xstore-pc">
    DRM、授權權杖、不相符商店帳戶處理，以及沙箱切換。
  </Card>

  <Card title="Microsoft Store REST API" icon="code" href="/zh-TW/reference/microsoft-store-apis/index">
    v8/v9 collections、purchase、clawback、grant 和 recurrences 端點的參考。完整參考現在位於 **API** 索引標籤下的 [Microsoft Store REST API](/zh-TW/reference/microsoft-store-apis/index)。
  </Card>

  <Card title="系列遊戲中心" icon="sitemap" href="/zh-TW/publishing/game-publishing/concepts/game-publisher-insights/game-publisher-insights-faq">
    將多個產品歸類在單一商店系列中心之下。
  </Card>
</CardGroup>

## 全貌：各部分如何連結

* **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 商務系統概觀](/zh-TW/publishing/xstore-commerce/xstore-overview)開始，然後閱讀[選擇正確的產品類型](/zh-TW/publishing/xstore-commerce/xstore-choosing-product-type)。


## Related topics

- [XStore](/reference/system/xstore/xstore_members.md)
- [服務 C API 概觀 - PFLocalization.h](/zh-TW/services/playfab/api-references/c/pflocalization/pflocalization_members.md)
- [服務 C API 概觀 - PFStatistics.h](/zh-TW/services/playfab/api-references/c/pfstatistics/pfstatistics_members.md)
- [服務 C API 概觀 - PFLeaderboards.h](/zh-TW/services/playfab/api-references/c/pfleaderboards/pfleaderboards_members.md)
- [服務 C API 概觀 - PFPlatformSpecific.h](/zh-TW/services/playfab/api-references/c/pfplatformspecific/pfplatformspecific_members.md)
