沙箱與測試
是否有獨立沙箱？
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]