Skip to main content

Documentation Index

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

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

​
沙盒概览

Waffo Pancake 提供完整的沙盒环境用于开发和测试。不涉及真实资金。功能与正式环境完全一致。

安全

不涉及真实资金。

功能完整

与正式环境完全一致。

​
测试模式 vs 正式模式

沙盒（测试模式）正式模式
交易模拟真实扣款
资金虚拟真实资金
数据隔离正式数据
Webhooks完全可用完全可用
API 行为完全一致完全一致

​
切换环境

​
在控制台中

在控制台顶部切换测试/正式模式。

​
在 API 调用中

使用 X-Environment 请求头：
请求头值模式
X-Environment: test沙盒
X-Environment: prod正式
在分享支付链接或部署之前，请务必确认当前所在的环境。

​
API 密钥

API 密钥在创建时指定了环境。使用 API Key 认证时，环境由密钥本身决定，无需 X-Environment 请求头。

​
测试卡号

​
成功支付

卡号类型
4576 7500 0000 0110Visa 信用卡
2226 9000 0000 0110Mastercard 信用卡
4001 7000 0000 0110Visa 借记卡
2226 9300 0000 0110Mastercard 借记卡

​
拒绝支付

卡号类型
4576 7500 0000 0220Visa 信用卡
2226 9000 0000 0220Mastercard 信用卡
4001 7000 0000 0220Visa 借记卡
2226 9300 0000 0220Mastercard 借记卡
任意未来有效期，任意 3 位 CVC。

​
测试 Webhooks

Webhooks 在沙盒环境中正常触发。测试步骤：
  1. 在控制台 > 开发者中注册您的 Webhook 端点
  2. 切换到测试模式
  3. 执行会触发事件的操作（创建订单、完成支付）
  4. 您的端点将接收到与正式环境完全相同的 Webhook 事件

​
测试订阅

测试完整的订阅生命周期：
  1. 创建 — 通过测试结账页面订阅
  2. 计费 — 按计划进行扣费
  3. 变更 — 通过客户门户或 API 更改方案
  4. 取消 — 测试取消流程（在周期结束时生效）

​
数据隔离

测试数据与正式数据完全隔离：
  • 测试商品不会出现在正式模式中
  • 测试客户与正式客户相互独立
  • 测试交易不会影响正式报表

​
上线发布

准备上线时，将商品从测试环境同步到正式环境： 
curl -X POST https://api.waffo.ai/v1/actions/onetime-product/publish-product \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_TOKEN" \
  -d '{
    "id": "product-uuid"
  }'
publish-product 端点是从测试到生产的单向操作，不需要 X-Environment 请求头。

​
上线清单

  • 在沙盒中完成端到端测试
  • 测试边界情况（被拒绝的卡、支付失败）
  • 验证 Webhook 处理逻辑
  • 在移动设备上测试结账流程
  • 完善企业信息
  • 核实商品定价
  • 将商品从测试环境同步到正式环境