Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Webshop 联动指南

1. 用户信息联动

查看规格

[Optional] 游戏内可以展示跳转至 ONE webshop 的路径。

若跳转 URL 中包含用户的游戏 ID 和服务器信息，进入 Webshop 时会自动应用 ONE store 登录状态及购买输入信息，用户即可直接完成购买。

Example

若根据游戏的隐私政策，游戏 ID 属于个人信息，则可能需要追加第三方个人信息提供同意流程

2. 服务器列表联动

查看规格

[Required] 当用户进入 ONE webshop 详情页时，Webshop 会实时查询并展示游戏服务器列表。

若道具需发放至特定服务器，开发者必须提供服务器列表查询 API。 该 API 会在 Webshop 详情页中实时调用，用户选择服务器并完成购买后，所选服务器信息将一并通过 PNS 发送。

仅当在标题注册中将以下字段设置为： Developer Center > Webshop > Main Info > Purchase Input Information = Purchase Identifier + Server时，服务器列表才会向用户显示。

Example

3. 有效性验证

查看规格

[Required] 用于验证用户输入的游戏 ID 和服务器信息是否有效，并检查该道具是否可以购买。

  • 游戏 ID 是用于标识最终接收道具的对象（用户或角色）的值。在网页商店中，该值以 serviceUserId 的形式传递。(根据游戏结构，该值可作为 UID 或角色 ID 使用。)

4. PNS (Payment Notification Service)

查看规格

[Required] 用户完成支付后，Webshop 会通过 PNS 通知将支付结果及相关支付信息发送至游戏服务器。

PNS 支持 商用环境 和 Sandbox 环境。

5. 购买确认

查看规格

[Required] 为确保道具正确发放，必须执行 购买确认 流程。

根据需求，可使用两种 API 之一进行购买确认。

API
Description

consumePurchase

  • 常用于执行购买确认。

  • 处理完成后，用户可以再次购买相同道具。

acknowledgePurchase

  • 用于一次性道具。

  • 处理完成后，用户将无法再次购买相同道具。

注意事项

  • 道具发放后必须执行购买确认。

  • 若购买确认在 3 天内未完成，该购买将被视为发放失败并自动取消。

  • 在购买确认完成之前，用户无法再次购买相同道具。

可通过 getUnconfirmedPurchases API 查询尚未完成购买确认的记录。

建议使用该 API 以确保稳定的支付处理。

TIP. Webshop 实施指南

完成 ONE webshop 接入后，请务必确认实际服务应用中的商店布局、进入路径、用户体验（UX）及运营注意事项。

Last updated