API字典 / 分账 / 分账标记API

分账标记API

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

商户在下单之前，调用该API来标记该笔商户订单后续会使用资金分账功能，在支付完成后该笔订单款项会被冻结在商户账户中，等待商户的分账指令或解冻剩余资金指令来执行资金的分发。

注意：

• 该接口须在商户调用下单接口之前调用，否则分账标记可能无效（无效是指该笔订单后续无法使用资金分账功能）；

• 该接口中参数须和商户下单接口中相关参数（二级商户号/商户订单号/订单标价金额）保持一致，否则分账标记将无效；

• 在用户支付完成后即会触发对该笔分账支付单的资金冻结流程，建议商户可在3~5min后通过【查询剩余待分金额API】来确认该笔订单是否可执行分账（注：可分账的订单会返回当前剩余待分账金额，若不能分账的订单，会返回错误提示）。

1. 接口说明

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

请求URL：https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/transactions/mark

请求方式：POST

Path指该参数为路径参数

Query指该参数为URL参数

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

参数名	变量	类型[长度限制]	必填	描述
二级商户号	sub_mchid	string[1, 32]	否	Body微信支付分配的商户号，请与微信支付订单的二级商户号保持一致。（直连商户不需要，服务商/机构模式下必填）示例值：1900000109
商户订单号	out_trade_no	string[6, 32]	是	Body需要标记的商户订单号，请和下单参数中的商户订单号保持一致。示例值：P20150806125346
订单标价币种	currency	string[1, 10]	是	Body订单标价币种，目前只支持人民币标价的订单进行分账，"CNY". 示例值：CNY

JSON


{
  "currency": "CNY",
  "out_trade_no": "P20150806125346",
  "sub_mchid": "1900000109"
}


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


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


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

处理成功，应答无内容

正常示例


    204
    处理成功，应答无内容


									{
示例代码
									}

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	需要分账的订单，标价币种目前只支持CNY	修改标记币种为CNY，再重新发起调用
400	INVALID_REQUEST	该订单已经确认不能分账，请在下单前调用分账标记API	请参照接入指引，按照业务流程发起调用
403	NO_AUTH	商户未签约境外分账产品能力	请参考产品流程和接入准备，确认商户具有分账权限后再发起请求
403	NO_AUTH	商户已开通分账产品能力，等待生效中(一般为第二天才生效)	开通分账产品能力当天不能发起分账，请等待第二天后发起请求
403	NO_AUTH	分账接收方境外权限被处罚	请确认分账接收方均合法合规后，请发起分账请求
403	NO_AUTH	商户父子关系不存在，请使用正确的二级商户号发起请求	请检查二级商户号(sub_mchid)是否填写正确

页面导航

语言