最新更新时间：2022.03.15 版本说明
电商平台通过查询预约提现状态API查询二级商户预约提现单的预约提现结果。 该查询服务提供两种查询方式（两种查询方式返回结果一致）：
方式1：微信支付预约提现单号查询；
方式2：商户预约提现单号查询。
1. 本接口可查询90日内发起的预约提现单据，发起时间以微信支付预约提现单创建时间为准。
2. 若查到预约提现单状态是SUCCESS，并不代表银行入账一定成功，部分情况下可能发生银行退票(银行预计在7个工作日内处理退票)。
3. 若查询到预约提现单状态是REFUND，代表预约提现退票，此时应检查登记的账户信息是否有误，退票后资金会自动退回发起时的商户账户内。
4. 若查询到预约提现单状态是INIT，请使用原单(所有请求参数保持不变)发起重试。
5. 若查到预约提现单状态是CREATE_SUCCESS，代表预约提现单已创建，等待银行返回最终结果中，最终结果请重试查询。
6. 返回参数可能会有新增，且顺序可能不完全遵循此文档规范，如果在解析回包的时候发生错误，可以根据api文档重新确认返回内容。
适用对象：电商平台
请求URL：https://api.mch.weixin.qq.com/v3/ecommerce/fund/withdraw/{withdraw_id}
请求方式：GET
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 二级商户号 | sub_mchid | string[1, 32] | 是 | query电商平台二级商户号，由微信支付生成并下发 示例值：1900000109。 |
| 微信支付预约提现单号查询 | withdraw_id | string[1, 128] | 是 | path电商平台提交二级商户预约提现申请后，由微信支付返回的申请单号，作为查询申请状态的唯一标识。 示例值：1232193719823791273913279173291279 |
https://api.mch.weixin.qq.com/v3/ecommerce/fund/withdraw/32912793127931279317929791239112123?sub_mchid=1900000109
适用对象：电商平台
请求URL：https://api.mch.weixin.qq.com/v3/ecommerce/fund/withdraw/out-request-no/{out_request_no}
请求方式：GET
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 二级商户号 | sub_mchid | string[1, 32] | 是 | query电商平台二级商户号，由微信支付生成并下发。 示例值：1900000109 |
| 商户预约提现单号 | out_request_no | string[1, 32] | 是 | path商户预约提现单号，由商户自定义生成 示例值：20190611222222222200 |
https://api.mch.weixin.qq.com/v3/ecommerce/fund/withdraw/out-request-no/20190611222222222200?sub_mchid=1900000109
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 二级商户号 | sub_mchid | string[1, 32] | 是 | 电商平台二级商户号，由微信支付生成并下发。 示例值：1900000109 |
| 电商平台商户号 | sp_mchid | string[1, 32] | 是 | 电商平台商户号 示例值：1800000123 |
| 预约提现单状态 | status | string[1,16] | 是 | 枚举值： CREATE_SUCCESS：受理成功 SUCCESS：提现成功 FAIL：提现失败 REFUND：提现退票 CLOSE：关单 INIT：业务单已创建 示例值：CREATE_SUCCESS |
| 微信支付预约提现单号 | withdraw_id | string[1, 128] | 是 | 提交预约提现申请后，由微信支付返回的申请单号，作为查询申请状态的唯一标识 示例值：12321937198237912739132791732912793127931279317929791239112123 |
| 商户预约提现单号 | out_request_no | string[1, 32] | 是 | 商户预约提现单号，由商户自定义生成，必须是字母数字 示例值：20190611222222222200000000012122 |
| 提现金额 | amount | int | 是 | 单位：分 示例值：1 |
| 提交预约时间 | create_time | string[29, 29] | 是 | 遵循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秒。 示例值：2015-05-20T13:29:35+08:00 |
| 提现状态更新时间 | update_time | string[29, 29] | 是 | 遵循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秒。 示例值：2015-05-20T13:29:35+08:00 |
| 失败原因 | reason | string[1, 255] | 是 | 提现失败原因，仅在提现失败、退票、关单时有值 示例值：卡号错误 |
| 提现备注 | remark | string[1, 255] | 是 | 商户对预约提现单的备注，若发起预约提现时未传入相应值或输入不合法，则该值为空 示例值：交易提现 |
| 银行附言 | bank_memo | string[1, 32] | 是 | 展示在收款银行系统中的附言，由数字、字母、汉字组成（能否成功展示依赖银行系统支持）。若发起提现时未传入相应值或输入不合法，则该值为空 示例值：微信提现 |
| 出款账户类型 | account_type | string[1,16] | 是 | BASIC：基本户 OPERATION：运营账户 FEES：手续费账户 示例值：BASIC |
| 入账银行账号后四位 | account_number | string[1, 4] | 是 | 服务商提现入账的银行账号，仅显示后四位。 示例值：1178 |
| 入账银行 | account_bank | string[1, 10] | 是 | 服务商提现入账的开户银行 示例值：招商银行 |
| 入账银行全称（含支行） | bank_name | string[1, 128] | 否 | 服务商提现入账的开户银行全称（含支行） 示例值：中国工商银行股份有限公司深圳软件园支行 |
{
"sub_mchid": "1900000109",
"sp_mchid": "1800000123",
"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": "微信提现",
"account_type": "BASIC",
"account_number": "1178",
"account_bank": "招商银行",
"bank_name": "中国工商银行股份有限公司深圳软件园支行"
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系统错误 | 系统异常，请使用相同参数稍后重新调用 |
| 403 | REQUEST_BLOCKED | 二级商户未开启预约提现权限 | 二级商户号预约提现权限被冻结，无法发起预约提现 |
| 400 | PARAM_ERROR | 参数错误 | 请使用正确的参数重新调用 |
| 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 | 二级商户未绑卡 | 二级商户号没有绑定结算银行卡，绑定后重试 |