適用對象：電商平臺
請求URL：https://api.mch.weixin.qq.com/v3/funds-to-oversea/orders/{out_order_id}
請求方式：GET
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 商戶出境單號 | out_order_id | string[1, 64] | 是 | path本次需要查詢的商戶出境單號，由商戶在發(fā)起資金出境請求時(shí)生成。 示例值：merchant123123 |
| 二級商戶號 | sub_mchid | string[1, 64] | 是 | query申請資金出境的二級商戶號 示例值：1231231 |
| 微信支付訂單號 | transaction_id | string[1, 128] | 是 | query微信支付返回的支付訂單號 示例值：4200000000000 |
https://api.mch.weixin.qq.com/v3/funds-to-oversea/orders/merchant123123?sub_mchid=1231231&transaction_id=4200000000000
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 商戶出境單號 | out_order_id | string[1, 64] | 是 | 訂單的主鍵，唯一定義此資源的標(biāo)識，此參數(shù)只能由數(shù)字，大小寫字母_-組成。 由商戶在發(fā)起資金出境請求時(shí)生成，要求在同一個(gè)商戶號下唯一。 示例值：merchant123123 |
| 二級商戶號 | sub_mchid | string[1, 64] | 是 | 申請資金出境的二級商戶號 示例值：1231231 |
| 微信出境單號 | order_id | string[1, 128] | 是 | 微信出境單號 示例值：42000000000_123123 |
| 出境結(jié)果 | result | string[1, 128] | 是 | 出境的結(jié)果，
枚舉值： ACCEPT：已受理 SUCCESS：出境成功 FAIL：出境失敗 示例值：ACCEPT |
| 出境失敗的原因 | fail_reason | string[1, 128] | 否 | 當(dāng)result為FAIL時(shí)，會出現(xiàn)此字段，標(biāo)明出境失敗原因，如果是SYSTEM_ERROR可以重新發(fā)起重試 失敗原因： MCHID_FROZEN：商戶已凍結(jié)，轉(zhuǎn)賬失敗 DEAL_TIMEOUT：單據(jù)已過期 TRADE_SUIT：交易訂單被交易投訴凍結(jié) DEPARTURE_AMOUNT_NO_ENOUGH：剩余可出境金額不足 BASIC_AMOUNT_NO_ENOUGH：商戶基本戶余額不足 PAYMENT_NOT_SUPPORT_DEPARTURE：該筆訂單不支持出境 OUT_ORDER_ID_DUPLICATE：同一個(gè)out_order_id用于不同的支付訂單 RISK_CONTROL：訂單被風(fēng)控?cái)r截 SYSTEM_ERROR：系統(tǒng)失敗 FEE_ACCOUNT_NOT_OPEN：電商平臺承擔(dān)手續(xù)費(fèi)但是未開通手續(xù)費(fèi)賬戶或者手續(xù)費(fèi)賬戶被處罰 PAYER_ACCOUNT_ABNORMAL：資金出境方賬戶異常 GOODS_INFO_ILLEGAL: 資金出境申請商品信息非法 FOREIGN_CURRENCY_NOT_SUPPORT: 不支持的幣種類型，請換幣種重試，目前僅支持八大幣種：USD、HKD、JPY、EUR、GBP、CAD、AUD、SGD PAYEE_INFO_ILLEGAL：校驗(yàn)收款人信息失敗 PRESALE_INFO_ILLEGAL：資金出境申請預(yù)售信息非法 示例值：DEPARTURE_AMOUNT_NO_ENOUGH |
| 請求出境人民幣金額 | amount | int | 是 | 需要出境的人民幣金額，單位：分 示例值：21 |
| 真實(shí)出境外幣金額 | foreign_amount | int | 否 | 真實(shí)出境的外幣金額，單位：該幣種最小計(jì)價(jià)單位，當(dāng)result為SUCCESS時(shí)有這個(gè)字段 示例值：20 |
| 外幣幣種 | foreign_currency | string[1, 20] | 是 | 出境的目標(biāo)幣種，由商戶在資金出境申請接口傳入。 示例值：USD |
| 匯率 | rate | int | 否 | 當(dāng)result為SUCCESS時(shí)有這個(gè)字段，標(biāo)價(jià)幣種與支付幣種的兌換比例乘以10的8次方即為此值，例如美元兌換人民幣的比例為6.5，則rate=650000000 示例值：650000000 |
| 購匯時(shí)間 | exchange_rate_time | string[1, 64] | 否 | 當(dāng)result為SUCCESS時(shí)有這個(gè)字段。遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss表示時(shí)分秒，TIMEZONE表示時(shí)區(qū)（+08:00表示東八區(qū)時(shí)間，領(lǐng)先UTC 8小時(shí)，即北京時(shí)間）。例如：2015-05-20T13:29:35+08:00表示，北京時(shí)間2015年5月20日 13點(diǎn)29分35秒。 示例值：2015-05-20T13:29:35+08:00 |
| 預(yù)計(jì)購匯時(shí)間 | estimate_exchange_rate_time | string[1, 64] | 否 | 當(dāng)result為ACCEPT時(shí)可能有這個(gè)字段，以實(shí)際結(jié)果為準(zhǔn)。 遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss表示時(shí)分秒，TIMEZONE表示時(shí)區(qū)（+08:00表示東八區(qū)時(shí)間，領(lǐng)先UTC 8小時(shí)，即北京時(shí)間）。例如：2015-05-20T13:29:35+08:00表示，北京時(shí)間2015年5月20日 13點(diǎn)29分35秒。 示例值：2015-05-20T13:29:35+08:00 |
| 真實(shí)出境人民幣金額 | departure_amount | int | 否 | 真正出境的人民幣金額，單位：分，如果是二級商戶承擔(dān)手續(xù)費(fèi)且非收支分離，該金額=請求出境金額-手續(xù)費(fèi)，否則該金額=請求出境金額 示例值：20 |
| 手續(xù)費(fèi)人民幣金額 | fee | int | 否 | 資金出境手續(xù)費(fèi)人民幣金額，單位：分 示例值：1 |
| 手續(xù)費(fèi)承擔(dān)商戶號 | charge_mchid | string[1,64] | 否 | 手續(xù)費(fèi)承擔(dān)商戶號 示例值：1231231 |
| 手續(xù)費(fèi)承擔(dān)賬戶 | charge_account_type | string | 否 | 基本賬戶或者手續(xù)費(fèi)賬戶 BASIC：基本賬戶 FEES：手續(xù)費(fèi)賬戶 示例值：BASIC |
{
"amount": 21,
"charge_account_type": "BASIC",
"charge_mchid": "1231231",
"departure_amount": 20,
"estimate_exchange_rate_time": "2015-05-20T13:29:35+08:00",
"exchange_rate_time": "2015-05-20T13:29:35+08:00",
"fail_reason": "DEPARTURE_AMOUNT_NO_ENOUGH",
"fee": 1,
"foreign_amount": 20,
"foreign_currency": "USD",
"order_id": "42000000000_123123",
"out_order_id": "merchant123123",
"rate": 650000000,
"result": "ACCEPT",
"sub_mchid": "1231231"
}
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 403 | NO_AUTH | 商戶無權(quán)限申請資金出境 | 商戶無權(quán)限申請資金出境，請申請相關(guān)權(quán)限 |
| 400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請求參數(shù)錯(cuò)誤，請重新檢查再調(diào)用查詢剩余可出境余額 |