Webshop 联动指南

circle-check

1. 用户信息联动

查看规格

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

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

chevron-rightExamplehashtag
circle-exclamation

2. 服务器列表联动

查看规格

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

circle-info

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

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

chevron-rightExample hashtag

3. 有效性验证

查看规格

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

4. PNS (Payment Notification Service)

查看规格

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

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

5. 购买确认

查看规格

为确保道具正确发放,必须执行 购买确认 流程。

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

API
Description

consumePurchase

  • 常用于执行购买确认。

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

acknowledgePurchase

  • 用于一次性道具。

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

circle-exclamation

Last updated