查询升级申请单状态接口

场景介绍

使用“提交升级申请单”接口后,可不定期调用此接口查询申请单状态(建议提交申请后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方法
xml格式错误
协议转换时发生系统错误
未检测到必填参数XXX
请求参数签名错误
返回结果时签名失败

当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:资料校验中
ACCOUNT_NEED_VERIFY:待账户验证
AUDITING:审核中
REJECTED:已驳回
NEED_SIGN:待签约
FINISH:完成
FROZEN:已冻结

申请状态描述

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

参数错误

参数填写有误,请检查后重试

人工检查过滤