間聯(lián)模式查詢商戶審核狀態(tài)開放接口
應(yīng)用場景
- ◆ 從業(yè)機(jī)構(gòu):能夠查詢簡化子進(jìn)件狀態(tài),對渠道商進(jìn)件的商戶質(zhì)量進(jìn)行感知;
- ◆ 渠道商:能夠查詢簡化子進(jìn)件狀態(tài),實(shí)時(shí)了解直拓商戶是否已經(jīng)入駐成功;
用于從業(yè)機(jī)構(gòu)通過渠道商接入商戶時(shí),查詢渠道商下屬的商戶的審核信息.
簡化子入駐時(shí)需要對商戶進(jìn)行審核,該接口支持清算機(jī)構(gòu)、從業(yè)機(jī)構(gòu)、渠道商查詢審核狀態(tài).
備注:若商戶已完成開戶意愿確認(rèn),則從業(yè)機(jī)構(gòu)和渠道商無需查詢該商戶的審核備注狀態(tài)。
接口規(guī)則
URL路徑 | https://api.mch.weixin.qq.com/mchrisk/bankquerymchauditinfo |
是否需要證書 | 否 |
請求方式 | POST |
請求參數(shù)
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
服務(wù)商號(hào) |
mch_id |
是 |
String(32) |
1900000109 |
微信支付分配的服務(wù)商號(hào) |
子商戶號(hào) |
sub_mch_id |
是 |
String(32) | 999990016 |
要查詢的子商戶號(hào) |
渠道號(hào) |
channel_id |
是 |
String(32) |
999990017 |
要查詢的子商戶號(hào)對應(yīng)的渠道號(hào) |
隨機(jī)字符串 |
nonce_str |
是 |
String(32) |
C380BEC2BFD787A4B6847627519F3AD6 |
|
簽名 |
sign |
是 |
String(32) |
5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
|
簽名類型 |
sign_type |
是 |
String(32) |
HMAC-SHA256 |
簽名類型,目前只支持HMAC-SHA256 ,該字段需要參與簽名sign計(jì)算。 |
返回結(jié)果
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
返回狀態(tài)碼 |
return_code |
是 |
String(16) |
SUCCESS |
SUCCESS/FAIL 此字段是通信標(biāo)識(shí),非業(yè)務(wù)標(biāo)識(shí),是否成功需要查看result_code來判斷 |
返回結(jié)果 |
return_msg |
是 |
String(128) |
簽名失敗 |
返回信息,如非空,為錯(cuò)誤原因,如簽名失敗,參數(shù)格式校驗(yàn)錯(cuò)誤 |
以下字段在return_code為SUCCESS的時(shí)候有返回
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
業(yè)務(wù)結(jié)果 |
result_code |
是 |
String(16) |
SUCCESS |
SUCCESS/FAIL |
錯(cuò)誤代碼 |
err_code |
否 |
String(32) |
SYSTEMERROR |
錯(cuò)誤碼,詳見錯(cuò)誤碼說明 |
錯(cuò)誤描述 |
err_code_des |
否 |
String(128) |
系統(tǒng)錯(cuò)誤 |
錯(cuò)誤信息描述 |
以下字段當(dāng)return_code 、result_code都為SUCCESS時(shí)有返回
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
服務(wù)商號(hào) |
mch_id |
是 |
String(32) |
1900000109 |
微信支付分配的服務(wù)商號(hào) |
子商戶號(hào) |
sub_mch_id |
是 |
String(32) |
999990016 |
要查詢的子商戶號(hào) |
渠道號(hào) |
channel_id |
是 |
String(32) |
999990017 |
要查詢的子商戶號(hào)對應(yīng)的渠道號(hào) |
審核狀態(tài) |
audit_status |
是 |
String(32) |
AUDITING/PASSED/REJECTED |
AUDITING:審核中 |
審核備注 | audit_comment | 是 | String(128) | RISK_NO_ENTRY | RISK_NO_ENTRY: 此商戶風(fēng)險(xiǎn)較高,暫不支持接入 COMPANYNAME_NO_RESULT: 此商戶企業(yè)名稱在工商局查不到記錄,請核實(shí)商戶名稱 RISK_DELAY_ENTRY: 此商戶資料審核中,請耐心等待 CHANNEL_NEED_MERCHANT_COMFIRM: 貴渠道下的商戶需完成開戶意愿確認(rèn) SUBJECT_NEED_MERCHANT_COMFIRM: 此商戶主體已存在,請聯(lián)系商戶確認(rèn)開戶意愿 TRADE_NEED_MERCHANT_COMFIRM: 此商戶需要補(bǔ)充特殊行業(yè)資料,請進(jìn)行開戶意愿確認(rèn) RISK_NEED_MERCHANT_COMFIRM: 此商戶主體存在風(fēng)險(xiǎn),請補(bǔ)充相關(guān)資料 INCOM_NUMBER_ABNORMAL:貴渠道當(dāng)日商戶進(jìn)件頻次異常,請次日嘗試進(jìn)件 |
隨機(jī)字符串 |
nonce_str |
是 |
String(32) |
C380BEC2BFD757A4B6845179519F3AD6 |
隨機(jī)字符串,不長于32位。推薦隨機(jī)數(shù)生成算法 |
簽名 |
sign |
是 |
String(32) |
5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
通過簽名算法計(jì)算得出的簽名值,詳見簽名生成算法 |
簽名類型 |
sign_type |
否 |
String(32) |
HMAC-SHA256 |
簽名類型,目前只支持HMAC-SHA256 |