API字典 / 分账 / 查询剩余待分金额API

查询剩余待分金额API

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

可调用此接口查询微信支付订单的剩余未分账的金额。

1. 接口说明

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

请求URL：https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/transactions/{transaction_id}/amounts

请求方式：get

Path指该参数为路径参数

Query指该参数为URL参数

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

参数名	变量	类型[长度限制]	必填	描述
二级商户号	sub_mchid	string[1, 32]	否	Query微信支付分配的商户号，请与微信支付订单的二级商户号保持一致。（直连商户不需要，服务商/机构模式下必填）示例值：1900000109
微信支付订单号	transaction_id	string[1, 32]	是	Path微信支付订单号示例值：4208450740201411110007820472

URL


https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/transactions/4208450740201411110007820472/amounts?sub_mchid=1900000109

参数名	变量	类型[长度限制]	必填	描述
微信支付订单号	transaction_id	string[1, 32]	是	微信支付订单号示例值：4208450740201411110007820472
订单剩余待分金额	unsplit_amount	int	是	订单剩余待分金额，单位为币种最小单位。（目前为人民币金额，单位为分）。示例值：1000
货币类型	currency	string[1, 10]	是	目前只支持人民币，"CNY". 示例值：CNY

JSON


{
  "currency": "CNY",
  "transaction_id": "4208450740201411110007820472",
  "unsplit_amount": 1000
}

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	商户信息与订单商户信息不一致	请检查外部指令单号(out_order_no)/微信支付单号(transaction_id)/二级商户号(sub_mchid)是否填写正确
400	INVALID_REQUEST	微信支付订单与原指令信息不一致	请检查外部指令单号(out_order_no)/微信支付单号(transaction_id)是否填写正确
400	INVALID_REQUEST	该订单不支持分账	请检查微信支付订单号是否填错，并确认在调用下单API之前执行调用分账标记API成功
403	NO_AUTH	商户未签约境外分账产品能力	请参考产品流程和接入准备，确认商户具有分账权限后再发起请求
403	NO_AUTH	商户已开通分账产品能力，等待生效中(一般为第二天才生效)	开通分账产品能力当天不能发起分账，请等待第二天后发起请求
403	NO_AUTH	分账接收方境外权限被处罚	请确认分账接收方均合法合规后，请发起分账请求
403	NO_AUTH	商户父子关系不存在，请使用正确的二级商户号发起请求	请检查二级商户号(sub_mchid)是否填写正确
500	SYSYTEM_ERROR	商户发起分账请求指定的微信支付订单资金冻结流程还未完成，请稍后重试	用户支付完成后即会触发对该笔分账支付单的资金冻结流程，建议商户可在3~5min后重试

页面导航