狀態與錯誤碼:

訂單狀態

欄位: status狀態
說明
0待支付
訂單已建立，等待鏈上到賬
1已支付
鏈上到賬並確認，已觸發非同步通知
2手動補單
後臺人工確認收款，同樣會觸發非同步通知
3已過期
超過 expiry_time 仍未支付

業務錯誤碼

欄位: code提示
常見原因 / 處理建議
0訂單建立失敗
系統異常，可稍後重試
1訂單建立成功
訂單已建立，等待鏈上到賬
10000apikey 錯誤
apikey 為空、無效或商戶被停用；檢查 URL 中的 apikey
10001
請求方法錯誤
下單介面只支援 POST
10002
參數不能為空
未提交表單參數或格式不正確
10003
商戶不存在或已停用
檢查 merchant_id參數
10004
簽名錯誤
簽名原文順序、值格式或 secret_key 不一致；檢查是否有空值/額外參數
10005
缺少必填參數
按提示補齊對應欄位
10006
支付類型錯誤
普通商戶僅支援 pay_mode=1；2 僅體驗商戶可用
10007
數量不合法
amount 超出商戶最小 / 最大單筆金額
10008
回調地址必須為合法的 http/https 連結
檢查 notify_url / return_url
10009
自定義參數必須為字串
parameters 不能是陣列、物件或 JSON 字串
10010
自定義參數長度不能超過 200 個字元
精簡 parameters
10011
訂單已支付
同一 merchant_order 的原單已支付 / 手動補單，請勿重複下單
10012
訂單已存在
同一 merchant_order 已存在待支付或已過期訂單；過期請換新單號
10013
請求頻率過快，請稍後再試
觸發風控
10014
商戶餘額不足
預付服務費餘額不足，請先儲值
10015
鏈 ID / 代幣類型不存在或已停用
該鏈 + 代幣組合未開啟；用渠道介面查詢重新整理
10016
address_id 參數格式不正確
僅支援數字或逗號分隔的數字
10017
address_id 參數錯誤
包含不存在或不屬於當前商戶的錢包
10018
指定的收款地址均不可用
指定錢包已停用 / 不支援該鏈代幣 / 超限額
10019
暫無符合限額要求 / 代幣類型的收款地址
商戶無可用錢包，或錢包單筆 / 日累計限額已滿
10020
指定收款地址暫無可用小數位 / 暫無可用地址
同地址同鏈同幣種同金額的待支付訂單過多，稍後重試或增加地址
提示

請以 code 作為程式判斷依據，不要把 msg 寫死做邏輯判斷。