最新更新時(shí)間:2020.03.13 版本說(shuō)明
電商平臺(tái)可通過(guò)此接口可以查詢本商戶號(hào)的賬號(hào)余額情況。
適用對(duì)象:電商平臺(tái)
請(qǐng)求URL:https://api.mch.weixin.qq.com/v3/merchant/fund/balance/{account_type}
請(qǐng)求方式:GET
path指該參數(shù)為路徑參數(shù)
query指該參數(shù)需在請(qǐng)求URL傳參
body指該參數(shù)需在請(qǐng)求JSON傳參
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
賬戶類型 | account_type | string[1,16] | 是 | path
枚舉值: BASIC:基本賬戶 OPERATION:運(yùn)營(yíng)賬戶 FEES:手續(xù)費(fèi)賬戶 示例值:BASIC |
https://api.mch.weixin.qq.com/v3/merchant/fund/balance/BASIC
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
可用余額 | available_amount | int64 | 是 | 可用余額(單位:分),此余額可做提現(xiàn)操作。 示例值: 100 |
不可用余額 | pending_amount | int64 | 否 | 不可用余額(單位:分)。 示例值: 100 |
{
"available_amount": 10000,
"pending_amount": 0
}
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
403 | NO_AUTH | 當(dāng)前商戶號(hào)沒(méi)有使用該接口的權(quán)限 | 請(qǐng)確認(rèn)是否已經(jīng)開(kāi)通相關(guān)權(quán)限 |
400 | INVALID_REQUEST | 輸入賬戶類型未開(kāi)通 | 請(qǐng)檢查account_type,并重新調(diào)用 |
400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)使用正確的參數(shù)重新調(diào)用 |