平台预约提现

更新时间：2024.12.19

收付通平台通过该接口可将其平台的收入进行预约提现。
该预约提现申请提交后，系统将在次日发起提现，预计当日到账。具体到账时间以实际银行处理为准。

注意：

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

接口说明

支持商户：【平台商户】

请求方式：【POST】/v3/merchant/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 包体参数

out_request_no 　必填 string(32)

【商户预约提现单号】商户预约提现单号，由商户自定义生成，必须是字母数字

amount 　必填 integer

【提现金额】提现金额，单位：分，不能超过8亿元

remark 　选填 string(56)

【提现备注】商户对预约提现单的备注

bank_memo 　选填 string(32)

【银行附言】展示在收款银行系统中的附言，由数字、字母、汉字组成（能否成功展示依赖银行系统支持）

account_type 　必填 string

【出款账户类型】出款账户类型

可选取值：

BASIC: 基本账户

FEES: 手续费账户

OPERATION: 运营账户

notify_url 　选填 string(256)

【提现结果通知地址】异步接收提现结果（包括提现成功、失败、关单、退票）通知的回调地址，必须为公网可访问的URL，必须为HTTPS协议，不能携带URL参数。

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/merchant/fund/withdraw \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "out_request_no" : "20190611222222222200000000012122",
8    "amount" : 1,
9    "remark" : "交易提现",
10    "bank_memo" : "xx平台提现",
11    "account_type" : "BASIC",
12    "notify_url" : "https://yourapp.com/notify"
13  }'
14

应答参数

200 OK

withdraw_id 　必填 string(128)

【微信支付预约提现单号】微信支付系统生成的预约提现单号

out_request_no 　必填 string(32)

【商户预约提现单号】商户预约提现单号，由商户自定义生成

应答示例

200 OK

1{
2  "withdraw_id" : "12321937198237912739132791732912793127931279317929791239112123",
3  "out_request_no" : "20190611222222222200000000012122"
4}
5

错误码

公共错误码

状态码	错误码	描述	解决方案
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	系统错误	系统异常，请使用相同参数稍后重新调用

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服