跳转到主要内容
沙盒环境不连接真实支付渠道，而是通过模拟器让你直接控制支付结果，快速验证集成逻辑。

​
一次性支付模拟

1

创建订单

调用 POST /api/v1/order/create 创建订单。
2

获取收银台 URL

从响应的 orderAction 中获取收银台 URL。
3

打开收银台页面

在浏览器打开收银台页面，页面上会显示模拟按钮。
4

选择支付结果

点击对应按钮模拟支付结果：
  • Payment succeeded — 模拟用户完成支付，订单状态变为 PAY_SUCCESS
  • Payment failed — 模拟支付被拒绝，订单状态变为 ORDER_CLOSE
点击后 Waffo 会自动向 notifyUrl 发送 PAYMENT_NOTIFICATION Webhook。
沙盒支付模拟器界面
沙盒收银台是模拟器界面，不会出现真实的支付方式选择或卡号输入。所有支付方式的模拟流程相同。
如果需要模拟真实的卡号输入流程（如测试 3DS），可以使用测试卡号（见下方测试卡号），但大部分场景直接使用模拟按钮即可。

​
订阅模拟

​
首期支付

与一次性支付相同：
1

创建订阅

调用 POST /api/v1/subscription/create 创建订阅。
2

打开收银台页面

从响应中获取收银台 URL 并在浏览器打开。
3

模拟首期支付

点击支付成功或支付失败按钮。首期成功后，订阅状态变为 ACTIVE，触发 SUBSCRIPTION_STATUS_NOTIFICATION。

​
模拟下期续费

订阅激活后，如果要快速测试续费（不等待真实周期到期）：
1

获取管理页 URL

调用 POST /api/v1/subscription/manage 获取管理页 URL。
{
  "subscriptionId": "SUB20260325000001"
}
2

打开管理页

在浏览器打开 managementUrl。
3

模拟续费结果

管理页上会显示两个模拟按钮：
  • 模拟下期支付成功 — 触发续费成功，发送 PAYMENT_NOTIFICATION 和 SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION
  • 模拟下期支付失败 — 触发续费失败，发送 PAYMENT_NOTIFICATION（失败）
每次点击模拟一期续费。可以多次点击测试多期场景（如第 2 期成功、第 3 期失败等）。
订阅续费管理页示例：
订阅续费模拟管理页示例

​
模拟订阅取消

在管理页上也可以执行用户侧取消操作，触发 SUBSCRIPTION_STATUS_NOTIFICATION（状态变为 USER_CANCELLED）。

​
特殊金额触发异常

以下金额仅用于沙盒验收和异常处理测试。如果你在沙盒环境中传入这些金额，Waffo 会按预设返回对应错误码。这不是生产环境规则。
以下金额来自当前验收用例模板，可用于快速复现指定异常：
场景示例金额预期结果
一次性支付创单渠道拒绝90、990、1990、19990C0005 Payment Channel Rejection
订阅创单渠道拒绝9、90、990、1990、19990C0005 Payment Channel Rejection
创单系统不可用（一次性支付 / 订阅）9.1、91、991、1991、19991C0001 System Error
创单 Unknown 状态（一次性支付 / 订阅）9.2、92、992、1992、19992E0001 Unknown Status
取消接口系统不可用（订单取消 / 订阅取消）9.3、93、993、1993、19993C0001 System Error
取消接口 Unknown 状态（订单取消 / 订阅取消）9.4、94、994、1994、19994E0001 Unknown Status
退款接口系统不可用9.5、95、995、1995、19995C0001 System Error
退款接口 Unknown 状态9.6、96、996、1996、199996E0001 Unknown Status
  • 如果你只想走正常成功 / 失败链路，请避开上述金额。
  • 幂等错误 A0011 不是特殊金额触发，而是同一请求 ID 搭配不同金额或币种触发。
  • 退款参数校验失败 A0003 不是特殊金额触发，而是退款金额超过原支付金额触发。

​
测试卡号

​
信用卡（Credit Card）

payMethodName成功卡号失败卡号
CC_VISA45767500000001104576750000000220
CC_MASTERCARD22269000000001102226900000000220
CC_JCB35280000000002143528000000120006
CC_AMEX3400000000000216340000000200027

​
借记卡（Debit Card）

payMethodName成功卡号失败卡号
DC_VISA40017000000001104001700000000220
DC_MASTERCARD22269300000001102226930000000220
DC_JCB30888500000001163088850000200004
DC_AMEX340034000100009340034000400003

​
通用信息

  • 有效期：任意未来日期
  • CVV：任意 3 位数字（AMEX 为 4 位）

​
沙箱环境信息

项目值
Base URLhttps://api-sandbox.waffo.com
SDK 配置Environment.SANDBOX
沙箱环境使用与生产环境不同的 API Key 和 RSA 密钥对。请勿混用。