線上支付開發文檔
錯誤碼
錯誤碼描述


名稱 描述 原因 解決方案
sub_appid and sub_openid not match 商戶公眾號appid和用戶openid不匹配 1.沒有提供所用的商戶號和對應公眾號的appid由服務商在微信後台配置綁定
2.有綁定好但在調用接口時傳的參數sub_openid的值有誤(sub_openid參數的值不是用對應公眾號appid獲取)
如果是沒有綁定,商戶方提供正式的商戶號和appid進行綁定;檢查是否用對公眾號appid和用戶openid
受理機構必須傳入sub_mch_id 受理機構必須傳入sub_mch_id 商戶號沒有在微信後台報備好識別碼或報備好沒有匹配正確 提供所用商戶號聯繫平台處理
受理關係不存在 受理關係不存在 商戶號匹配的識別碼通道有誤 提供所用商戶號聯繫平台處理
消費超過該商戶支持的限額 調用支付時金額超出商戶支持的限額 商戶號有可能會有限額,比如測試號不能超過1元 金額傳值時不要超過限額
sub_openid is invalid sub_openid參數的值無效 sub_openid參數對應的值是用戶openID,傳錯或者有丟失字符 仔細檢查用戶openID值,傳入正確的值
valid error 驗證商戶交易權限 商戶請求的支付類型異常或單筆金額異常 檢查商戶配置是否正確
transaction internal error 第三方接口調用 第三方接口調用網絡異常 檢查服務器網絡/聯繫第三方是否有網絡抖動
unsupportapi 不支持的交易類型 商戶請求的支付類型異常 驗證上送的交易類型字段
valid mch'groupno fail 通過父級商戶號和子商戶號獲取子商戶 商戶上送的父級商戶號校驗不通過 驗證上送的父級商戶號是否正確
Internal error 支付網關返回狀態非200 系統可能異常 聯繫管理員排查
valid sign fail 驗證數據簽名 商戶上送簽名異常 商戶檢查密鑰是否正確
valid ser​​vice fail 驗證支付業務 商戶交易權限不足 檢查商戶配置是否正確
valid mch status fail 該商戶已經被凍結 商戶接口被凍結 檢查商戶配置是否正確
valid pay gateway result no sign 返回結果失敗 支付網關返回結果沒有簽名信息 業務處理失敗
refundInfo is exists 該退款請求已存在 商戶退款單號重複 商戶檢查請求參數是否正確
notify internal error[100590014546] 商戶號100590014546通知異常 商戶上送的通知地址不可達 商戶檢查網絡狀況
valid param fail 請求參數不合法 商戶請求參數格式不正確 商戶檢查請求參數是否正確
valid flow fail 請求過於頻繁 商戶調用接口過於頻繁 降低請求頻率
Order not exists 訂單不存在 商戶訂單號不正確或者與所用訂單號不是該商戶號的
valid mch status fail 商戶狀態異常 商戶被關停 與客服聯繫
Auth valid fail 授權驗證失敗

Order paid 訂單已支付 訂單已支付
Signature error 簽名錯誤,參數簽名結果不正確 所用商戶號和密鑰不匹配,簽名參數本身有誤或排序有誤等 仔細檢查簽名算法和密鑰
total_fee:Invalid 金額無效,金額單位是分,不能有小數點
檢查total_fee
total_fee:Must be greater or equal to [1] 金額必須大於等於1
檢查total_fee
xxxx:This field is required 文檔必填參數沒有傳,xxxx表示文檔中必填為是的參數 文檔必填參數沒有傳,xxxx表示文檔中必填為是的參數 檢查必填字段是否有傳入或者必填參數名是否有誤
Parse xml error,please use UTF-8 encoded xml參數解析出錯,且編碼格式必須utf-8
檢查編碼格式或xml格式
total_fee:Must be less or equal to [5000000] 金額必須小於或等於5000000
檢查total_fee
unsupported sign method 不支持的簽名方法
檢查sign_type
*:Maximum length is [*] 字段超長
請檢查字段的長度
商戶不存在

請檢查mch_id
渠道不存在

請檢查渠道sign_agentno
父商戶不存在

請檢查groupno
父級商戶號無交易權限

父級商戶無法發起交易
您的請求過於頻繁

您的請求過於頻繁
商戶無法單獨發起交易

已授權渠道的商戶無法單獨發起交易
商戶被凍結

業務方面溝通解除凍結
授權關係不存在

請檢查sign_agentno
父級商戶錯誤

請檢查groupno
Merchant not found

請檢查mch_id
該接口目前未開放

該接口目前未開放
商戶未開通[%s]支付類型 接口權限未開放

支付類型參數錯誤

支付類型參數錯誤
商戶[%s],不支持[%s]交易類型 商戶未開通支付類型

商戶[%s]配置缺少參數[partner]

商戶配置不完整
支付類型[%s]未開通

支付類型[%s]未開通
buyer_logon_id|buyer_id is required 缺少參數
請檢查buyer_logon_id|buyer_id
BALANCE_NOT_ENOUGH

餘額不足
thi_mch_id is required

商戶配置不完整
透傳第三方錯誤碼:


名稱 描述 原因 解決方案
USERPAYING 用戶支付中,需要輸入密碼 該筆交易因為業務規則要求,需要用戶輸入支付密碼。 等待5秒,然後調用被掃訂單結果查詢API,查詢當前訂單的不同狀態,決定下一步的操作。
NOTENOUGH 餘額不足 用戶的零錢餘額不足 請收銀員提示用戶更換當前支付的卡,然後請收銀員重新掃碼。建議:商戶系統返回給收銀台的提示為“用戶餘額不足.提示用戶換卡支付”
ORDERPAID 訂單已支付 訂單號重複 請確認該訂單號是否重複支付,如果是新單,請使用新訂單號提交
REFUNDINFOTEXIST 退款已存在

ORDERNOTEXIST 訂單不存在

ACQ.TRADE_NOT_EXIST 支付寶.交易不存在

AUTH_CODE_INVALID 授權碼檢驗錯誤 收銀員掃描的不是微信支付的條碼 請掃描微信支付被掃條碼/二維碼
OUT_TRADE_NO_USED 商戶訂單號重複 同一筆交易不能多次提交 請核實商戶訂單號是否重複提交
ACCOUNTERROR 賬戶錯誤

ORDERSTATUSERROR 訂單狀態異常

ORDERISEXIST 訂單已存在

ORDERREVERSED 訂單已撤銷 當前訂單已經被撤銷 當前訂單狀態為“訂單已撤銷”,請提示用戶重新支付
ORDER_SUCCESS_PAY_INPROCESS


RULELIMIT


SYSTEMERROR 接口返回錯誤 系統超時 請立即調用被掃訂單結果查詢API,查詢當前訂單狀態,並根據訂單的狀態決定下一步的操作。
REFUND_FEE_INVALID 退款金額錯誤