特约商户余额提现
更新时间：2024.12.27服务商通过余额提现API帮助特约商户发起账户余额提现申请，完成账户余额提现。
注意
- 单笔预约提现最大发起金额不能超过8亿。
- 相同的“商户预约提现单号”+“特约商户商户号”可以提供6天内防重。
- 预约提现发起后，单据的实际状态以查询接口为准。
- 若预约提现发起成功，预计会在下个工作日到账。
- 当API返回错误码为SYSTEM_ERROR时，请务必不要换单重试，使用原单(所有请求参数保持不变)发起重试。
- 返回参数可能会有新增，且顺序可能不完全遵循此文档规范，如果在解析回包的时候发生错误，请务必不要换单重试，可以联系客服或小助手确认提现情况。
- 错误码可能会有新增，如果遇到返回新的错误码，请务必不要换单重试，可以联系客服或小助手确认提现情况。
# 接口说明
支持商户： 【普通服务商】
请求方式： 【POST】
请求URL： "https://api.mch.weixin.qq.com/v3/ecommerce/fund/withdraw"
# 请求参数
- sub_mchid 必填服务商特约商户号，由微信支付生成并下发。
- out_request_no 必填商户提现单号，由商户自定义生成，必须是字母数字。
- amount 必填单位：分，金额不能超过8亿元
- remark 选填商户对提现单的备注，商户自定义字段。
- bank_memo 选填展示在收款银行系统中的附言，数字、字母最长32个汉字（能否成功展示依赖银行系统支持）
- account_type 选填BASIC：基本户OPERATION：运营账户FEES：手续费账户
Body 包体参数
# 应答参数
- sub_mchid 必填服务商特约商户号，由微信支付生成并下发。
- withdraw_id 必填服务商提交特约商户提现申请后，由微信支付返回的申请单号，作为查询申请状态的唯一标识。
- out_request_no 选填枚举值：BASIC：基本户OPERATION：运营账户FEES：手续费账户
请求示例
1{2 "sub_mchid": "1900000109",3 "out_request_no": "20190611222222222200000000012122",4 "amount": 1,5 "remark": "交易提现",6 "bank_memo": "微信支付提现",7 "account_type": "BASIC"8}应答示例
1{2 "sub_mchid": "1900000109",3 "withdraw_id": "12321937198237912739132791732912793127931279317929791239112123",4 "out_request_no": "20190611222222222200000000012122"5}# 错误码
# 公共错误码
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
| 400 | INVALID_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 接口规则 (opens new window) |
| 401 | SIGN_ERROR | 验证不通过 | 请参阅 签名常见问题 (opens new window) |
| 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 | 系统错误 | 系统异常，请使用相同参数稍后重新调用 |
文档是否有帮助
