间连模式查询商户审核状态开放接口
更新时间:2024.08.08应用场景
用于从业机构通过渠道商接入商户时,查询渠道商下属的商户的审核信息.
简化子入驻时需要对商户进行审核,该接口支持清算机构、从业机构、渠道商查询审核状态.
◆ 从业机构:能够查询简化子进件状态,对渠道商进件的商户质量进行感知;
◆ 渠道商:能够查询简化子进件状态,实时了解直拓商户是否已经入驻成功;
备注:若商户已完成开户意愿确认,则从业机构和渠道商无需查询该商户的审核备注状态。
接口规则
URL路径 | https://api.mch.weixin.qq.com/mchrisk/bankquerymchauditinfo |
是否需要证书 | 否 |
请求方式 | POST |
请求参数
名称 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
服务商号 | mch_id | 是 | String(32) | 1900000109 | 微信支付分配的服务商号 |
子商户号 | sub_mch_id | 是 | String(32) | 999990016 | 要查询的子商户号 |
渠道号 | channel_id | 是 | String(32) | 999990017 | 要查询的子商户号对应的渠道号 |
随机字符串 | nonce_str | 是 | String(32) | C380BEC2BFD787A4B6847627519F3AD6 | 随机字符串,不长于32位。推荐随机数生成算法 |
签名 | sign | 是 | String(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | |
签名类型 | sign_type | 是 | String(32) | HMAC-SHA256 | 签名类型,目前只支持HMAC-SHA256 ,该字段需要参与签名sign计算。 |
返回结果
名称 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
返回状态码 | return_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL 此字段是通信标识,非业务标识,是否成功需要查看result_code来判断 |
返回结果 | return_msg | 是 | String(128) | 签名失败 | 返回信息,如非空,为错误原因,如签名失败,参数格式校验错误 |
以下字段在return_code为SUCCESS的时候有返回
名称 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
业务结果 | result_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL |
错误代码 | err_code | 否 | String(32) | SYSTEMERROR | 错误码,详见错误码说明 |
错误描述 | err_code_des | 否 | String(128) | 系统错误 | 错误信息描述 |
以下字段当return_code 、result_code都为SUCCESS时有返回
名称 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
服务商号 | mch_id | 是 | String(32) | 1900000109 | 微信支付分配的服务商号 |
子商户号 | sub_mch_id | 是 | String(32) | 999990016 | 要查询的子商户号 |
渠道号 | channel_id | 是 | String(32) | 999990017 | 要查询的子商户号对应的渠道号 |
审核状态 | audit_status | 是 | String(32) | AUDITING/PASSED/REJECTED | AUDITING:审核中 |
审核备注 | audit_comment | 是 | String(128) | RISK_NO_ENTRY | RISK_NO_ENTRY: 此商户风险较高,暂不支持接入 |
随机字符串 | nonce_str | 是 | String(32) | C380BEC2BFD757A4B6845179519F3AD6 | 随机字符串,不长于32位。推荐随机数生成算法 |
签名 | sign | 是 | String(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 通过签名算法计算得出的签名值,详见签名生成算法 |
签名类型 | sign_type | 否 | String(32) | HMAC-SHA256 | 签名类型,目前只支持HMAC-SHA256 |