查询预约提现状态(根据微信支付提现单号查询)

更新时间:2023.10.11

电商平台通过查询预约提现状态API查询二级商户预约提现单的预约提现结果。 该查询服务提供两种查询方式(两种查询方式返回结果一致):

  • 方式1:微信支付预约提现单号查询;
  • 方式2:商户预约提现单号查询。

注意

  1. 本接口可查询90日内发起的预约提现单据,发起时间以微信支付预约提现单创建时间为准。
  2. 若查到预约提现单状态是'SUCCESS',并不代表银行入账一定成功,部分情况下可能发生银行退票(银行预计在7个工作日内处理退票)。
  3. 若查询到预约提现单状态是'REFUND',代表预约提现退票,此时应检查登记的账户信息是否有误,退票后资金会自动退回发起时的商户账户内。
  4. 若查询到预约提现单状态是'INIT',请使用原单(所有请求参数保持不变)发起重试
  5. 若查到预约提现单状态是'CREATE_SUCCESS',代表预约提现单已创建,等待银行返回最终结果中,最终结果请重试查询。
  6. 返回参数可能会有新增,且顺序可能不完全遵循此文档规范,如果在解析回包的时候发生错误,可以根据API文档重新确认返回内容。

# 接口说明

支持商户: 【普通服务商】

请求方式: 【GET】

请求URL: "https://api.mch.weixin.qq.com/v3/ecommerce/fund/withdraw/{withdraw_id}"

# 请求参数

    Path 路径参数
  • withdraw_id 必填 string(128)
    服务商提交特约商户提现申请后,由微信支付返回的申请单号,作为查询申请状态的唯一标识。
    Query 查询参数
  • sub_mchid 必填 string(32)
    服务商特约商户号,由微信支付生成并下发。

# 应答参数

  • sub_mchid 必填 string(32)
    服务商特约商户号,由微信支付生成并下发。
  • sp_mchid 必填 string(32)
    服务商商户号
  • status 必填 string(16)
    枚举值:
    CREATE_SUCCESS:受理成功
    SUCCESS:提现成功
    FAIL:提现失败
    REFUND:提现退票
    CLOSE:关单
    INIT:业务单已创建
  • withdraw_id 必填 string(128)
    服务商提交特约商户提现申请后,由微信支付返回的申请单号,作为查询申请状态的唯一标识。
  • out_request_no 必填 string(32)
    商户提现单号
  • amount 必填 integer
    提现金额,单位:分
  • create_time 必填 string
    提交预约时间。遵循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
    提现状态更新时间。遵循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)
    提现失败原因,仅在提现失败、退票、关单时有值
  • remark 必填 string(255)
    商户对预约提现单的备注,若发起预约提现时未传入相应值或输入不合法,则该值为空
  • bank_memo 必填 string(32)
    展示在收款银行系统中的附言,由数字、字母、汉字组成(能否成功展示依赖银行系统支持)。若发起提现时未传入相应值或输入不合法,则该值为空
  • account_type 必填 string(16)
    BASIC:基本户
    OPERATION:运营账户
    FEES:手续费账户
  • account_number 必填 string(4)
    服务商提现入账的银行账号,仅显示后四位。
  • account_bank 必填 string(10)
    服务商提现入账的开户银行
  • bank_name 必填 string(128)
    服务商提现入账的开户银行全称(含支行)

请求示例

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}

# 错误码

状态码 错误码 描述 解决方案
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 特约商户未绑卡 特约商户号没有绑定结算银行卡,绑定后重试
更多技术问题
技术咨询
反馈
咨询
目录