最新更新時(shí)間：2023.08.09 版本說明
商戶發(fā)起資金出境請(qǐng)求，需要傳微信支付單號(hào)，商戶出境單號(hào)，出境金額等信息 成功，接口請(qǐng)求成功僅代表受理，如需知曉業(yè)務(wù)執(zhí)行情況請(qǐng)通過查詢接口獲取。
適用對(duì)象：電商平臺(tái)
請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/funds-to-oversea/orders
請(qǐng)求方式：POST
接口頻限：150QPS
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 商戶出境單號(hào) | out_order_id | string[1, 64] | 是 | body訂單的主鍵，唯一定義此資源的標(biāo)識(shí)，此參數(shù)只能由數(shù)字，大小寫字母_-組成。 由商戶在發(fā)起資金出境請(qǐng)求時(shí)生成，要求在同一個(gè)商戶號(hào)下唯一。 示例值：merchant_1123123 |
| 二級(jí)商戶號(hào) | sub_mchid | string[1, 64] | 是 | body申請(qǐng)資金出境的二級(jí)商戶號(hào) 示例值：123456 |
| 微信訂單號(hào) | transaction_id | string[1, 128] | 是 | body微信支付返回的支付訂單號(hào) 示例值：420000000000000010 |
| 出境金額 | amount | int | 是 | body需要出境的人民幣金額，單位：分 示例值：10 |
| 境外收款幣種 | foreign_currency | string[1, 20] | 是 | body境外收款幣種。 注：微信支付分配的收款人識(shí)別號(hào)屬性下所關(guān)聯(lián)的幣種，會(huì)校驗(yàn)該幣種字段與收款人識(shí)別號(hào)的相關(guān)性。 示例值：USD |
| + 商品信息 | goods_info | array | 否 | body必填字段，goods_info數(shù)量不能超過10個(gè) |
| + 賣家信息 | seller_info | object | 是 | body賣家信息 |
| + 物流信息 | express_info | object | 否 | body物流信息 注意：僅在預(yù)售場(chǎng)景且定金訂單需單獨(dú)出境時(shí)，該字段可不填；其他場(chǎng)景下，該字段必填 |
| + 預(yù)售信息 | presale_info | object | 否 | body 預(yù)售信息 注意：定金與尾款對(duì)應(yīng)的訂單均需在三年（1096天）內(nèi)，且定金支付人與尾款支付人需一致 |
| + 收款人信息 | payee_info | object | 是 | body收款人信息 |
{
"amount": 10,
"express_info": {
"courier_number": "curier_number_1231",
"express_company_name": "國(guó)際xxx物流"
},
"foreign_currency": "USD",
"goods_info": [
{
"goods_category": "家用電器",
"goods_name": "橘子",
"goods_quantity": 1,
"goods_unit_price": 1
}
],
"out_order_id": "merchant_1123123",
"payee_info": {
"payee_id": "ID123112312"
},
"seller_info": {
"oversea_business_name": "香港xxxx公司",
"oversea_shop_name": "香港xxx公司xxx店鋪",
"seller_id": "id2123123123"
},
"presale_info": {
"type": "DEPOSIT",
"deposit_transaction_id": "208450740201411110007820472",
"balance_transaction_id": "4208450740201411110007820472",
"total_amount": 10
},
"payee_id": {
"courier_number": "ID123112312"
},
"sub_mchid": "123456",
"transaction_id": "420000000000000010"
}
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 商戶出境單號(hào) | out_order_id | string[1, 64] | 是 | 訂單的主鍵，唯一定義此資源的標(biāo)識(shí)，此參數(shù)只能由數(shù)字，大小寫字母_-組成。 由商戶在發(fā)起資金出境請(qǐng)求時(shí)生成，要求在同一個(gè)商戶號(hào)下唯一。 示例值：merchant123123 |
| 二級(jí)商戶號(hào) | sub_mchid | string[1, 64] | 是 | 申請(qǐng)資金出境的二級(jí)商戶號(hào) 示例值：1231231 |
| 微信出境單號(hào) | order_id | string[1, 128] | 是 | 微信出境單號(hào) 示例值：42000000000_123123 |
| 出境結(jié)果 | result | string[1, 128] | 是 | 出境的結(jié)果，
枚舉值： ACCEPT：已受理 SUCCESS：出境成功 FAIL：出境失敗 示例值：ACCEPT |
| 出境失敗的原因 | fail_reason | string[1, 128] | 否 | 當(dāng)result為FAIL時(shí)，會(huì)出現(xiàn)此字段，標(biāo)明出境失敗原因，如果是SYSTEM_ERROR可以重新發(fā)起重試 失敗原因： MCHID_FROZEN：商戶已凍結(jié)，轉(zhuǎn)賬失敗 DEAL_TIMEOUT：?jiǎn)螕?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：電商平臺(tái)承擔(dān)手續(xù)費(fèi)但是未開通手續(xù)費(fèi)賬戶或者手續(xù)費(fèi)賬戶被處罰 PAYER_ACCOUNT_ABNORMAL：資金出境方賬戶異常 GOODS_INFO_ILLEGAL: 資金出境申請(qǐng)商品信息非法 FOREIGN_CURRENCY_NOT_SUPPORT: 不支持的幣種類型，請(qǐng)換幣種重試，目前僅支持八大幣種：USD、HKD、JPY、EUR、GBP、CAD、AUD、SGD PAYEE_INFO_ILLEGAL：校驗(yàn)收款人信息失敗 PRESALE_INFO_ILLEGAL：資金出境申請(qǐng)預(yù)售信息非法 示例值：DEPARTURE_AMOUNT_NO_ENOUGH |
| 請(qǐng)求出境人民幣金額 | amount | int | 是 | 需要出境的人民幣金額，單位：分 示例值：21 |
| 真實(shí)出境外幣金額 | foreign_amount | int | 否 | 真實(shí)出境的外幣金額，單位：該幣種最小計(jì)價(jià)單位，當(dāng)result為SUCCESS時(shí)有這個(gè)字段 示例值：20 |
| 外幣幣種 | foreign_currency | string[1, 20] | 是 | 出境的目標(biāo)幣種，由商戶在資金出境申請(qǐng)接口傳入。 示例值：USD |
| 匯率 | rate | int | 否 | 當(dāng)result為SUCCESS時(shí)有這個(gè)字段，標(biāo)價(jià)幣種與支付幣種的兌換比例乘以10的8次方即為此值，例如美元兌換人民幣的比例為6.5，則rate=650000000 示例值：650000000 |
| 購(gòu)匯時(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ì)購(gòu)匯時(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 | 否 | 真正出境的人民幣金額，單位：分，如果是二級(jí)商戶承擔(dān)手續(xù)費(fèi)且非收支分離，該金額=請(qǐng)求出境金額-手續(xù)費(fèi)，否則該金額=請(qǐng)求出境金額 示例值：20 |
| 手續(xù)費(fèi)人民幣金額 | fee | int | 否 | 資金出境手續(xù)費(fèi)人民幣金額，單位：分 示例值：1 |
| 手續(xù)費(fèi)承擔(dān)商戶號(hào) | charge_mchid | string[1,64] | 否 | 手續(xù)費(fèi)承擔(dān)商戶號(hào) 示例值：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 | 商戶無(wú)權(quán)限申請(qǐng)資金出境 | 商戶無(wú)權(quán)限申請(qǐng)資金出境，請(qǐng)申請(qǐng)相關(guān)權(quán)限 |
| 400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)求參數(shù)錯(cuò)誤，請(qǐng)重新檢查再調(diào)用查詢剩余可出境余額 |
| 429 | FREQUENCY_LIMITED | 請(qǐng)求頻率過高 | 請(qǐng)求頻率超過限制，請(qǐng)稍后重試；同一筆訂單2秒內(nèi)只能請(qǐng)求一次出境 注：服務(wù)商模式下是針對(duì)該接口頻限是，整個(gè)服務(wù)商維度的限制 |