API字典 / 分賬（發(fā)起退款） / 查詢可供墊付退款實時余額API

查詢可供墊付退款實時余額API

最新更新時間：2023.01.25 版本說明

若商戶想對一筆分賬支付單的已經(jīng)解凍出境部分發(fā)起退款，境外機構(gòu)商可通過該接口獲取當前【可墊付退款】額度。

注意：

? 該額度來源于商戶指定解凍出境的資金，在當日未實現(xiàn)購匯出境前，作為可墊付資金額度，用于補足歷史訂單退款中“已出境”部分的資金缺口，保障用戶退款權(quán)益。該額度無法用作其他資金出口。

1. 接口說明

適用對象：直連模式機構(gòu)模式

請求URL：https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/refunds/refundable-balance

請求方式：GET

Path指該參數(shù)為路徑參數(shù)

Query指該參數(shù)為URL參數(shù)

Body指該參數(shù)需在請求JSON傳參

無請求參數(shù)

URL


https://api.mch.weixin.qq.com/v3/global/profit-sharing/refunds/refundable-balance


									{
										"stock_id": "PHP",
										"offset": 10,
										"limit": 10,
									}


									{
										"stock_id": ".NET",
										"limit": 10,
									}


									{
										"stock_id": "Python",
										"stock_creator_mchid": "123456",
										"limit": 10,
									}

參數(shù)名	變量	類型[長度限制]	必填	描述
出資方商戶號	sponsor_mchid	string[1, 32]	是	出資方指和微信支付發(fā)生實際結(jié)算、資金入賬的商戶；在境外機構(gòu)商模式下為機構(gòu)商戶。示例值：19000000001
可供墊付分賬退款的實時余額	balance	int	是	可供墊付用于分賬退款的實時余額，單位為幣種最小單位。（目前為人民幣金額，單位為分）。示例值：1000
貨幣類型	currency	string[3, 3]	是	目前只支持人民幣，"CNY". 示例值：CNY

正常示例


{
  "balance": 1000,
  "currency": "CNY",
  "sponsor_mchid": "19000000001"
}


									{
										"stock_id": "PHP",
										"offset": 10,
										"limit": 10,
									}


									{
										"stock_id": ".NET",
										"limit": 10,
									}


									{
										"stock_id": "Python",
										"stock_creator_mchid": "123456",
										"limit": 10,
									}

狀態(tài)碼	錯誤碼	描述	解決方案
400	INVALID_REQUEST	該訂單不支持分賬	請檢查微信支付訂單號是否填錯，并確認在調(diào)用下單API之前執(zhí)行調(diào)用分賬標記API成功
403	NO_AUTH	商戶未簽約境外分賬產(chǎn)品能力	請參考產(chǎn)品流程和接入準備，確認商戶具有分賬權(quán)限后再發(fā)起請求
403	NO_AUTH	商戶已開通分賬產(chǎn)品能力，等待生效中(一般為第二天才生效)	開通分賬產(chǎn)品能力當天不能發(fā)起分賬，請等待第二天后發(fā)起請求
403	NO_AUTH	商戶父子關(guān)系不存在，請使用正確的二級商戶號發(fā)起請求	請檢查二級商戶號(sub_mchid)是否填寫正確

頁面導(dǎo)航