测试一切,不破坏任何东西。
在没有真实交易的情况下构建和测试整个集成。无真实扣款,无真实付款,只有安全的实验。安全
没有真实资金流动。
完整功能
一切与正式模式相同。
测试 vs 正式
切换模式: 控制台顶部切换按钮,或在 API 调用中使用
X-Environment 请求头。
API Key 按环境区分
API Key 在创建时指定环境(测试或生产)。在控制台创建 API Key 时,您需要选择密钥所属的环境。API Key 使用密钥对认证,而非带前缀的密钥字符串。详见 认证。
测试卡号
成功付款
拒绝付款
任意未来有效期,任意 3 位 CVC。
测试支付方式
数字钱包
测试模式显示模拟界面:- Apple Pay — Safari/iOS
- Google Pay — Chrome/Android
测试 Webhooks
Webhooks 在测试模式下正常触发。要测试您的 webhook 端点:- 在控制台 —> API 与开发 中注册 webhook 端点
- 切换到测试模式
- 执行触发事件的操作(创建订单、完成支付)
- 您的端点会像正式模式一样收到 webhook 事件
测试订阅
测试完整的生命周期:- 创建 — 通过测试收银台页订阅
- 计费 — 计费按计划发生(使用短间隔加快测试)
- 更新 — 通过客户门户或 API 更换方案
- 取消 — 测试取消流程
- 过期 — 验证订阅过期行为
测试数据
隔离
测试数据完全独立:- 测试产品不会出现在正式模式
- 测试客户是独立的
- 测试交易不影响正式报表
环境同步
准备上线时,将产品从测试环境一键发布到生产环境:publish-product 端点是从测试到生产的单向操作,不需要
X-Environment 请求头。上线检查清单
在接受真实付款之前:- 完成端到端测试
- 测试边界情况(拒绝的卡、失败)
- 验证 webhook 处理
- 在移动设备上测试收银台
- 添加提款账户(提款账户页)
- 完成商业信息(设置 —> 商业详情)
- 检查产品定价
- 使用 publish-product 将产品从测试同步到生产
快速入门
完整的上线检查清单。