余额提现
微信特约商户发起账户余额提现申请，完成账户余额提现。
提示
- 需开通余额提现授权
- 单笔提现最大发起金额不能超过8亿
- 相同的“商户提现单号”+“特约商户号”可以提供6天内防重
- 余额提现发起后，单据的实际状态以查询接口为准
- 若余额提现发起成功，预计会在下个工作日（T+1）到账
请求接口
openapi/pay/fund/wxSpFundWithdraw
公共参数
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sub_mchid | 是 | String(32) | 特约商户号 |
| out_request_no | 是 | String(32) | 商户提现单号 |
| amount | 是 | int | 提现金额，单位：分 |
| remark | 否 | String(32) | 提现备注 |
| bank_memo | 否 | String(32) | 银行附言 |
| account_type | 否 | String(16) | 账户类型 BASIC：基本账户 OPERATION：运营账户 FEES：手续费账户 |
content请求实例
{
"sub_mchid": "1900000109",
"out_request_no": "20210611222222222200000000012122",
"amount": 1,
"remark": "交易提现",
"bank_memo": "微信支付提现",
"account_type": "BASIC"
}
响应参数
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sub_mchid | 是 | String(32) | 特约商户号 |
| withdraw_id | 是 | String(128) | 微信支付提现单号，作为查询申请状态的唯一标识 |
| account_type | 否 | String(16) | 账户类型 |
响应示例
{
"sub_mchid": "1900000109",
"withdraw_id": "12321937198237912739132791732912793127931279317929791239112123",
"out_request_no": "20190611222222222200000000012122"
}
错误描述说明
| 错误描述 | 解决方案 |
|---|---|
| 特约商户未开启手动提现权限 | 情况1：特约商户号提现权限被冻结，无法发起提现 |
| 特约商户未开启手动提现权限 | 情况2：特约商户号提现权限已关闭，无法发起提现 |
| 特约商户未开启手动提现权限 | 情况3：请确认服务商商户号和特约商户号是否存在受理关系 |
| 参数错误 | 请使用正确的参数重新调用 |
| 特约商户号账户可用余额不足 | 特约商户号账户可用余额不足 |
| 无接口使用权限 | 请开通商户号相关权限 |
| 频率限制 | 请降低频率后重试 |
| 特约商户下行打款未成功 | 特约商户号结算银行卡信息有误，修改后重试 |
| 特约商户未绑卡 | 特约商户号没有绑定结算银行卡，绑定后重试 |