微信支付-开发者文档

返回上一层文档首页 / 微信支付提现申请单号查询提现申请单状态API

微信支付提现申请单号查询提现申请单状态API

最新更新时间：2022.12.01 版本说明

微信支付提现申请单号查询提现申请单状态,电商平台发起申请后, 电商平台调用此接口查询审批和出款进度

接口说明

适用对象：服务商

请求URL：https://api.mch.weixin.qq.com/v3/mch_operate/risk/withdrawl-apply/applyment-id/{applyment_id}

请求方式：GET

path 指该参数为路径参数

query 指该参数为URL参数

body 指该参数需在请求JSON传参

请求参数

参数名	变量	类型[长度限制]	必填	描述
微信支付提现申请单号	applyment_id	string[1, 32]	是	path提现申请单的主键，唯一定义此资源的标识示例值：20220210183333

请求示例


https://api.mch.weixin.qq.com/v3/mch_operateecommerce/risk/withdrawl-apply/applyment-id/20220210183333


｛
JAVA示例代码
｝

返回参数

参数名

变量

类型[长度限制]

必填

描述

+ 提现申请单信息

withdrawl_apply

object

是

提现申请单信息

参数名	变量	类型[长度限制]	必填	描述
微信支付提现申请单号	applyment_id	string[1, 32]	是	电商平台提交二级商户可用余额提现申请后，由微信支付返回的申请单号，作为查询申请状态的唯一标识。示例值：20220101332222
商户提现申请单号	out_request_no	string[1, 32]	是	商户预约提现单号，由商户自定义生成，需要全局唯一示例值：1234567
申请单状态	state	string	是	状态 SUBMITTED：受理成功，等待审核 PASSED：付款执行中 PAY_SUCCEED：付款成功 REJECTED：审批驳回 PAY_FAILED：付款失败 BANK_REFUNDED：银行退票示例值：SUBMITTED
失败原因	fail_reason	string[1, 1024]	否	包含付款关闭原因、付款失败原因、付款退票原因示例值：银行卡信息有误
最后更新时间	modify_time	string[1, 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秒。示例值：2015-05-20T13:29:35+08:00

返回示例

正常示例


{
  "withdrawl_apply": {
    "applyment_id": "20220101332222",
    "fail_reason": "银行卡信息有误",
    "modify_time": "2015-05-20T13:29:35+08:00",
    "out_request_no": "1234567",
    "state": "SUBMITTED"
  }
}


http://2323weixin.qq.com

错误码公共错误码

状态码	错误码	描述	解决方案
403	NO_AUTH	商户暂无权限使用此功能	仅允许电商平台允许使用。
400	PARAM_ERROR	参数错误	请使用正确的参数重新调用
404	NOT_FOUND	单号不存在	查询单据为空, 请确认单号是否填写正确

技术咨询

文档反馈

微信支付合作伙伴平台