收付通平台通过预约提现API帮助二级商户发起账户预约提现申请，完成账户提现。

该预约提现申请提交后，系统将在次日发起提现，预计当日到账。具体到账时间以实际银行处理为准。

注意：

1. 单笔预约提现最大发起金额不能超过8亿。
2. 相同的“商户预约提现单号”+“特约商户商户号”可以提供6天内防重。
3. 预约提现发起后，单据的实际状态以查询接口为准。
4. 若预约提现发起成功，预计会在下个工作日到账。
5. 当API返回错误码为SYSTEM_ERROR时，请务必不要换单重试，使用原单(所有请求参数保持不变)发起重试。
6. 返回参数可能会有新增，且顺序可能不完全遵循此文档规范，如果在解析回包的时候发生错误，请务必不要换单重试，可以联系客服或小助手确认提现情况。
7. 错误码可能会有新增，如果遇到返回新的错误码，请务必不要换单重试，可以联系客服或小助手确认提现情况。

接口说明

支持商户：

【平台商户】

请求方式：

【POST】/v3/ecommerce/fund/withdraw

请求域名：

【主域名】

https://api.mch.weixin.qq.com

使用该域名将访问就近的接入点

【备域名】

https://api2.mch.weixin.qq.com

使用该域名将访问异地的接入点 ，指引点击查看

请求参数

Header HTTP头参数
Authorization 必填 string
请参考 签名认证 生成认证信息
Accept 必填 string
请设置为 application/json
Content-Type 必填 string
请设置为 application/json

Body 包体参数
sub_mchid 必填 string(32)
【二级商户号】 收付通平台二级商户号，由微信支付生成并下发
out_request_no 必填 string(32)
【商户预约提现单号】 商户预约提现单号，由商户自定义生成，必须是字母数字
amount 必填 integer
【提现金额】 提现金额，单位：分，不能超过8亿元
remark 选填 string(56)
【提现备注】 商户对预约提现单的备注
bank_memo 选填 string(32)
【银行附言】 展示在收款银行系统中的附言，由数字、字母、汉字组成（能否成功展示依赖银行系统支持）
account_type 选填 string
【出款账户类型】 出款账户类型
可选取值：

• BASIC: 基本账户
• FEES: 手续费账户
• OPERATION: 运营账户

请求示例

POST

应答参数

200OK
sub_mchid 必填 string(32)
【二级商户号】 收付通平台二级商户号，由微信支付生成并下发
withdraw_id 必填 string(128)
【微信支付预约提现单号】 提交预约提现申请后，由微信支付返回的申请单号，作为查询申请状态的唯一标识
out_request_no 必填 string(32)
【商户预约提现单号】 商户预约提现单号，由商户自定义生成，必须是字母数字

应答示例

200 OK

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅 接口规则
401	SIGN_ERROR	验证不通过	请参阅 签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

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