# Webshop 介绍

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

ONE webshop 是基于 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. 进入 ONE webshop

若在从游戏跳转至 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 → ONE webshop</td><td>当用户进入 Webshop 详情页时，会实时查询并展示游戏 Server List。</td></tr><tr><td><a href="/pages/7B3LSYnBQqJrHvpRVtNR">有效性验证</a></td><td>Game Server → ONE webshop</td><td>验证用户输入的 Game ID 和 Server 的有效性，以及是否可以购买该 Item。</td></tr><tr><td><a href="/pages/iGxotgWabxTdtY3eHuPV#pns">PNS</a></td><td>ONE webshop → 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 → ONE webshop</td><td><p>为了确认 Item 已成功发放，必须进行 Confirm Purchases 处理。</p><p>根据目的不同，Confirm Purchases 可以使用 consume API 或 acknowledge API 之一。</p><p></p><p>✅ Item 发放后，必须进行 Confirm Purchases 处理。</p></td></tr><tr><td><a href="/pages/bqIVJxZUhS4mSwvVfNSN">用户信息联动</a> <br>(Optional)</td><td>Game App → ONE webshop</td><td><p>可以在游戏内提供跳转至 Webshop 的路径。</p><p></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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://onestore-dev.gitbook.io/dev/chi/webshop/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.