最新更新时间:2022.04.11 版本说明
商户在下单之前,调用该API来标记该笔商户订单后续会使用资金分账功能,在支付完成后该笔订单款项会被冻结在商户账户中,等待商户的分账指令或解冻剩余资金指令来执行资金的分发。
• 该接口须在商户调用下单接口之前调用,否则分账标记可能无效(无效是指该笔订单后续无法使用资金分账功能);
• 该接口中参数须和商户下单接口中相关参数(二级商户号/商户订单号/订单标价金额)保持一致,否则分账标记将无效;
• 在用户支付完成后即会触发对该笔分账支付单的资金冻结流程,建议商户可在3~5min后通过【查询剩余待分金额API】来确认该笔订单是否可执行分账(注:可分账的订单会返回当前剩余待分账金额,若不能分账的订单,会返回错误提示)。
适用对象: 直连模式 机构模式
请求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 |
{
"currency": "CNY",
"out_trade_no": "P20150806125346",
"sub_mchid": "1900000109"
}
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | INVALID_REQUEST | 需要分账的订单,标价币种目前只支持CNY | 修改标记币种为CNY,再重新发起调用 |
400 | INVALID_REQUEST | 该订单已经确认不能分账,请在下单前调用分账标记API | 请参照接入指引,按照业务流程发起调用 |
403 | NO_AUTH | 商户未签约境外分账产品能力 | 请参考产品流程和接入准备,确认商户具有分账权限后再发起请求 |
403 | NO_AUTH | 商户已开通分账产品能力,等待生效中(一般为第二天才生效) | 开通分账产品能力当天不能发起分账,请等待第二天后发起请求 |
403 | NO_AUTH | 分账接收方境外权限被处罚 | 请确认分账接收方均合法合规后,请发起分账请求 |
403 | NO_AUTH | 商户父子关系不存在,请使用正确的二级商户号发起请求 | 请检查二级商户号(sub_mchid)是否填写正确 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP证