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