最新更新时间：2022.03.15 版本说明
电商平台通过该接口可将其平台的收入进行预约提现
该预约提现申请提交后，系统将在次日发起提现，预计当日到账。具体到账时间以实际银行处理为准
1. 单笔预约提现最大发起金额不能超过8亿元。
2. 相同的“商户预约提现单号”可以提供6天内防重。
3. 预约提现发起后，单据的实际状态以查询接口为准。
4. 若预约提现发起成功，预计会在下个工作日到账。
5. 当API返回错误码为SYSTEM_ERROR时，请务必不要换单重试，使用原单(所有请求参数保持不变)发起重试。
6. 返回参数可能会有新增，且顺序可能不完全遵循此文档规范，如果在解析回包的时候发生错误，请务必不要换单重试，可以联系客服或小助手确认提现情况。
7. 错误码可能会有新增，如果遇到返回新的错误码，请务必不要换单重试，可以联系客服或小助手确认预约提现情况。
适用对象：电商平台
请求URL：https://api.mch.weixin.qq.com/v3/merchant/fund/withdraw
请求方式：POST
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 商户预约提现单号 | out_request_no | string[1, 32] | 是 | body商户预约提现单号，由商户自定义生成 示例值：20190611222222222200000000012122 |
| 提现金额 | amount | int | 是 | body单位：分，金额不能超过8亿元 示例值：1 |
| 提现备注 | remark | string[1, 56] | 否 | body商户对预约提现单的备注 示例值：交易提现 |
| 银行附言 | bank_memo | string[1, 32] | 否 | body展示在收款银行系统中的附言，由数字、字母、汉字组成（能否成功展示依赖银行系统支持）。 示例值：xx平台提现 |
| 出款账户类型 | account_type | string[1,16] | 是 | body枚举值： BASIC：基本户 OPERATION：运营账户 FEES：手续费账户 示例值：BASIC |
{
"out_request_no": "20190611222222222200000000012122",
"amount": 1,
"remark": "交易提现",
"bank_memo": "xx平台提现",
"account_type": "BASIC"
}
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 微信支付预约提现单号 | withdraw_id | string[1, 128] | 是 | 微信支付系统生成的预约提现单号 示例值：12321937198237912739132791732912793127931279317929791239112123 |
| 商户预约提现单号 | out_request_no | string[1, 32] | 是 | 商户预约提现单号，由商户自定义生成 示例值：20190611222222222200000000012122 |
{
"withdraw_id": "123219371982379127391327917929791239112123",
"out_request_no": "2019061122220000012122"
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 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_CONFIRMED | 二级商户未开启预约提现权限 | 二级商户号预约提现权限已关闭，无法发起提现 |
| 403 | ACCOUNT_NOT_VERIFIED | 二级商户下行打款未成功 | 二级商户号结算银行卡信息有误，修改后重试 |
| 403 | ACCOUNT_ERROR | 二级商户未绑卡 | 二级商户号没有绑定结算银行卡，绑定后重试 |
| 400 | INVALID_REQUEST | 商户账户类型不存在或未开通 | 请确认二级商户账户类型有效 |