跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://waffo.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

​
一次性支付模拟

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）。

​
测试卡号

​
信用卡（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 密钥对。请勿混用。