Skip to content

錯誤碼 ​

介面出錯時 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訂單當前狀態不能做這個操作(比如已經付款的單不能取消)先查詢訂單狀態
40023cardId 不是這筆訂單分到的收款卡只能用自建收銀台下單回傳的 cards 裡的 cardId

網路超時怎麼辦

下單、出款介面超時(沒拿到回傳)時,不要直接換一個商戶訂單號重新下單。先用原來的商戶訂單號查詢訂單:查到了說明已經建成;回傳 40020 再用同一個商戶訂單號重試,平台會用 40007 擋住重複的單。