沙盒概览
Waffo Pancake 提供完整的沙盒环境用于开发和测试。不涉及真实资金。功能与正式环境完全一致。
测试模式 vs 正式模式
| 沙盒（测试模式） | 正式模式 |
|---|
| 交易 | 模拟 | 真实扣款 |
| 资金 | 虚拟 | 真实资金 |
| 数据 | 隔离 | 正式数据 |
| Webhooks | 完全可用 | 完全可用 |
| API 行为 | 完全一致 | 完全一致 |
切换环境
在控制台中
在控制台顶部切换测试/正式模式。
在 API 调用中
使用 X-Environment 请求头：
| 请求头值 | 模式 |
|---|
X-Environment: test | 沙盒 |
X-Environment: prod | 正式 |
在分享支付链接或部署之前，请务必确认当前所在的环境。
API 密钥
API 密钥在创建时指定了环境。使用 API Key 认证时，环境由密钥本身决定，无需 X-Environment 请求头。
测试卡号
成功支付
| 卡号 | 品牌 |
|---|
4242 4242 4242 4242 | Visa |
5555 5555 5555 4444 | Mastercard |
3782 822463 10005 | Amex |
拒绝支付
| 卡号 | 错误 |
|---|
4000 0000 0000 0002 | 被拒绝 |
4000 0000 0000 9995 | 余额不足 |
4000 0000 0000 0069 | 卡已过期 |
3D Secure
| 卡号 | 行为 |
|---|
4000 0027 6000 3184 | 需要验证 |
4000 0000 0000 3220 | 验证失败 |
测试卡可以使用任意未来的有效期和任意 3 位 CVC。
测试 Webhooks
Webhooks 在沙盒环境中正常触发。测试步骤：
- 在控制台 > 开发者中注册您的 Webhook 端点
- 切换到测试模式
- 执行会触发事件的操作（创建订单、完成支付）
- 您的端点将接收到与正式环境完全相同的 Webhook 事件
测试订阅
测试完整的订阅生命周期：
- 创建 — 通过测试结账页面订阅
- 计费 — 按计划进行扣费
- 变更 — 通过客户门户或 API 更改方案
- 取消 — 测试取消流程（在周期结束时生效）
数据隔离
测试数据与正式数据完全隔离：
- 测试商品不会出现在正式模式中
- 测试客户与正式客户相互独立
- 测试交易不会影响正式报表
上线发布
准备上线时，将商品从测试环境同步到正式环境：
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 请求头。
上线清单
