Webshop 联动指南
ONE webshop 服务即将上线。 我们提前发布本指南,便于您在正式上线前预览主要内容。

1. 用户信息联动
游戏内可以展示跳转至 ONE webshop 的路径。
若跳转 URL 中包含用户的游戏 ID 和服务器信息,进入 Webshop 时会自动应用 ONE store 登录状态及购买输入信息,用户即可直接完成购买。
若根据游戏的隐私政策,游戏 ID 属于个人信息,则可能需要追加第三方个人信息提供同意流程
2. 服务器列表联动
当用户进入 ONE webshop 详情页时,Webshop 会实时查询并展示游戏服务器列表。
若道具需发放至特定服务器,开发者必须提供服务器列表查询 API。 该 API 会在 Webshop 详情页中实时调用,用户选择服务器并完成购买后,所选服务器信息将一并通过 PNS 发送。
仅当在标题注册中将以下字段设置为:
Developer Center > Webshop > Main Info > Purchase Input Information = Purchase Identifier + Server时,服务器列表才会向用户显示。
3. 有效性验证
用于验证用户输入的游戏 ID 和服务器信息是否有效,并检查该道具是否可以购买。
4. PNS (Payment Notification Service)
用户完成支付后,Webshop 会通过 PNS 通知将支付结果及相关支付信息发送至游戏服务器。
PNS 支持 商用环境 和 Sandbox 环境。
5. 购买确认
为确保道具正确发放,必须执行 购买确认 流程。
根据需求,可使用两种 API 之一进行购买确认。
consumePurchase
常用于执行购买确认。
处理完成后,用户可以再次购买相同道具。
acknowledgePurchase
用于一次性道具。
处理完成后,用户将无法再次购买相同道具。
注意事项
道具发放后必须执行购买确认。
若购买确认在 3 天内未完成,该购买将被视为发放失败并自动取消。
在购买确认完成之前,用户无法再次购买相同道具。
Last updated



