使用本页测试你的集成，不要假设未公开支持的环境或密钥类型。
当前环境模型
| 项目 | 当前行为 |
|---|
| 生产 API | https://api.kyren.top |
| 生产 API 密钥前缀 | kyren_live_ |
| 自助测试密钥 | 商户控制台目前不提供 |
| Staging 访问 | 仅在 Kyren 提供 Base URL 和凭证后可用 |
除非 Kyren 已向你提供对应环境的凭证，否则不要向任意 Staging URL 发送测试流量。
测试 API 密钥
使用目标环境实际签发的 API 密钥：
curl https://api.kyren.top/v1/products \
-H "x-api-key: kyren_live_xxxxxxxxxxxxxxxxxxxx"
测试卡号
只有在 Kyren 已向你提供 Staging 或可测试环境，或为你的商户启用可测试支付网关时，才应使用以下卡号。不要假设这些卡号会在生产收银台中产生确定性的测试结果。
| 卡号 | 行为 |
|---|
4242 4242 4242 4242 | 支付成功 |
4000 0000 0000 0002 | 卡被拒绝 |
4000 0000 0000 9995 | 余额不足 |
- 使用任意未来的过期日期（如
12/28）
- 使用任意 3 位 CVV（如
123）
- 使用任意持卡人姓名
- 使用任意账单地址
测试微信支付 / 支付宝
二维码支付行为取决于商户绑定的网关配置。验证异步状态更新时，请使用 Kyren 为目标环境提供的凭证，或配合回调模拟。
测试 Webhook
在本地测试 Webhook 时，可以使用 ngrok 等隧道工具暴露本地服务器：
# 启动本地 Webhook 处理服务
node server.js # 监听 3000 端口
# 在另一个终端创建隧道
ngrok http 3000
https://abc123.ngrok.io/webhooks/kyren
正式上线前，记得将 Webhook URL 更新为你的生产环境端点。
上线检查清单
切换到生产环境前，请确保你已经完成以下步骤：
替换 API 密钥
使用 api.kyren.top 对应的生产密钥
更新接口地址
如果 Kyren 向你提供了 Staging Base URL，请从该地址切换到 api.kyren.top
更新 Webhook URL
在控制台中设置生产环境的 Webhook 端点
验证 Webhook 签名
确保你的服务器正确验证 X-Kyren-Signature 请求头
优雅处理错误
测试各种错误场景，确保你的应用能正确处理
