> For the complete documentation index, see [llms.txt](https://onestore-dev.gitbook.io/dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://onestore-dev.gitbook.io/dev/chi/webshop/overview.md).

# Webshop 介绍

## 什么是 ONEshop <a href="#id" id="id"></a>

ONEshop 是基于 ONE store 账号体系的网页支付平台。

它在 PC、iOS 和 Android 等多种环境下提供无平台限制的游戏道具支付功能，为开发者提供扩大收入的机会，并为用户提供便捷的支付体验。

***

## Webshop 流程 <a href="#id" id="id"></a>

当用户从游戏跳转到 Webshop 时，会传递其 Game ID 和 Server 信息，从而实现 ONE store 账号绑定，提供无缝的支付体验。

当用户购买道具时，Webshop 会验证用户输入的 Game ID 和 Server 信息是否有效。支付完成后，会将购买结果发送至开发者服务器以便发放道具。

<figure><img src="/files/24EDDroLE5FUZhvOiFb0" alt=""><figcaption></figcaption></figure>

### 1. 进入 ONEshop

若在从游戏跳转至 Webshop 时使用 [用户信息联动](/dev/chi/tools/webshop/app-links.md) 功能，当支持 ONE store 账号绑定时，Game ID 和 Server 信息将自动传递，用户无需额外登录即可购买道具。

<figure><img src="/files/ZDV51KZCNA5Fc5pq5YVB" alt=""><figcaption></figcaption></figure>

### 2. 购买道具

输入接收道具的 Game ID 和 Server 后，用户即可在支付页面进行支付，并可直接使用之前在 ONE store 注册的支付方式。

<figure><img src="/files/JkmnNMnnKGW1v8KsNd10" alt=""><figcaption></figcaption></figure>

***

## 入驻流程

您可以按照与移动 App 相同的方式，在 [ONE store Developer Center](https://dev.onestore.net/) 注册将在 Webshop 销售的道具并开始销售。

<figure><img src="/files/7k06wY8ASyv5nWSNYdeB" alt=""><figcaption></figcaption></figure>

### 1. 注册 Title 与 Items

请在 ONE store Developer Center 注册 Title 和 Items。无需游戏包体，仅输入 Title 信息即可。此外，为了方便大量注册道具，我们支持 In‑App Product Import 和批量注册功能。

详细指南请参考《[注册新 Title](/dev/chi/webshop/register-title.md)》与《[道具注册指南](/dev/chi/webshop/register-item.md)》文档。

<figure><img src="/files/97M83K8MhQH3NGR4bxB4" alt=""><figcaption></figcaption></figure>

### 2. 联动必备 API

为了验证购买道具用户的 Game ID 和 Server 信息是否有效，并确认 Webshop 的购买结果，必须进行 API 联动。

详细指南请参考《[Webshop 联动指南](/dev/chi/tools/webshop.md)》文档。

<table><thead><tr><th width="148.7525634765625">API</th><th width="176.912353515625">Data flow</th><th>Description</th></tr></thead><tbody><tr><td><a href="/pages/KrW624KPu4Qbf0xBDqiY">服务器列表联动</a></td><td>Game Server → ONEshop</td><td>当用户进入 Webshop 详情页时，会实时查询并展示游戏 Server List。</td></tr><tr><td><a href="/pages/7B3LSYnBQqJrHvpRVtNR">有效性验证</a></td><td>Game Server → ONEshop</td><td>验证用户输入的 Game ID 和 Server 的有效性，以及是否可以购买该 Item。</td></tr><tr><td><a href="/pages/iGxotgWabxTdtY3eHuPV#pns">PNS</a></td><td>ONEshop → Game Server</td><td>用户完成支付后，会将支付结果及相关支付信息通过 PNS Notification 发送至游戏服务器。<br><br>PNS 支持 Commercial 环境 和 Sandbox 环境。</td></tr><tr><td><a href="/pages/iGxotgWabxTdtY3eHuPV#purchase">购买确认</a></td><td>Game Server → ONEshop</td><td><p>为了确认 Item 已成功发放，必须进行 Confirm Purchases 处理。</p><p>根据目的不同，Confirm Purchases 可以使用 consume API 或 acknowledge API 之一。</p><p>✅ Item 发放后，必须进行 Confirm Purchases 处理。</p></td></tr><tr><td><a href="/pages/bqIVJxZUhS4mSwvVfNSN">用户信息联动</a><br>(Optional)</td><td>Game App → ONEshop</td><td><p>可以在游戏内提供跳转至 Webshop 的路径。</p><p>若在跳转 URL 中包含用户的 Game ID 和 Server 信息，Webshop 将自动应用 ONE store 登录状态和 Purchase Input Information，从而可以直接进行购买。<br><br>✅ 为了提供便捷的支付环境，建议使用 User Information Integration。</p></td></tr></tbody></table>

### 3. Webshop 测试

正式销售前，您可以提前验证 Webshop 页面和支付流程。

详细指南请参考《[Webshop Test](/dev/chi/webshop/test.md)》文档。

{% hint style="warning" %}
销售前必须至少进行一次 Sandbox Payment Test。
{% endhint %}

<figure><img src="/files/tzz8GPuRpNYZ22IzuN10" alt=""><figcaption></figcaption></figure>

### 4. 请求审核 ∙ 5. 开始销售

完成 Webshop 测试并在 ONE store Developer Center 提交审核请求后，待审核通过，您即可在希望的日期开始销售。

详细指南请参考《[Request for Review](/dev/chi/webshop/request-for-review.md)》文档。

<figure><img src="/files/14ClDYGOqCAzuxSW9UCg" alt=""><figcaption></figcaption></figure>