> ## 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、合作伙伴中心和 Microsoft Store REST 服务如何协同工作，支撑 XBOX 和 PC 的商务、基础游戏、DLC 等场景。

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

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

<Info>
  正在寻找 **Microsoft Store 服务到服务 REST 参考**（collections、purchase、clawback、grant、recurrences）？它位于 **API** 选项卡下的 [Microsoft Store REST API](/reference/microsoft-store-apis/index)。
</Info>

## 本节内容

<CardGroup cols={2}>
  <Card title="入门" icon="rocket" href="/publishing/xstore-commerce/xstore-initial-configuration">
    概述、产品类型、合作伙伴中心设置、测试、授权和故障排除。
  </Card>

  <Card title="基础知识" icon="cube" href="/publishing/xstore-commerce/xstore-basic-operations">
    商店基本操作、DLC、试玩、消耗品、捆绑包、DWOB 以及更新。
  </Card>

  <Card title="从你的服务管理" icon="network-wired" href="/publishing/xstore-commerce/xstore-authenticating-service">
    对服务进行身份验证、查询权益、订阅、退款以及 User Store ID。
  </Card>

  <Card title="PC 特有注意事项" icon="windows" href="/publishing/xstore-commerce/xstore-pc">
    DRM、许可证令牌、商店账号不匹配的处理，以及沙盒切换。
  </Card>

  <Card title="Microsoft Store REST API" icon="code" href="/reference/microsoft-store-apis/index">
    v8/v9 collections、purchase、clawback、grant 和 recurrences 端点的参考。完整参考现位于 **API** 选项卡下的 [Microsoft Store REST API](/reference/microsoft-store-apis/index)。
  </Card>

  <Card title="系列游戏中心" icon="sitemap" href="/publishing/game-publishing/concepts/game-publisher-insights/game-publisher-insights-faq">
    将多个产品归入同一个 Store 系列中心。
  </Card>
</CardGroup>

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

* **合作伙伴中心** — 你在其中创建产品（基础游戏、附加内容、捆绑包、季票、订阅、消耗品），定义定价与可用性，并分配标识符（**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 商务系统概述](/publishing/xstore-commerce/xstore-overview) 开始，然后阅读[选择合适的产品类型](/publishing/xstore-commerce/xstore-choosing-product-type)。


## Related topics

- [排查 XStore 开发问题](/zh-CN/publishing/xstore-commerce/xstore-troubleshooting.md)
- [基础 DRM 与许可证检查](/zh-CN/publishing/xstore-commerce/xstore-basic-drm.md)
- [启用 XStore 开发与测试](/zh-CN/publishing/xstore-commerce/xstore-product-testing-setup.md)
- [商店基本操作](/zh-CN/publishing/xstore-commerce/xstore-basic-operations.md)
- [捆绑包和季票](/zh-CN/publishing/xstore-commerce/xstore-bundles-season-passes.md)