沙箱与测试
是否有独立沙箱？
v1.2 暂不提供独立沙箱环境。请用你的真实账号在生产环境进行小额测试。
| 项 | 值 |
|---|---|
| 生产 base URL | https://api.coinepay.net |
| 沙箱 base URL | 暂无 |
| 开发自建 | http://localhost:8801（仅本地） |
推荐测试流程
1. 准备一对专用测试凭证
不要用生产凭证测试。在控制台为测试场景生成独立的 AppID/Secret。
2. 用 webhook.site 接收 webhook
https://webhook.site 提供免费的临时 webhook 接收 URL，能看到完整请求头/体。
bash
# 浏览器打开 webhook.site，复制顶部的 unique URL，例如：
WEBHOOK_URL="https://webhook.site/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
# 通过控制台或 set_webhook 接口设置3. 跑通"列卡头 → 列配置 → apply → webhook → info"
这是最完整的 happy path。详见 快速开始。
4. 测试金额建议
| 项 | 建议 |
|---|---|
| 首充 | 选择最便宜的套餐（通常 $5-10） |
| 测试充值 | 最小金额（套餐里的 min_recharge） |
| 多次测试 | 每次开新卡 —— 销卡有费用 |
当前可用的 card_type
| card_type | 说明 |
|---|---|
virtual_l | 虚拟卡 - L 类 |
virtual_p | 虚拟卡 - P 类 |
virtual_v | 虚拟卡 - V 类（VISA） |
virtual_r | 虚拟卡 - R 类 |
virtual_g | 虚拟卡 - G 类 |
virtual_a | 虚拟卡 - A 类 |
实际可用 card_type 由账号决定
不是所有账号都开通了所有 card_type。调用 card_headers/list 看到的 header_id 才是你能 apply 的范围，不要硬编码。
凭证管理
| 项 | 说明 |
|---|---|
| 凭证有效期 | 不过期（除非主动 reset / disable） |
| 凭证数量 | 每个用户最多 1 条（v1） |
| Reset 后 | 旧 SECRET 立即失效，AppID 不变 |
| Disable 后 | 401 invalid_credentials；可随时 enable |
测试 webhook 验签
把 webhook.site 收到的请求复制下来，本地用 Webhook 验签代码走一遍，确认 verify_ok = true。
何时联系支持
| 现象 | 联系前自查 |
|---|---|
| 401 一直返回 | 见 鉴权页 401 错误处理 |
| Webhook 一直收不到 | 检查 webhook URL 是否公网 HTTPS、防火墙、5 秒响应、看 webhook_events/list 状态 |
开卡卡在 pending | 是异步的，等 webhook；超过 30 分钟未变更联系支持 |
| 充值无响应 | 看 webhook_events/list 状态；查 transaction_id |
支持邮箱：[email protected]