錯誤碼
介面出錯時 HTTP 狀態碼仍然是 200,回傳內容裡的 code 不是 0:
json
{ "code": 40005, "message": "Request IP 203.0.113.10 is not in the merchant whitelist" }message 是英文說明,可能帶上具體的值,請按 code 判斷,不要按 message 的文字判斷。
錯誤碼列表
| code | 含義 | 怎麼處理 |
|---|---|---|
| 0 | 成功 | |
| 400 | 業務失敗,常見的是 USDT 餘額不足、收款通道請求失敗、操作失敗 | 看 message;餘額不足先充值 |
| 500 | 平台內部錯誤(message 固定為「請求發生錯誤」) | 稍後重試;涉及下單、出款的,先用查詢訂單確認有沒有建成,再決定是否重試 |
| 40000 | 解密失敗,或者缺少必填參數(商戶訂單號、cardId、查詢時間段等,message 會說明) | 檢查公鑰是否最新、填充方式是否 PKCS#1 v1.5、參數是否齊全 |
| 40001 | 商戶號不存在 | 檢查 merchantNo |
| 40002 | 商戶已停用 | 聯繫平台 |
| 40003 | 商戶沒有開通開放介面 | 聯繫平台 |
| 40004 | 沒有設定回調地址 | 在商戶後台設定回調地址,或下單時傳 callbackUrl |
| 40005 | 請求 IP 不在白名單 | 把伺服器出口 IP 加進商戶後台的 IP 白名單 |
| 40007 | 商戶訂單號重複 | 換一個新的商戶訂單號;如果是超時後重試,先查一下原訂單 |
| 40010 | 不支援這個法幣(不存在或已停用) | 檢查 currencyType |
| 40011 | 沒有可用的匹配池 | 聯繫平台 |
| 40012 | 暫時沒有能接這個金額的交易員,或金額不在可下單範圍 | 換個金額或稍後再試 |
| 40013 | 可用額度不足 | 換個金額或稍後再試 |
| 40015 | 客戶在黑名單,或屬於平台不支援的客戶 / 地區 | 不要再為這個客戶下單 |
| 40016 | 不支援這個收款方式 | 用查詢收款方式查可用的編號 |
| 40017 | 商戶沒有開通這個法幣 | 聯繫平台開通 |
| 40018 | 收款資訊不符合這個收款方式的要求(message 會說明哪一項) | 按查詢收款方式回傳的欄位要求填寫 |
| 40019 | 金額不對:必須大於 0、最多兩位小數 | 修正金額 |
| 40020 | 訂單不存在 | 檢查商戶訂單號;只能查到自己商戶的訂單 |
| 40021 | 訂單當前狀態不能做這個操作(比如已經付款的單不能取消) | 先查詢訂單狀態 |
| 40023 | cardId 不是這筆訂單分到的收款卡 | 只能用自建收銀台下單回傳的 cards 裡的 cardId |
網路超時怎麼辦
下單、出款介面超時(沒拿到回傳)時,不要直接換一個商戶訂單號重新下單。先用原來的商戶訂單號查詢訂單:查到了說明已經建成;回傳 40020 再用同一個商戶訂單號重試,平台會用 40007 擋住重複的單。