---
url: "https://pay.weixin.qq.com/doc/v3/partner/4012476674.md"
title: "平台查询预约提现状态（根据微信支付预约提现单号查询）"
doc_id: 4012476674
---

>更新时间：2024.12.19

收付通平台通过该接口可将其平台的收入进行预约提现。

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

注意：

1. 本接口可查询90日内发起的预约提现单据，发起时间以微信支付预约提现单创建时间为准。

2. 若查到预约提现单状态是'SUCCESS'，并不代表银行入账一定成功，部分情况下可能发生银行退票(银行预计在7个工作日内处理退票)。

3. 若查询到预约提现单状态是'REFUND'，代表预约提现退票，此时应检查登记的账户信息是否有误，退票后资金会自动退回发起时的商户账户内。

4. 若查询到预约提现单状态是'INIT'，请使用原单(所有请求参数保持不变)发起重试。

5. 若查到预约提现单状态是'CREATE\_SUCCESS'，代表预约提现单已创建，等待银行返回最终结果中，最终结果请重试查询。

6. 返回参数可能会有新增，且顺序可能不完全遵循此文档规范，如果在解析回包的时候发生错误，可以根据api文档重新确认返回内容。

7. 接口限频：单商户 100次/秒。如需调整请联系微信支付客服或小助手。





## 接口说明

支持商户：【平台商户】

请求方式：【GET】 `/v3/merchant/fund/withdraw/withdraw-id/{withdraw_id}`

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引[点击查看](https://pay.weixin.qq.com/doc/v3/partner/4012082567.md)

## 请求参数

### Header 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| Authorization | string | true | 请参考 [签名认证](https://pay.weixin.qq.com/doc/v3/partner/4012365870.md#%E8%AF%B7%E6%B1%82%E6%8E%A5%E5%8F%A3%E5%90%8E%E7%AB%AF%E7%AD%BE%E5%90%8D) 生成认证信息 |
| Accept | string | true | 请设置为 `application/json` |
### Path 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| withdraw_id | string(128) | true | **【微信支付预约提现单号】** 提交预约提现申请后，由微信支付返回的申请单号，作为查询申请状态的唯一标识 |
## 应答参数

200 OK

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| status | string | true | **【预约提现单状态】** 预约提现单据当前的状态<br>可选取值：<br><ul><li>`CREATE_SUCCESS`: 受理成功</li></ul><br><ul><li>`SUCCESS`: 提现成功</li></ul><br><ul><li>`FAIL`: 提现失败</li></ul><br><ul><li>`REFUND`: 提现退票</li></ul><br><ul><li>`CLOSE`: 关单</li></ul><br><ul><li>`INIT`: 业务单已创建</li></ul> |
| withdraw_id | string(128) | true | **【微信支付预约提现单号】** 提交预约提现申请后，由微信支付返回的申请单号，作为查询申请状态的唯一标识 |
| out_request_no | string(32) | true | **【商户预约提现单号】** 商户预约提现单号，由商户自定义生成，必须是字母数字 |
| amount | integer | true | **【提现金额】** 提现金额。单位：分 |
| create_time | string | true | **【提交预约时间】** 提交预约时间。遵循 [rfc3339](https://tools.ietf.org/html/rfc3339) 标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日13点29分35秒 |
| update_time | string | true | **【提现状态更新时间】** 提现状态更新时间。遵循 [rfc3339](https://tools.ietf.org/html/rfc3339) 标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日13点29分35秒 |
| reason | string(255) | true | **【失败原因】** 提现失败原因，仅在提现失败、退票、关单时有值 |
| remark | string(255) | true | **【提现备注】** 商户对预约提现单的备注，若发起预约提现时未传入相应值或输入不合法，则该值为空 |
| bank_memo | string(32) | true | **【银行附言】** 展示在收款银行系统中的附言，由数字、字母、汉字组成（能否成功展示依赖银行系统支持）。若发起提现时未传入相应值或输入不合法，则该值为空 |
| account_type | string | true | **【出款账户类型】** 出款账户类型<br>可选取值：<br><ul><li>`BASIC`: 基本账户</li></ul><br><ul><li>`FEES`: 手续费账户</li></ul><br><ul><li>`OPERATION`: 运营账户</li></ul> |
| solution | string(255) | true | **【提现失败解决方案】** 提现失败解决方案。仅在提现失败、退票、关单时有值 |
| account_number | string(4) | true | **【入账银行账号后四位】** 提现入账的银行账号，仅显示后四位 |
| account_bank | string(10) | true | **【入账银行】** 提现入账的开户银行 |
| bank_name | string(128) | false | **【入账银行全称（含支行）】** 提现入账的开户银行全称（含支行） |
## 错误码

### 公共错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | PARAM\_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
| 400 | INVALID\_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 [接口规则](https://pay.weixin.qq.com/doc/v3/partner/4012081726.md) |
| 401 | SIGN\_ERROR | 验证不通过 | 请参阅 [签名常见问题](https://pay.weixin.qq.com/doc/v3/partner/4012082324.md) |
| 500 | SYSTEM\_ERROR | 系统异常，请稍后重试 | 请稍后重试 |

### 业务错误码

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

请求示例

- [curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4012476674-curl.md)
- [Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4012476674-java.md)
- [Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4012476674-go.md)


应答示例

> 200 OK

```
{
  "status" : "CREATE_SUCCESS",
  "withdraw_id" : "12321937198237912739132791732912793127931279317929791239112123",
  "out_request_no" : "20190611222222222200000000012122",
  "amount" : 1,
  "create_time" : "2015-05-20T13:29:35.120+08:00",
  "update_time" : "2015-05-20T13:29:35.120+08:00",
  "reason" : "卡号错误",
  "remark" : "交易提现",
  "bank_memo" : "xx平台提现",
  "account_type" : "BASIC",
  "solution" : "请修改结算银行卡信息",
  "account_number" : "1178",
  "account_bank" : "招商银行",
  "bank_name" : "中国工商银行股份有限公司深圳软件园支行"
}

```
