沙盒与测试

​

环境信息

SDK 通过 Environment.SANDBOX / Environment.PRODUCTION 切换，无需手动修改 URL。

​

测试卡号

​

信用卡（Credit Card）

​

CC_VISA

​

CC_MASTERCARD

​

CC_JCB

​

CC_AMEX

​

借记卡（Debit Card）

​

DC_VISA

​

DC_MASTERCARD

​

DC_JCB

​

DC_AMEX

​

通用信息

​

沙盒模拟器

沙盒不连接真实渠道，通过模拟器直接控制支付结果：

• 一次性支付：创建订单后打开收银台页面，页面上直接提供”支付成功”和”支付失败”按钮，点击即可触发对应结果和 Webhook
• 订阅首期：与一次性支付相同，在收银台页面操作
• 订阅续费模拟：调用 POST /api/v1/subscription/manage 获取管理页 URL → 打开管理页 → 页面上有”模拟下期支付成功”和”模拟下期支付失败”按钮，每次点击模拟一期续费

订阅续费管理页示例：

​

支付方式测试方法

部分支付方式需要在普通沙盒支付测试之外完成专门检查。

​

八达通测试

如果你需要使用八达通测试 App 完成扫码支付测试，请参考 八达通沙箱测试支付。

​

Google Pay 测试

如果你的集成需要在收银台或自建前端中展示 Google Pay，请完成以下检查。

1. 使用一个 Google Pay 测试账号登录。
2. 将该账号加入 Google Pay test mode stub data 测试卡组。
3. 确认目标国家或地区在 Google Pay 支持国家列表 中。
4. 如果在 Android App WebView 中加载支付页，按 Google Pay Android WebView 指南 增加 WebView 配置。
5. 生产环境上线前，Android App 需要按 Google Pay 发布指南 申请 API 权限。
6. 如果生产环境未完成权限申请，用户可能看到 OR_BIBED_11 或类似错误提示。

申请生产权限时，网关类型选择 Gateway。提交材料后，如需加速审批，请将 Google 账号商户 MID 和 app name 提供给 Waffo 技术对接群。

​

Apple Pay 测试

如果你的集成需要在收银台或自建前端中展示 Apple Pay，请完成以下检查。

1. 推荐使用商户自己的 Apple Pay 账号完成测试。
2. 测试账号需绑定有效的 Visa、Mastercard 或 Amex 卡。
3. 暂不支持使用 UnionPay 卡进行 Apple Pay 测试。
4. 如出现 Service unavailable，请检查设备或账号的地区设置。
5. 使用网页端打开时可能需要全局代理；手机端通过支付链接唤起 Apple Pay 弹窗时，部分代理即可满足测试。
6. 上线前确认目标国家或地区在 Apple Pay 支持国家列表 中。

​

测试 Webhook

沙盒环境支持 Webhook 回调。确保你的 notifyUrl 可从公网访问。本地开发推荐使用内网穿透工具（如 ngrok 或 cloudflared）。