通过这个接口查询已提交的申请单状态,只能使用该应用本身提交的申请单号
使用提交创建对外收款账户的申请单接口中填写的out_request_no来查询
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/miniapppay/get_applyment_status?access_token=ACCESS_TOKEN
权限说明:
调用的应用需要满足如下的权限,且只允许获取由应用本身提交的申请单
应用类型 | 权限要求 |
---|---|
自建应用 | 配置到「对外收款- 可调用接口的应用」中 |
代开发应用 | 暂不支持 |
第三方应用 | 暂不支持 |
注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情
请求包体:
{
"out_request_no":"xxxxx"
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
out_request_no | 是 | 业务申请编号,长度限制为1~32个字符,在提交创建对外收款账户的申请单中提交 |
返回数据:
{
"errcode":0,
"errmsg":"ok",
"status":
{
"applyment_state":"xxxxx",
"applyment_state_desc":"xxxxx",
"sign_state":"xxxxx",
"sign_url":"xxxxx",
"sub_mchid":"xxxxx",
"audit_detail": [
{
"param_name":"xxxxx",
"reject_reason":"xxxxx"
},
{
"param_name":"xxxxx",
"reject_reason":"xxxxx"
}
],
"account_validation":
{
"account_name":"xxxxx",
"account_no":"xxxxx",
"pay_amount":0,
"destination_account_number":"xxxxx",
"destination_account_name":"xxxxx",
"destination_account_bank":"xxxxx",
"city":"xxxxx",
"remark":"xxxxx",
"deadline":"xxxxx",
},
"legal_validation_url":"xxxxx"
},
"apply_state":1,
"real_sign_state":2,
"reject_reason":"xxxxx"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述 |
status | 申请单的具体状态,参考申请单状态参数说明 |
apply_state | 申请单当前所处阶段,对应关系参考申请阶段对应关系 |
real_sign_state | 当前签约阶段,对应关系参考签约阶段对应关系 |
reject_reason | 驳回理由 |
申请单状态参数说明:
参数 | 说明 |
---|---|
applyment_state | 申请状态枚举值参考申请状态枚举值 |
applyment_state_desc | 申请状态描述 |
sign_state | 签约状态枚举值参考签约状态枚举值 |
sign_url | 签约链接1、当申请状态为NEED_SIGN 或 签约状态为UNSIGNED时返回,该链接为永久有效;2、申请单中的超级管理者,需用已实名认证的微信扫码打开,完成签约。 |
sub_mchid | 电商平台二级商户号当申请状态为NEED_SIGN或FINISH时才返回。 |
audit_detail | 驳回原因详情各项资料的审核情况。当申请状态为REJECTED或 FROZEN时才返回。 |
audit_detail.param_name | 参数名称提交申请单的资料项名称。 |
audit_detail.reject_reason | 驳回原因提交资料项被驳回原因。 |
account_validation | 汇款账户验证信息当签约阶段字段(real_sign_state字段,注意不是status字段下的sign_state字段)的值为2(即已签约)时才有可能返回。当申请状态为ACCOUNT_NEED_VERIFY 时有返回,可根据指引汇款,完成账户验证。 参考汇款账户验证信息参数说明 |
legal_validation_url | 法人验证链接当签约阶段字段(real_sign_state字段,注意不是status字段下的sign_state字段)的值为2(即已签约)时才有可能返回。1、当申请状态为ACCOUNT_NEED_VERIFY,且通过系统校验的申请单,将返回链接。 2、建议将链接转为二维码展示,让商户法人用微信扫码打开,完成账户验证。 注:商户申请单进入审核状态后,微信侧会校验法人证件号码是否跟营业执照匹配,若匹配,返回该字段 ; 若不匹配,不支持法人扫码验证,不返回该字段。 |
申请状态枚举值:
参数 | 对应状态 | 参数 | 对应状态 |
---|---|---|---|
CHECKING | 资料校验中 | NEED_SIGN | 待签约 |
ACCOUNT_NEED_VERIFY | 待账户验证 | FINISH | 完成 |
AUDITING | 审核中 | FROZEN | 已冻结 |
REJECTED | 已驳回 | CANCELED | 已作废 |
签约状态枚举值:
参数 | 对应状态 |
---|---|
UNSIGNED | 未签约。该状态下,电商平台可查询获取签约链接,引导二级商户的超级管理员完成签约 |
SIGNED | 已签约。指二级商户的超级管理员已完成签约。注意:若申请单被驳回,商户修改了商户主体名称、法人名称、超级管理员信息、主体类型等信息,则需重新签约 |
NOT_SIGNABLE | 不可签约。该状态下,暂不支持超级管理员签约。一般为申请单处于已驳回、已冻结、机器校验中状态,无法签约 |
汇款账户验证信息参数说明:
参数 | 说明 |
---|---|
account_name | 付款户名需商户使用该户名的账户进行汇款。 |
account_no | 付款卡号结算账户为对私时会返回,商户需使用该付款卡号进行汇款。 |
pay_amount | 汇款金额需要汇款的金额(单位:分)。 |
destination_account_number | 收款卡号收款账户的卡号 |
destination_account_name | 收款户名destination_account_name |
destination_account_bank | 开户银行收款账户的开户银行名称。 |
city | 省市信息收款账户的省市。 |
remark | 备注信息商户汇款时,需要填写的备注信息。 |
deadline | 汇款截止时间请在此时间前完成汇款。 |
申请阶段对应关系:
参数 | 对应关系 | 参数 | 对应关系 |
---|---|---|---|
0 | 初始状态 | 4 | 绑定失败 |
1 | 申请中 | 5 | 未申请 |
2 | 绑定成功 | 6 | 待法人验证 |
3 | 已撤销申请 |
签约阶段对应关系:
参数 | 对应关系 |
---|---|
0 | 不可签约 |
1 | 未签约 |
2 | 已签约 |