解冻剩余资金
更新时间: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 微信支付分配的商户号,请与微信支付订单的二级商户号保持一致。(直连商户不需要,服务商/机构模式下必填) |
微信支付订单号 | transaction_id | string[1, 32] | 是 | Body 微信支付订单号 |
商户分账单号 | out_order_no | string[1, 64] | 是 | Body 商户系统内部的分账单号,在商户系统内部唯一,同一分账单号多次请求等同一次。只能是数字、大小写字母_-。 |
分账描述 | description | string[1, 80] | 是 | Body 分账的原因描述,分账账单中需要体现 |
请求示例
JSON
3. 返回参数
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 | |||
---|---|---|---|---|---|---|---|
二级商户号 | sub_mchid | string[1, 32] | 否 | 微信支付分配的商户号 | |||
微信支付订单号 | transaction_id | string[1, 32] | 是 | 微信支付订单号 | |||
商户分账单号 | out_order_no | string[1, 64] | 是 | 商户分账单号,同请求入参。 | |||
微信分账单号 | order_id | string[1, 64] | 是 | 微信分账单号,微信系统返回的唯一标识。 | |||
分账单状态 | state | string | 是 | 分账单状态(每个接收方的分账结果请查看receivers中的result字段)。 | |||
分账接收方列表 | receivers | array | 是 | 分账接收方列表 | |||
|
返回示例
正常示例
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后重试 |