Webshop 联动指南

1. 用户信息联动

查看规格

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

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

Example

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

2. 服务器列表联动

查看规格

[Required] 当用户进入 ONEshop 详情页时，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 以确保稳定的支付处理。

• 详细说明请参考 getUnconfirmedPurchases 文档。

TIP. Webshop 实施指南

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

• 应用内购商店与 Webshop 的正确布局

• 进入 Webshop 时的正确导航路径

• 用户体验（UX）优化建议

• Webshop 详情页使用方式

• 购买次数限制处理