二级商户余额提现API

最新更新时间:2020.09.28 版本说明


电商平台通过余额提现API帮助二级商户发起账户余额提现申请,完成账户余额提现。

注意:

1. 单笔提现最大发起金额不能超过8亿

2. 相同的“商户提现单号”+“二级商户商户号”可以提供6天内防重。

3. 余额提现发起后,单据的实际状态以查询接口为准。

4. 若余额提现发起成功,预计会在下个工作日到账。

5. 当API返回错误码为SYSTEM_ERROR时,请务必不要换单重试,使用原单(所有请求参数保持不变)发起重试。

6. 返回参数可能会有新增,且顺序可能不完全遵循此文档规范,如果在解析回包的时候发生错误,请务必不要换单重试,可以联系客服或小助手确认提现情况。

7. 错误码可能会有新增,如果遇到返回新的错误码,请务必不要换单重试,可以联系客服或小助手确认提现情况。

接口说明

适用对象:电商平台

请求URL:https://api.mch.weixin.qq.com/v3/ecommerce/fund/withdraw

请求方式:POST

接口规则:https://wechatpay-api.gitbook.io/wechatpay-api-v3


path 指该参数为路径参数

query 指该参数为URL参数

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


请求参数

参数名 变量 类型[长度限制] 必填 描述
二级商户号 sub_mchid string[1, 32] body电商平台二级商户号,由微信支付生成并下发。
示例值:1900000109
商户提现单号 out_request_no string[1, 32] body商户提现单号,由商户自定义生成,必须是字母数字。
示例值:20190611222222222200000000012122
提现金额 amount int body单位:分,金额不能超过8亿元
示例值:1
提现备注 remark string[1, 56] body商户对提现单的备注,商户自定义字段。
示例值:交易提现
银行附言 bank_memo string[1, 32] body展示在收款银行系统中的附言,数字、字母最长32个汉字(能否成功展示依赖银行系统支持)
示例值:微信支付提现

请求示例


{
  "sub_mchid": "1900000109",
  "out_request_no": "20190611222222222200000000012122",
  "amount": 1,
  "remark": "交易提现",
  "bank_memo": "微信支付提现"
}

{
JAVA示例代码
}

返回参数

参数名 变量 类型[长度限制] 必填 描述
二级商户号 sub_mchid string[1, 32] 电商平台二级商户号,由微信支付生成并下发。
示例值:1900000109
微信支付提现单号 withdraw_id string[1, 128] 电商平台提交二级商户提现申请后,由微信支付返回的申请单号,作为查询申请状态的唯一标识。
示例值:12321937198237912739132791732912793127931279317929791239112123
商户提现单号 out_request_no string[1, 32] 商户提现单号,由商户自定义生成。
示例值:20190611222222222200000000012122

返回示例


{
  "sub_mchid": "1900000109",
  "withdraw_id": "12321937198237912739132791732912793127931279317929791239112123",
  "out_request_no": "20190611222222222200000000012122"
}
                    

http://2323weixin.qq.com
                    

错误码公共错误码

状态码 错误码 描述 解决方案
500 SYSTEM_ERROR 系统错误 系统异常,请使用相同参数稍后重新调用
403 REQUEST_BLOCKED 二级商户未开启手动提现权限 二级商户号提现权限被冻结,无法发起提现
400 PARAM_ERROR 参数错误 请使用正确的参数重新调用
400 PARAM_ERROR 参数错误 请使用正确的参数重新调用,电商平台提交相同商户单号的请求但参数和历史提交的参数不一致
404 ORDER_NOT_EXIST 提现单号不存在 请检查订单号是否正确
403 NOT_ENOUGH 二级商户号账户可用余额不足 二级商户号账户可用余额不足
403 NO_AUTH 无接口使用权限 请开通商户号相关权限
400 INVALID_REQUEST 二级商户未开启手动提现权限 请确认电商平台商户号和二级商户商户号是否存在受理关系
429 FREQUENCY_LIMITED 频率限制 请降低频率后重试
403 CONTRACT_NOT_CONFIRM 二级商户未开启手动提现权限 二级商户号提现权限已关闭,无法发起提现
403 ACCOUNT_NOT_VERIFIED 二级商户下行打款未成功 二级商户号结算银行卡信息有误,修改后重试
403 ACCOUNT_ERROR 二级商户未绑卡 二级商户号没有绑定结算银行卡,绑定后重试

版本说明

关闭
V1.1
2020年09月28日
1. 修改接口注意事项及remark参数名称
2. 接口返回参数:out_request_no(商户提现单号)必填项由“否”改成“是”
V1.0
2019.09.18
1. 账户余额提现接口上线

技术咨询

反馈有奖