查询可供垫付退款实时金额

更新时间：2025.03.03

商户想对一笔分账支付单发起退款，境外机构商可通过该接口获取当前【可垫付退款】额度。

注意：

1. 接口说明

适用对象：直连模式机构模式

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

请求方式：GET

Path 指该参数为路径参数

Query 指该参数为URL参数

Body 指该参数需在请求JSON传参

无请求参数

URL

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

参数名	变量	类型[长度限制]	必填	描述
出资方商户号	sponsor_mchid	string[1, 32]	是	出资方指和微信支付发生实际结算、资金入账的商户；在境外机构商模式下为机构商户。示例值：19000000001
可供垫付分账退款的实时余额	balance	int	是	可供垫付用于分账退款的实时余额，单位为币种最小单位。（目前为人民币金额，单位为分）。示例值：1000
货币类型	currency	string[3, 3]	是	目前只支持人民币，"CNY". 示例值：CNY

正常示例

1{
2  "balance": 1000,
3  "currency": "CNY",
4  "sponsor_mchid": "19000000001"
5}

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	该订单不支持分账	请检查微信支付订单号是否填错，并确认在调用下单API之前执行调用分账标记API成功
403	NO_AUTH	商户未签约境外分账产品能力	请参考产品流程和接入准备，确认商户具有分账权限后再发起请求
403	NO_AUTH	商户已开通分账产品能力，等待生效中(一般为第二天才生效)	开通分账产品能力当天不能发起分账，请等待第二天后发起请求
403	NO_AUTH	商户父子关系不存在，请使用正确的二级商户号发起请求	请检查二级商户号(sub_mchid)是否填写正确