跳转到主要内容

​
测试一切，不破坏任何东西。

在没有真实交易的情况下构建和测试整个集成。无真实扣款，无真实付款，只有安全的实验。

安全

没有真实资金流动。

完整功能

一切与正式模式相同。

​
测试 vs 正式

测试模式正式模式
交易模拟真实扣款
资金虚拟真实资金
数据隔离生产环境
Webhooks完全正常完全正常
API 行为完全相同完全相同
切换模式： 控制台顶部切换按钮，或在 API 调用中使用 X-Environment 请求头。
请求头值模式
X-Environment: test测试模式
X-Environment: prod正式模式
在分享支付链接前，请始终确认您处于正确的模式。

​
API Key 按环境区分

API Key 在创建时指定环境（测试或生产）。在控制台创建 API Key 时，您需要选择密钥所属的环境。
环境用途
测试开发和测试
生产真实支付
API Key 使用密钥对认证，而非带前缀的密钥字符串。详见 认证。

​
测试卡号

​
成功付款

卡号品牌
4242 4242 4242 4242Visa
5555 5555 5555 4444Mastercard
3782 822463 10005Amex

​
拒绝付款

卡号错误
4000 0000 0000 0002被拒绝
4000 0000 0000 9995余额不足
4000 0000 0000 0069卡已过期

​
3D 安全验证

卡号行为
4000 0027 6000 3184需要验证
4000 0000 0000 3220验证失败
任意未来的过期日期，任意 3 位 CVC。

​
测试支付方式

​
数字钱包

测试模式显示模拟界面：
  • Apple Pay — Safari/iOS
  • Google Pay — Chrome/Android

​
测试 Webhooks

Webhooks 在测试模式下正常触发。要测试您的 webhook 端点：
  1. 在控制台 —> 开发者 中注册 webhook 端点
  2. 切换到测试模式
  3. 执行触发事件的操作（创建订单、完成支付）
  4. 您的端点会像正式模式一样收到 webhook 事件

​
测试订阅

测试完整的生命周期：
  1. 创建 — 通过测试结账页订阅
  2. 计费 — 计费按计划发生（使用短间隔加快测试）
  3. 更新 — 通过客户门户或 API 更换方案
  4. 取消 — 测试取消流程
  5. 过期 — 验证订阅过期行为

​
测试数据

​
隔离

测试数据完全独立：
  • 测试产品不会出现在正式模式
  • 测试客户是独立的
  • 测试交易不影响正式报表

​
环境同步

准备上线时，将产品从测试环境一键发布到生产环境： 
curl -X POST https://waffo-pancake-auth-service.vercel.app/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 处理
  • 在移动设备上测试结账
  • 绑定银行账户（财务 —> 付款设置）
  • 完成商业信息（设置 —> 商业详情）
  • 检查产品定价
  • 使用 publish-product 将产品从测试同步到生产

快速入门

完整的上线检查清单。