分账标记

更新时间:2024.12.30

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

注意:

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

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

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


1. 接口说明

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

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

请求方式:POST

 

Path 指该参数为路径参数

Query 指该参数为URL参数

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

 

2. 请求参数

参数名

变量

类型[长度限制]

必填

描述

二级商户号

sub_mchid

string[1, 32]

Body 微信支付分配的商户号,请与微信支付订单的二级商户号保持一致。(直连商户不需要,服务商/机构模式下必填)
示例值:1900000109

商户订单号

out_trade_no

string[6, 32]

Body 需要标记的商户订单号,请和下单参数中的商户订单号保持一致。
示例值:P20150806125346

订单标价币种

currency

string[1, 10]

Body 订单标价币种,目前只支持人民币标价的订单进行分账,"CNY".
示例值:CNY

请求示例

JSON

1{
2  "currency": "CNY",
3  "out_trade_no": "P20150806125346",
4  "sub_mchid": "1900000109"
5}

 

3. 返回参数

处理成功,应答无内容

返回示例

正常示例

1    204
2    处理成功,应答无内容

 

4. 错误码

状态码

错误码

描述

解决方案

400

INVALID_REQUEST

需要分账的订单,标价币种目前只支持CNY

修改标记币种为CNY,再重新发起调用

400

INVALID_REQUEST

该订单已经确认不能分账,请在下单前调用分账标记API

请参照接入指引,按照业务流程发起调用

403

NO_AUTH

商户未签约境外分账产品能力

请参考产品流程和接入准备,确认商户具有分账权限后再发起请求

403

NO_AUTH

商户已开通分账产品能力,等待生效中(一般为第二天才生效)

开通分账产品能力当天不能发起分账,请等待第二天后发起请求

403

NO_AUTH

分账接收方境外权限被处罚

请确认分账接收方均合法合规后,请发起分账请求

403

NO_AUTH

商户父子关系不存在,请使用正确的二级商户号发起请求

请检查二级商户号(sub_mchid)是否填写正确

 

 

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2025 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global

Contact Us

Customer Service Tel

+86 571 95017

9:00-18:00 Monday-Friday GMT+8

Business Development

wxpayglobal@tencent.com

Developer Support

wepayTS@tencent.com

Wechat Pay Global

About Tenpay
Powered By Tencent & Tenpay Copyright© 2005-2025 Tenpay All Rights Reserved.