根據(jù)微信支付單號+商戶出境單號,查詢出境結果,出境失敗會返回錯誤碼
# 接口說明
支持商戶:
【普通服務商】
請求方式:
【GET】/v3/funds-to-oversea/orders/{out_order_id}
請求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ,指引點擊查看
# 請求參數(shù)
- Authorization 必填 string請參考 簽名認證 生成認證信息
- Accept 必填 string請設置為
application/json
Header HTTP頭參數(shù)
- out_order_id 必填 string(64)【商戶出境單號】 本次需要查詢的商戶出境單號,由商戶在發(fā)起資金出境請求時生成。
Path 路徑參數(shù)
- sub_mchid 必填 string(64)【二級商戶號】 申請資金出境的二級商戶號
- transaction_id 必填 string(64)【微信支付訂單號】 微信支付返回的支付訂單號
Query 查詢參數(shù)
請求示例
GET
# 應答參數(shù)
- out_order_id 必填 string(64)【商戶出境單號】 訂單的主鍵,唯一定義此資源的標識,此參數(shù)只能由數(shù)字,大小寫字母_-組成。
由商戶在發(fā)起資金出境請求時生成,要求在同一個商戶號下唯一。 - sub_mchid 必填 string(64)【二級商戶號】 申請資金出境的二級商戶號
- order_id 必填 string(128)【微信出境單號】 微信出境單號
- result 必填 string(128)【出境結果】 出境的結果, 枚舉值:
* ACCEPT:已受理
* SUCCESS:出境成功
* FAIL:出境失敗 - fail_reason 選填 string(128)【出境失敗的原因】 當result為FAIL時,會出現(xiàn)此字段,標明出境失敗原因,如果是SYSTEM_ERROR可以重新發(fā)起重試
失敗原因:
* MCHID_FROZEN:商戶已凍結,轉賬失敗
* DEAL_TIMEOUT:單據(jù)已過期
* TRADE_SUIT:交易訂單被交易投訴凍結
* DEPARTURE_AMOUNT_NO_ENOUGH:剩余可出境金額不足
* BASIC_AMOUNT_NO_ENOUGH:商戶基本戶余額不足
* PAYMENT_NOT_SUPPORT_DEPARTURE:該筆訂單不支持出境
* OUT_ORDER_ID_DUPLICATE:同一個out_order_id用于不同的支付訂單
* RISK_CONTROL:訂單被風控攔截
* SYSTEM_ERROR:系統(tǒng)失敗
* FEE_ACCOUNT_NOT_OPEN:電商平臺承擔手續(xù)費但是未開通手續(xù)費賬戶或者手續(xù)費賬戶被處罰
* PAYER_ACCOUNT_ABNORMAL:資金出境方賬戶異常
* GOODS_INFO_ILLEGAL: 資金出境申請商品信息非法
* FOREIGN_CURRENCY_NOT_SUPPORT: 不支持的幣種類型,請換幣種重試,目前僅支持八大幣種:USD、HKD、JPY、EUR、GBP、CAD、AUD、SGD
* PAYEE_INFO_ILLEGAL:校驗收款人信息失敗
* PRESALE_INFO_ILLEGAL:資金出境申請預售信息非法
* 示例值:DEPARTURE_AMOUNT_NO_ENOUGH - amount 必填 integer【請求出境人民幣金額】 需要出境的人民幣金額,單位:分
- foreign_amount 選填 integer【真實出境外幣金額】 真實出境的外幣金額,單位:該幣種最小計價單位,當result為SUCCESS時有這個字段
- foreign_currency 必填 string(20)【外幣幣種】 出境的目標幣種,由商戶在資金出境申請接口傳入。
- rate 選填 integer【匯率】 當result為SUCCESS時有這個字段,標價幣種與支付幣種的兌換比例乘以10的8次方即為此值,例如美元兌換人民幣的比例為6.5,則rate=650000000
- exchange_rate_time 選填 string(64)【購匯時間】 當result為SUCCESS時有這個字段。遵循rfc3339標準格式,格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE,yyyy-MM-DD表示年月日,T出現(xiàn)在字符串中,表示time元素的開頭,HH:mm:ss表示時分秒,TIMEZONE表示時區(qū)(+08:00表示東八區(qū)時間,領先UTC 8小時,即北京時間)。例如:2015-05-20T13:29:35+08:00表示,北京時間2015年5月20日 13點29分35秒。
- estimate_exchange_rate_time 選填 string(64)【預計購匯時間】 當result為ACCEPT時可能有這個字段,以實際結果為準。
遵循rfc3339標準格式,格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE,yyyy-MM-DD表示年月日,T出現(xiàn)在字符串中,表示time元素的開頭,HH:mm:ss表示時分秒,TIMEZONE表示時區(qū)(+08:00表示東八區(qū)時間,領先UTC 8小時,即北京時間)。例如:2015-05-20T13:29:35+08:00表示,北京時間2015年5月20日 13點29分35秒。 - departure_amount 選填 integer【真實出境人民幣金額】 真正出境的人民幣金額,單位:分,如果是二級商戶承擔手續(xù)費且非收支分離,該金額=請求出境金額-手續(xù)費,否則該金額=請求出境金額
- fee 選填 integer【手續(xù)費人民幣金額】 資金出境手續(xù)費人民幣金額,單位:分
- charge_mchid 選填 string(64)【手續(xù)費承擔商戶號】 手續(xù)費承擔商戶號
- charge_account_type 選填 string【手續(xù)費承擔賬戶】 基本賬戶或者手續(xù)費賬戶
可選取值:BASIC
: 基本賬戶FEES
: 手續(xù)費賬戶
200OK
應答示例
200 OK
# 錯誤碼
# 公共錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數(shù)錯誤 | 請根據(jù)錯誤提示正確傳入?yún)?shù) |
400 | INVALID_REQUEST | HTTP 請求不符合微信支付 APIv3 接口規(guī)則 | 請參閱 接口規(guī)則 |
401 | SIGN_ERROR | 驗證不通過 | 請參閱 簽名常見問題 |
500 | SYSTEM_ERROR | 系統(tǒng)異常,請稍后重試 | 請稍后重試 |
# 業(yè)務錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
403 | NO_AUTH | 商戶無權限申請資金出境 | 商戶無權限申請資金出境,請申請相關權限 |