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

# GDK 商务系统概述

> 了解 XStore API、Partner Center 和 Microsoft Store REST 服务如何协同工作，支撑 XBOX 和 PC 的商务、基础游戏、DLC 等场景。

**XStore** API 是 Microsoft Store 商务在 XBOX 和基于 GDK 构建的 PC 游戏上的运行时端。加上 Partner Center（在其中建模你的产品）和 Microsoft Store 服务到服务 (S2S) REST API（你的后端在其中查询并授予权益），它们共同为基础游戏、DLC、试玩、消耗品、订阅和捆绑包提供了完整的商务平台。

本节参照 Microsoft Learn 上的主题布局，涵盖你设计、集成、测试和运营游戏 Store 商务所需的全部内容。

> [!NOTE]
>
> 正在寻找 **Microsoft Store 服务到服务 REST 参考**（collections、purchase、clawback、grant、recurrences）？它位于 **API** 选项卡下的 [Microsoft Store REST API](https://docs.xbox.com/zh-CN/reference/microsoft-store-apis/index.md)。

## 本节内容

> [card] [入门](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-initial-configuration.md)
>
> 概述、产品类型、Partner Center 设置、测试、授权和故障排除。

> [card] [基础知识](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-basic-operations.md)
>
> 商店基本操作、DLC、试玩、消耗品、捆绑包、DWOB 以及更新。

> [card] [从你的服务管理](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-authenticating-service.md)
>
> 对服务进行身份验证、查询权益、订阅、退款以及 User Store ID。

> [card] [PC 特有注意事项](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-pc.md)
>
> DRM、许可证令牌、商店账号不匹配的处理，以及沙盒切换。

> [card] [Microsoft Store REST API](https://docs.xbox.com/zh-CN/reference/microsoft-store-apis/index.md)
>
> v8/v9 collections、purchase、clawback、grant 和 recurrences 端点的参考。完整参考现位于 **API** 选项卡下的 [Microsoft Store REST API](https://docs.xbox.com/zh-CN/reference/microsoft-store-apis/index.md)。

> [card] [系列游戏中心](https://docs.xbox.com/zh-CN/publishing/game-publishing/concepts/game-publisher-insights/game-publisher-insights-faq.md)
>
> 将多个产品归入同一个 Store 系列中心。

## 全景：各部分如何协同工作

* **Partner Center** — 你在其中创建产品（基础游戏、附加内容、捆绑包、季票、订阅、消耗品），定义定价和可用性，并分配标识符（**StoreId**、**Product ID**、**BigId**、**SKU ID**）。
* **`MicrosoftGame.config`** — 随游戏包一起发布，通过 `TitleId`、`StoreId` 和 `MSAAppId` 将运行的可执行文件与 Store 产品绑定。
* **XStore 运行时 API (`XStore*`)** — 从游戏发起的客户端调用，用于枚举产品、查询许可证与权益、显示购买 UI，以及报告消耗品履约。
* **XPackage API (`XPackage*`)** — 挂载并授权可选包（DLC）、安装区块，并观察包状态变化。
* **Microsoft Store S2S REST API** — 你的后端调用的服务端端点，用于权威地查询权益、履约消耗品、发放产品、查找订阅以及处理退款/追索。
* **User Store ID (UserStoreId)** — 一种短期密钥，你的游戏通过 `XUserGetTokenAndSignatureAsync`（或 `XStoreGetUserCollectionsIdAsync` / `XStoreGetUserPurchaseIdAsync`）获得，然后交给你的服务，让服务可以代表该用户调用 Store。

## 客户端与服务

几乎每种 Store 场景都同时有 **客户端**（XStore）和 **服务端** (S2S REST) 路径。使用客户端处理实时 UX（显示购买按钮、解锁内容、上报一次消耗品消费）；当权威性重要时使用服务端（例如：履约一次必须在游戏重装后仍生效的虚拟货币消费、发放促销物品、检测 Game Pass、处理退款）。

一个可靠的模式：

1. 客户端检测到购买或消费并显示即时 UX。
2. 客户端向你的服务发送 UserStoreId。
3. 服务调用 Store S2S API 确认权益或履约消耗品，并更新你的记录数据库。

## 下一步

如果你不熟悉 XStore，请从 [GDK 商务系统概述](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-overview.md) 开始，然后阅读[选择合适的产品类型](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-choosing-product-type.md)。


## Related topics

- [GDK 商务系统概述](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-overview.md)
- [XStoreQueryGameLicenseAsync](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequerygamelicenseasync.md)
- [XStoreQueryAssociatedProductsAsync](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequeryassociatedproductsasync.md)
- [技术功能](https://docs.xbox.com/zh-CN/publishing/game-publishing/concepts/properties-technical-capabilities.md)
- [基于消耗品的生态系统](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-consumables.md)