查询升级申请单状态接口
场景介绍
使用“提交升级申请单”接口后,可不定期调用此接口查询申请单状态(建议提交申请后1分钟查询),直至申请单为“完成”状态。
1)若申请状态为待账户验证,请按接口中的指引完成账户验证
2)若申请状态为审核中,微信支付会在2个工作日内完成资料审核
3)若申请状态为待签约,接口会返回签约二维码
接口规则
请求Url | https://api.mch.weixin.qq.com/applyment/micro/getupgradestate |
是否需要证书 | 是, 详见证书使用 |
请求参数
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
---|---|---|---|---|---|
接口版本号 |
version |
是 |
String(32) |
1.0 |
默认值1.0 |
商户号 |
mch_id |
是 |
String(32) |
1230000109 |
服务商的商户号 |
随机字符串 |
nonce_str |
是 |
String(32) |
ibuaiVcKdpRxkhJA |
参考签名规则 |
签名类型 |
sign_type |
是 |
String(128) |
HMAC-SHA256 |
签名类型,仅支持HMAC-SHA256 |
签名 |
sign |
是 |
String(64) |
D675A1E471DBF7C0B1AC5883B5BDA9EF |
参考签名规则 |
小微商户号 |
sub_mch_id |
是 |
String(32) |
1230000109 |
小微商户的商户号(小微申请状态需为待签约或完成) |
返回结果
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
---|---|---|---|---|---|
返回状态码 |
return_code |
是 |
String(16) |
FAIL |
SUCCESS/FAIL |
返回信息 |
return_msg |
否 |
String(128) |
签名失败 |
只支持POST方法 |
当return_code为SUCCESS的时候,还会包括以下字段:
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
---|---|---|---|---|---|
随机字符串 |
nonce_str |
是 |
String(32) |
ibuaiVcKdpRxkhJA |
随机字符串 |
签名 |
sign |
是 |
String(32) |
D675A1E471DBF7C0B1AC5883B5BDA9EF |
详见签名生成算法 |
业务结果 |
result_code |
是 |
String(32) |
SUCCESS |
SUCCESS/FAIL |
错误代码 |
err_code |
否 |
String(32) |
PARAM_ERROR |
参考业务错误码列表 |
错误代码描述 |
err_code_des |
否 |
String(128) |
商户号信息有误,请检查修改后重试 |
参考业务错误码列表 |
以下字段当return_code 、result_code都为SUCCESS时有返回
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
---|---|---|---|---|---|
小微商户号 |
sub_mch_id |
是 |
String(32) |
1230000109 |
小微商户的商户号 |
申请状态 |
applyment_state |
是 |
String(32) |
REJECTED |
CHECKING:资料校验中 |
申请状态描述 |
applyment_state_desc |
是 |
String(32) |
已驳回 |
申请状态描述 UPGRADED:已升级 已驳回 |
签约二维码 |
sign_qrcode |
否 |
String(256) |
https://pay.weixin.qq.com |
当申请状态为NEED_SIGN或FINISH时才返回 |
签约链接 |
sign_url |
否 |
String(256) |
https://pay.weixin.qq.com |
当申请状态为NEED_SIGN或FINISH时才返回 |
审核详情 |
audit_detail |
否 |
String(1024) |
详情参考2.2.5 |
各项资料的审核情况。当申请状态为REJECTED或 FROZEN时才返回。字段值为json格式,详情参考2.2.5。 |
以下字段当 applyment_state 为ACCOUNT_NEED_VERIFY 时有返回,请商户按照以下信息进行汇款,以完成账户验证
注:1、个体户、企业,无此账户验证环节;2、验证结束后,汇款金额将全额退还至汇款账户。
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
---|---|---|---|---|---|
付款户名 |
account_name |
是 |
String(32) |
|
需商户使用该户名的账户进行汇款 |
汇款金额 |
pay_amount |
是 |
String(32) |
124 |
需要汇款的金额(单位 分) |
收款卡号 |
destination_account_number |
是 |
String(128) |
7222223333322332 |
收款账户的卡号 |
收款户名 |
destination_account_name |
是 |
String(256) |
财付通支付科技有限公司 |
收款账户名 |
开户银行 |
destination_account_bank |
是 |
String(256) |
招商银行威盛大厦支行 |
收款账户的开户银行名称 |
省市信息 |
city |
是 |
String(128) |
深圳 |
收款账户的省市 |
备注信息 |
remark |
是 |
String(128) |
入驻账户验证 |
商户汇款时,需要填写的备注信息 |
汇款截止时间 |
deadline_time |
是 |
String(20) |
2018-12-1017:09:01 |
请在此时间前完成汇款 |
审核详情audit_detail字段值为json格式,包含各个资料项的审核状态:
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
---|---|---|---|---|---|
参数名称 |
param_name |
是 |
String(32) |
1230000109 |
与2.1.3对应 |
驳回原因 |
reject_reason |
是 |
String(32) |
银行账户不存在 |
|
audit_detail字段值举例如下:
{
"audit_detail": [
{
"param_name": "account_no",
"reject_reason": "银行账户不存在"
},
{
"param_name": "mobile_phone",
"reject_reason ": "电话为空号"
}
]
}
错误码列表
错误代码 |
名称 |
描述 |
解决方案 |
---|---|---|---|
PARAM_ERROR |
参数错误 |
参数填写有误,请检查后重试 |
人工检查过滤 |