解冻剩余资金

更新时间:2025.01.07

不需要进行分账的订单,可直接调用本接口将订单的金额全部解冻给订单出资方账户(原订单资金结算账户);调用分账接口后,需要解冻剩余资金时,可调用本接口将剩余的未分账金额全部解冻给订单出资方账户。

注意:

  • 此接口采用异步处理模式,即在接收到商户请求后,会先受理请求再异步处理,最终的分账结果可以通过查询分账接口获取;

  • 该接口返回成功后,解冻出境的金额将和非分账订单金额一起参与轧差结算,与商户的结算合同中的相关结算周期、起结点等提现规则保持一致;

  • 出资方指和微信支付发生实际结算、资金入账的商户;在境外机构商模式下为机构商户、在服务商模式下为二级商户。


1. 接口说明

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

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

请求方式:POST

 

Path 指该参数为路径参数

Query 指该参数为URL参数

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

2. 请求参数

参数名

变量

类型[长度限制]

必填

描述

二级商户号

sub_mchid

string[1, 32]

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

微信支付订单号

transaction_id

string[1, 32]

Body 微信支付订单号
示例值:4208450740201411110007820472

商户分账单号

out_order_no

string[1, 64]

Body 商户系统内部的分账单号,在商户系统内部唯一,同一分账单号多次请求等同一次。只能是数字、大小写字母_-。
注:该单号用于标识商户侧发起的不同分账指令请求(包括请求分账API/解冻剩余资金API)。
若需要对同一笔微信支付订单进行多次资金分发处理,请注意更换【商户分账单号】后再发起调用,否则会被微信支付服务视为同一请求重入。
示例值:P20150806125346

分账描述

description

string[1, 80]

Body 分账的原因描述,分账账单中需要体现
示例值:解冻全部剩余资金

请求示例

JSON

1{
2  "description": "解冻全部剩余资金",
3  "out_order_no": "P20150806125346",
4  "sub_mchid": "1900000109",
5  "transaction_id": "4208450740201411110007820472"
6}

 

3. 返回参数

参数名

变量

类型[长度限制]

必填

描述

二级商户号

sub_mchid

string[1, 32]

微信支付分配的商户号
示例值:1900000109

微信支付订单号

transaction_id

string[1, 32]

微信支付订单号
示例值:4208450740201411110007820472

商户分账单号

out_order_no

string[1, 64]

商户分账单号,同请求入参。
示例值:P20150806125346

微信分账单号

order_id

string[1, 64]

微信分账单号,微信系统返回的唯一标识。
示例值:3008450740201411110007820472

分账单状态

state

string

分账单状态(每个接收方的分账结果请查看receivers中的result字段)。
PROCESSING - 处理中,
FINISHED - 分账完成,
示例值:FINISHED

分账接收方列表

receivers

array

分账接收方列表
商户在发起分账请求或解冻剩余资金请求时,对同一笔订单可分给多个接收方(包括解冻给出资方),分账明细描述了每笔分给一个接收方的资金的状态。

分账接收方列表

返回示例

正常示例

1{
2    "order_id": "7100000751202203238029563456088",
3    "out_order_no": "P20150806125346",
4    "receivers": [
5      {
6        "account": "999952224",  # 出资方商户号
7        "amount": 995,
8        "create_time": "2022-03-23T17:59:23+08:00",
9        "currency": "CNY",
10        "description": "解冻全部剩余资金",
11        "detail_id": "7200000751202203238029563456171",
12        "detail_type": "UNFREEZE_TO_SPONSOR",
13        "rate_value": 83640300,
14        "result": "PENDING",
15        "settlement_amount": 1189,
16        "settlement_currency": "HKD",
17        "type": "MERCHANT_ID"
18      }
19    ],
20    "state": "PROCESSING",
21    "sub_mchid": "1900000109",
22    "transaction_id": "4208450740201411110007820472"
23}

 

4. 错误码

状态码

错误码

描述

解决方案

400

INVALID_REQUEST

分账请求中的商户信息与原支付订单商户信息不一致

请仔细检查订单号是否填错、二级子商户是否未填或填错

400

INVALID_REQUEST

该订单不支持分账

请检查微信支付订单号是否填错,并确认在调用下单API之前执行调用分账标记API成功

403

NO_AUTH

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

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

403

NO_AUTH

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

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

403

NO_AUTH

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

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

400

INVALID_REQUEST

商户解冻剩余资金时指令(out_order_no)已存在,且明细内容不符合预期

若为不同分账请求,请更换外部指令单号(out_order_no)再发起分账请求

403

NOTENOUGH

请求分账时校验到可分金额不足

可通过【查询剩余可分金额API】来获取订单当前的可分金额

500

SYSYTEMERROR

商户发起分账请求指定的微信支付订单资金冻结流程还未完成,请稍后重试

用户支付完成后即会触发对该笔分账支付单的资金冻结流程,建议商户可在3~5min后重试

 

 

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.