最新更新時(shí)間：2022.04.19 版本說(shuō)明
電商收付通中，針對(duì)多次請(qǐng)求出境的場(chǎng)景，商家需要查詢可出境金額之后再進(jìn)行出境請(qǐng)求
其中：訂單剩余可出境金額=訂單可出境金額-已累計(jì)出境金額
適用對(duì)象：電商平臺(tái)
請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/funds-to-oversea/transactions/{transaction_id}/available_abroad_amounts
請(qǐng)求方式：GET
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 微信支付訂單號(hào) | transaction_id | string[1, 32] | 是 | path微信支付返回的支付訂單號(hào) 示例值：4208450740201411110007820472 |
| 二級(jí)商戶號(hào) | sub_mchid | string[1, 32] | 是 | query查詢剩余可出境金額的二級(jí)商戶號(hào) 示例值：1900000109 |
https://api.mch.weixin.qq.com/v3/funds-to-oversea/transactions/4208450740201411110007820472/available_abroad_amounts?sub_mchid=1900000109
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 微信支付訂單號(hào) | transaction_id | string[1, 32] | 是 | 微信支付返回的支付訂單號(hào) 示例值：4208450740201411110007820472 |
| 訂單剩余可出境金額 | available_abroad_amount | int | 是 | 訂單剩余可出境金額，單位: 分 示例值：21 |
{
"available_abroad_amount": 21,
"transaction_id": "4208450740201411110007820472"
}
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 接口返回錯(cuò)誤 | 請(qǐng)不要更換微信訂單號(hào)，請(qǐng)使用相同參數(shù)再次調(diào)用API。 |
| 400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)求參數(shù)錯(cuò)誤，請(qǐng)重新檢查再調(diào)用查詢剩余可出境余額 |
| 401 | SIGN_ERROR | 簽名錯(cuò)誤 | 請(qǐng)檢查簽名參數(shù)和方法是否都符合簽名算法要求 |
| 429 | FREQUENCY_LIMITED | 頻率限制 | 請(qǐng)降低頻率后重試 |
| 400 | INVALID_REQUEST | 請(qǐng)求參數(shù)符合參數(shù)格式，但不符合業(yè)務(wù)規(guī)則 | 此狀態(tài)代表查詢訂單剩余出境可用余額失敗，商戶可根據(jù)具體的錯(cuò)誤提示做相應(yīng)的處理。 |
| 403 | NO_AUTH | 商戶無(wú)權(quán)限申請(qǐng)資金出境 | 商戶無(wú)權(quán)限申請(qǐng)資金出境，請(qǐng)申請(qǐng)相關(guān)權(quán)限 |