测试指南
本文按商店和小游戏支付渠道介绍测试方式,并标明适用平台。测试前,请先完成 内购与支付接入,并在 世游发行平台 Console 配置待测试的商品。
世游游戏商城(Android / Windows)
本节适用于使用 世游游戏商城 的 Android 和 Windows 发行版本,两者的沙盒支付测试方式相同。使用 第三方应用商店 支付的发行版本,请按对应应用商店的要求准备测试账号并进行支付测试。
使用世游游戏商城沙盒支付前,需要由 世游 Console 管理员 根据 Combo ID,将对应账号添加为 内部测试员。
- 登录游戏,获取登录结果中的
comboId,即该账号的 Combo ID。 - 将账号的 Combo ID 提供给世游 Console 管理员,申请将该账号添加为内部测试员。
- 由世游 Console 管理员在 Console 中根据 Combo ID,将对应账号添加为内部测试员并保存。
- 待管理员确认配置完成后,使用该账号进入游戏,选择已配置的商品,并在世游游戏商城支付页面选择 沙盒支付 完成购买,检查订单状态和游戏内的到账结果。
App Store(iOS)
iOS 可通过开发签名版本或 TestFlight 版本进行沙盒支付测试:
| 测试方式 | 安装方式 | 账号准备 |
|---|---|---|
| 开发签名版本测试 | 安装并运行开发签名版本 | 向世游技术申请,由世游技术提供沙盒 Apple 账号 |
| TestFlight 测试 | 通过 TestFlight 安装测试版本 | 使用普通 Apple 账号接受测试邀请并安装游戏 |
两种版本的内购均运行在苹果沙盒环境中,不会产生真实扣款。 下文按安装方式分别介绍操作步骤。参见苹果官方文档:沙盒内购测试和 TestFlight 内购测试。
测试前准备
- 在 App Store Connect 配置待测试的内购商品,至少填写参考名称、商品 ID、本地化名称及价格。
- 确认 App Store Connect 中的商品信息与 Console 中的 商品配置 一致。
苹果沙盒测试的准备要求及配置说明,参见 沙盒内购测试。
开发签名版本测试
获取沙盒测试账号
使用开发签名版本测试前,请联系世游技术申请沙盒 Apple 账号,账号由世游技术提供。
在设备上测试
- 在测试设备上安装开发签名版本,开启 开发者模式 后运行游戏。
- 登录游戏,选择已配置的商品并尝试发起购买。
- 首次尝试购买后,可在设备 设置 > 开发者(Developer)> 沙盒 Apple 账号(Sandbox Apple Account) 中登录世游技术提供的沙盒账号。
- 返回游戏,再次发起购买并完成支付,检查游戏内的到账结果。
请勿自行修改世游提供的测试账号安全设置;遇到升级提示时,选择 其他选项 > 不升级。
操作截图

开发签名版本的沙盒测试无需退出设备上的个人 Apple 账号,也无需先将安装包上传至 App Store Connect。账号登录步骤参见苹果官方文档:使用开发签名 App 登录沙盒账号。
TestFlight 测试
准备测试版本
支付调试和测试使用 Internal Testing(内部测试) 即可。
- 将游戏构建版本上传至 App Store Connect。
- 在对应 App 的 TestFlight > Internal Testing 中,将构建版本分配给内部测试组,并邀请有该游戏访问权限的 App Store Connect 团队成员。
版本分发及邀请方式参见苹果官方文档:添加内部测试员。
安装并测试
- 在测试设备上安装 TestFlight,并使用普通 Apple 账号接受测试邀请。
- 从 TestFlight 安装游戏测试版本。
- 登录游戏,选择已配置的商品,按支付界面提示完成购买,检查游戏内的到账结果。
通过 TestFlight 安装的游戏会自动使用苹果沙盒环境,进行普通支付测试无需额外登录沙盒 Apple 账号。参见苹果官方文档:TestFlight 内购测试。
华为游戏商城(鸿蒙)
鸿蒙通过华为应用内支付服务(IAP Kit)进行沙盒支付测试,需要同时满足 已配置沙盒测试账号 和 应用使用 debug 签名 两个条件。
测试前准备
- 在 AppGallery Connect 配置待测试的内购商品,并确认与 Console 中的商品配置一致。
- 向世游侧提供测试用的真实华为账号,由世游完成沙盒测试账号配置,待确认配置生效后再进行测试。
- 准备使用 debug 签名 的游戏测试版本,并按华为要求配置调试证书、调试设备、调试 Profile 和公钥指纹。
在设备上测试
- 在测试设备上登录已添加的沙盒华为账号,安装并运行测试版本。
- 登录游戏,选择已配置的商品并发起购买。
- 确认华为支付页面显示 沙盒测试提示 后,按页面指引完成购买,检查订单状态和游戏内的到账结果。沙盒购买仍可能要求绑定付款方式,但不会产生真实扣费。
账号配置、签名要求及沙盒提示说明,参见华为官方文档:沙盒测试。
小游戏(WebGL)
WebGL 小游戏的支付测试方式取决于 小游戏渠道和运行平台。测试前,请联系世游技术确认当前项目使用的支付方式及环境配置。
微信小游戏
| 测试场景 | 支付环境 |
|---|---|
| Android 米大师支付 | 支持沙箱环境,测试前请联系世游技术确认项目已配置为沙箱支付 |
| iOS 苹果支付 | 仅支持现网环境,不支持沙箱,会产生真实扣费 |
- 确认小游戏已开通相应支付能力,待测试商品已完成配置;使用现网环境时,需确认道具已在微信后台发布。
- 使用微信开发者工具的预览或真机调试功能,在目标平台的设备上进入小游戏。
- 登录游戏,选择待测试商品并完成支付。
- 检查订单状态和游戏内的到账结果;取消支付时,确认游戏未发放商品。
支付接口说明参见微信官方文档:道具直购支付。遇到支付错误时,参见内购与支付常见问题中的 701001 错误和 2860 错误。
抖音小游戏
Combo SDK 抖音小游戏使用道具直购模式,iOS 和 PC 端通过抖音钻石支付完成购买。Android/PC 和 iOS 使用的支付接口均不支持沙盒环境,真机测试会产生实际扣费或钻石消耗。
- 确认小游戏已开通对应支付能力;iOS 钻石支付还需开通钻石兑换能力,并在抖音小游戏后台配置客服账号。
- 使用抖音开发者工具的 预览/真机调试 功能,在目标平台进入小游戏。
- 登录游戏,选择小额商品,按支付页面指引完成购买。
- 检查订单状态和游戏内的到账结果。