本页内容
测试
在交互式文档演练场中走通真实的沙箱账单和 webhook 投递路径。
Playground 标签页走真实的沙箱路径。它通过商户 API 创建账单、确认付款选择、触发选定的沙箱结果，并等待投递工作进程调用你的激活端点。
它不会直接向你的 URL POST 一个编造的事件。事件由正常沙箱操作所用的同一套 outbox、签名、超时、重试和投递代码处理。
前置条件
- 把控制台切到沙箱。
- 选择一个至少启用了一个测试代币的项目。
- 创建一个激活的沙箱 Payment API key。
- 注册一个激活的沙箱 webhook 端点。
- 让该 HTTPS 端点可从公网访问。
Playground 有意禁用生产发送。
可用场景
| 场景 | 产生的事件 |
|---|---|
| 精确付款 | invoice.paid |
| 多付 | invoice.paid_over |
| 最终少付 | invoice.underpaid |
| 取消 | invoice.cancelled |
打开 控制台 → 开发者 → 文档：同一个页面，Playground 标签页就在指南上方。选定事件类型、金额和币种，然后点击模拟。响应面板显示最终的商户 API 调用。Paymos 观测到 webhook 尝试后显示投递状态。
排查一次测试
打开 控制台 → 开发者 → Webhook，检查事件和每一次投递尝试。先对比这些值：
X-Webhook-Id与负载中的event_id。- 收到的原始 body 与传给你验证器的字节。
- 端点的响应状态和响应时间，对照 投递策略。
- 端点的沙箱密钥与你服务器使用的密钥。
修好接收方后，从事件详情页重放该事件。重放保持相同的事件 ID，因此你的幂等防线依然有效。