API字典 / 分账（发起退款） / 查询可供垫付退款实时余额API

查询可供垫付退款实时余额API

最新更新时间：2023.01.25 版本说明

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

注意：

• 该额度来源于商户指定解冻出境的资金，在当日未实现购汇出境前，作为可垫付资金额度，用于补足历史订单退款中“已出境”部分的资金缺口，保障用户退款权益。该额度无法用作其他资金出口。

1. 接口说明

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

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

请求方式：GET

Path指该参数为路径参数

Query指该参数为URL参数

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

无请求参数

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,
									}

参数名	变量	类型[长度限制]	必填	描述
出资方商户号	sponsor_mchid	string[1, 32]	是	出资方指和微信支付发生实际结算、资金入账的商户；在境外机构商模式下为机构商户。示例值：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,
									}

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

页面导航