登录
基础
连接微信
办公
企业内部开发 服务端API 企业支付 创建对外收款账户 查询申请单状态
查询申请单状态
最后更新：2023/11/30
通过这个接口查询已提交的申请单状态，只能使用该应用本身提交的申请单号
使用提交创建对外收款账户的申请单接口中填写的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 | 已签约 |
- 查询申请单状态
本节内容
