微信支付提现单号查询
更新时间：2024.12.27服务商通过查询提现状态API查询特约商户提现单的提现结果。 该查询服务提供两种查询方式（两种查询方式返回结果一致）：
- 微信支付提现单号查询；
- 商户提现单号查询。
注意
- 本接口可查询90日内发起的提现单据，发起时间以微信支付提现单创建时间为准。
- 若查到提现单状态是'SUCCESS'，并不代表银行入账一定成功，部分情况下可能发生银行退票(银行预计在7个工作日内处理退票)。
- 若查询到提现单状态是'REFUND'，代表提现退票，此时应检查登记的账户信息是否有误，退票后资金会自动退回发起时的商户账户内。
- 若查询到提现单状态是'INIT'，请使用原单(所有请求参数保持不变)发起重试。
# 商户提现单号查询
# 接口说明
支持商户： 【普通服务商】
请求URL： /v3/ecommerce/fund/withdraw/out-request-no/{out_request_no}
请求方式： GET
# 请求参数
- sub_mchid 必填【特约商户号】 服务商特约商户号，由微信支付生成并下发。
Query 查询参数
- out_request_no 必填【商户提现单号】 商户提现单号，由商户自定义生成。
Path 路径参数
# 返回参数
- sub_mchid 必填【特约商户号】 服务商特约商户号，由微信支付生成并下发。
请求示例
1https://api.mch.weixin.qq.com/v3/ecommerce/fund/withdraw/32912793127931279317929791239112123?sub_mchid=1900000109返回示例
1{2 "sub_mchid": "1900000109",3 "sp_mchid": "1800000123",4 "status": "CREATE_SUCCESS",5 "withdraw_id": "12321937198237912739132791732912793127931279317929791239112123",6 "out_request_no": "20190611222222222200000000012122",7 "amount": 1,8 "create_time": "2015-05-20T13:29:35.120+08:00",9 "update_time": "2015-05-20T13:29:35.120+08:00",10 "reason": "卡号错误",11 "remark": "交易提现",12 "bank_memo": "微信提现",13 "account_type": "BASIC",14 "account_number": "1178",15 "account_bank": "招商银行",16 "bank_name": "中国工商银行股份有限公司深圳软件园支行"17}# 错误码
# 公共错误码
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 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 | 特约商户未绑卡 |
文档是否有帮助
