商户提现申请单号查询提现申请单状态

更新时间：2024.11.05

电商平台发起申请后, 电商平台调用此接口查询审批和出款进度

接口说明

支持商户：【平台商户】

请求方式：【GET】/v3/mch_operate/risk/withdrawl-apply/out-request-no/{out_request_no}

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

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引点击查看

请求参数

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

path 路径参数

out_request_no 　必填 string(32)

【商户提现申请单号】由商户自定义生成的、在提交接口传入的单号

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/mch_operate/risk/withdrawl-apply/out-request-no/123283928932 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

withdrawl_apply 　必填 object

【提现申请单信息】提现申请单信息

属性

applyment_id 　必填 string(32)

【微信支付提现申请单号】电商平台提交二级商户可用余额提现申请后，由微信支付返回的申请单号，作为查询申请状态的唯一标识。

out_request_no 　必填 string(32)

【商户提现申请单号】商户预约提现单号，由商户自定义生成，需要全局唯一

state 　必填 string

【申请单状态】状态

可选取值：

SUBMITTED: 等待审核

PASSED: 付款执行中

PAY_SUCCEED: 付款成功

REJECTED: 审批驳回

PAY_FAILED: 付款失败

BANK_REFUNDED: 银行退票

fail_reason 　选填 string(1024)

【失败原因】包含付款关闭原因、付款失败原因、付款退票原因

modify_time 　选填 string(32)

【最后更新时间】遵循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秒。

应答示例

200 OK

1{
2  "withdrawl_apply" : {
3    "applyment_id" : "20220101332222",
4    "out_request_no" : "1234567",
5    "state" : "SUBMITTED",
6    "fail_reason" : "银行卡信息有误",
7    "modify_time" : "2015-05-20T13:29:35+08:00"
8  }
9}
10

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
400	RESOURCE_ALREADY_EXISTS	重复提交, 商户的提现申请单号已经存在, 请调用查询状态接口检查	重复提交, 商户的提现申请单号已经存在, 请调用查询状态接口检查
403	NO_AUTH	商户暂无权限使用此功能	仅允许电商平台允许使用。
403	NOTENOUGH	二级商户号账户可用余额不足	二级商户号账户可用余额不足
429	FREQUENCY_LIMITED	频率限制	请降低频率后重试

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服