基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
微信支付分(公共API)
微信支付分(免确认预授权模式)
微信支付分(需确认模式)
支付即服务
行业方案
智慧商圈
微信支付分停车服务
电子发票
营销工具
代金券
商家券
委托营销
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
商家转账到零钱
分账
风险合规
消费者投诉2.0
其他能力
清关报关
图片上传
视频上传
微信支付平台证书

二级商户查询提现状态API

最新更新时间:2020.09.28 版本说明


电商平台通过查询提现状态API查询二级商户提现单的提现结果。 该查询服务提供两种查询方式(两种查询方式返回结果一致):
    方式1:微信支付提现单号查询;
    方式2:商户提现单号查询。

注意:

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

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

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

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


1、微信支付提现单号查询

接口说明

适用对象:电商平台

请求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

{
JAVA示例代码
}




2、商户提现单号查询

接口说明

适用对象:电商平台

请求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

{
JAVA示例代码
}

返回参数

参数名 变量 类型[长度限制] 必填 描述
二级商户号 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] 电商平台提交二级商户提现申请后,由微信支付返回的申请单号,作为查询申请状态的唯一标识。
示例值:12321937198237912739132791732912793127
商户提现单号 out_request_no string[1, 32] 商户提现单号
示例值:20190611222222222200000000012122
提现金额 amount int 单位:分
示例值:1
发起提现时间 create_time string[29, 29] 遵循rfc3339标准格式,格式为yyyy-MM-DDTHH:mm:ss:sss+TIMEZONE,yyyy-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss:sss表示时分秒毫秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示,北京时间2015年5月20日13点29分35秒。
示例值:2015-05-20T13:29:35.120+08:00
提现状态更新时间 update_time string[29, 29] 遵循rfc3339标准格式,格式为yyyy-MM-DDTHH:mm:ss:sss+TIMEZONE,yyyy-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss:sss表示时分秒毫秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示,北京时间2015年5月20日13点29分35秒。
示例值:2015-05-20T13:29:35.120+08:00
失败原因 reason string[1, 255] 提现失败原因,仅在提现失败、退票、关单时有值
示例值:卡号错误
提现备注 remark string[1, 56] 商户对提现单的备注,若发起提现时未传入相应值或输入不合法,则该值为空
示例值:交易提现
银行附言 bank_memo string[1, 32] 展示在收款银行系统中的附言,由数字、字母、汉字组成(能否成功展示依赖银行系统支持)。若发起提现时未传入相应值或输入不合法,则该值为空
示例值:微信提现

返回示例


{
  "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": "微信提现"
}
                    

http://2323weixin.qq.com
                    

错误码公共错误码

状态码 错误码 描述 解决方案
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_CONFIRM 二级商户未开启手动提现权限 二级商户号提现权限已关闭,无法发起提现
403 ACCOUNT_NOT_VERIFIED 二级商户下行打款未成功 二级商户号结算银行卡信息有误,修改后重试
403 ACCOUNT_ERROR 二级商户未绑卡 二级商户号没有绑定结算银行卡,绑定后重试


版本说明

关闭
V1.2
2020年09月28日
1. 修改接口注意事项
2. 提现单状态新增枚举值INIT(业务单处于刚创建状态,需要重入驱动到受理成功)状态
3. 修改返回参数sub_mchid、create_time、update_time、reason、remark、bank_memo字段的必填项,及reason、remark、bank_memo字段的描述
V1.1
2020.04.13
1. 二级商户查询提现状态新增商户提现单号方式
V1.0
2019.09.18
1. 二级商户提现状态查询接口上线

技术咨询

文档反馈