事前-風(fēng)險(xiǎn)商戶核查接口
應(yīng)用場(chǎng)景
- ◆ 身份信息:身份證號(hào)、身份證所有人姓名。(如果有身份信息數(shù)據(jù),所有身份字段必填);
- ◆ 結(jié)算信息:結(jié)算賬號(hào)、結(jié)算戶名、結(jié)算銀行(如果有結(jié)算信息數(shù)據(jù),所有結(jié)算字段必填);
- ◆ 公司信息:營(yíng)業(yè)執(zhí)照編號(hào)、公司名稱(如果有公司信息數(shù)據(jù),所有公司字段必填);
- ◆ 門(mén)店信息:門(mén)店地址、門(mén)店經(jīng)度、門(mén)店緯度(如果有門(mén)店信息數(shù)據(jù),所有門(mén)店字段必填);
為了提升特約商戶錄入質(zhì)量,發(fā)現(xiàn)并及時(shí)中止特約商戶風(fēng)險(xiǎn)交易行為,現(xiàn)面向銀行服務(wù)商開(kāi)放風(fēng)險(xiǎn)商戶數(shù)據(jù),支持銀行在錄入商戶前提前核查商戶風(fēng)險(xiǎn)、了解風(fēng)險(xiǎn)交易、并且將風(fēng)險(xiǎn)處理結(jié)果同步微信支付.
用于服務(wù)商/銀行準(zhǔn)入商戶時(shí),根據(jù)身份證,銀行卡號(hào),營(yíng)業(yè)執(zhí)照等信息查詢商戶是否有風(fēng)險(xiǎn).
說(shuō)明:
該接口需要提供以下信息至少一種,提供的信息越多,查詢結(jié)果越準(zhǔn)確.
接口規(guī)則
URL路徑 | https://api.mch.weixin.qq.com/mchrisk/querymchrisk |
是否需要證書(shū) | 請(qǐng)求需要雙向證書(shū)詳見(jiàn)證書(shū)使用 |
請(qǐng)求參數(shù)
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
服務(wù)商號(hào) |
mch_id |
是 |
String(32) |
1900000109 |
微信支付分配的服務(wù)商號(hào) |
平臺(tái)證書(shū)序列號(hào) |
cert_serial_number |
否 |
String(32) |
XXXXX |
微信支付平臺(tái)分配的證書(shū)序列號(hào) |
身份證號(hào)(需加密) |
certificates_number |
否 |
String(344) |
8609cb22e1774a50a930e414cc71eca06121bcd266335cda230d24a7886a8d9f |
身份證號(hào)(采用標(biāo)準(zhǔn)RSA算法,公鑰由微信側(cè)提供),詳見(jiàn)獲取RSA加密公鑰API |
身份證所有人姓名(需加密) |
certificates_name |
否 |
String(344) |
ca775af5f841bdf424b2e6eb86a6e21e |
身份證人姓名(采用標(biāo)準(zhǔn)RSA算法,公鑰由微信側(cè)提供),詳見(jiàn)獲取RSA加密公鑰API |
結(jié)算賬號(hào)(需加密) |
settlement_?card_no |
否 |
String(344) |
8609cb22e1774a50a930e414cc71eca06121bcd266335cda230d24a7886a8d9f |
結(jié)算的銀行卡號(hào)(采用標(biāo)準(zhǔn)RSA算法,公鑰由微信側(cè)提供),詳見(jiàn)獲取RSA加密公鑰API |
結(jié)算戶名(需加密) |
settlement_card_name |
否 |
String(344) |
ca775af5f841bdf424b2e6eb86a6e21e |
結(jié)算的銀行卡賬號(hào)名(采用標(biāo)準(zhǔn)RSA算法,公鑰由微信側(cè)提供),詳見(jiàn)獲取RSA加密公鑰API |
結(jié)算銀行 |
settlement_card_bank |
否 |
String(128) |
招商銀行科技園支行 |
結(jié)算銀行 |
營(yíng)業(yè)執(zhí)照編號(hào)(需加密) |
business_license_number |
否 |
String(344) |
ca775af5f841bdf424b2e6eb86a6e21e |
營(yíng)業(yè)執(zhí)照編號(hào)(采用標(biāo)準(zhǔn)RSA算法,公鑰由微信側(cè)提供),詳見(jiàn)獲取RSA加密公鑰API |
公司名稱 |
company_name |
否 |
String(128) |
XXXXX有限公司 |
公司名稱 |
門(mén)店地址 |
store_address |
否 |
String(256) |
廣東省深圳市南山區(qū)深南大道10000號(hào) |
門(mén)店地址 |
門(mén)店經(jīng)度 |
store_longitude |
否 |
String(32) |
22.5461478801 |
門(mén)店經(jīng)度 |
門(mén)店緯度 |
store_latitude |
否 |
String(32) |
113.9410519639 |
門(mén)店緯度 |
隨機(jī)字符串 |
nonce_str |
是 |
String(32) |
C380BEC2BFD787A4B6845227519F3AD6 |
|
簽名 |
sign |
是 |
String(32) |
5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
|
簽名類型 |
sign_type |
是 |
String(32) |
HMAC-SHA256 |
簽名類型,目前支持HMAC-SHA256,該字段需要參與簽名sign計(jì)算。 |
返回結(jié)果
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
返回狀態(tài)碼 |
return_code |
是 |
String(16) |
SUCCESS |
SUCCESS/FAIL |
返回信息 |
return_msg |
否 |
String(128) |
簽名失敗 |
返回信息,如非空,為錯(cuò)誤原因 |
以下字段在return_code為SUCCESS的時(shí)候有返回
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
業(yè)務(wù)結(jié)果 | result_code | 是 | String(16) | SUCCESS | 取值為SUCCESS/FAIL 表示業(yè)務(wù)處理結(jié)果 |
服務(wù)商號(hào) | mch_id | 是 | String(32) | 1900000109 | 微信支付分配的服務(wù)商號(hào) |
風(fēng)險(xiǎn)級(jí)別 | risk_level | 是 | String(32) | LOW 建議不讓高風(fēng)險(xiǎn)商戶進(jìn)件,禁止禁入商戶進(jìn)件 |
UNKNOW:未知風(fēng)險(xiǎn) NORMAL:一般 MEDIUM:中風(fēng)險(xiǎn) HIGH:高風(fēng)險(xiǎn) LOW:低風(fēng)險(xiǎn) FORBIDDEN: 禁入 |
風(fēng)險(xiǎn)描述 | risk_level_desc | 是 | String(1024) | 低風(fēng)險(xiǎn) | 風(fēng)險(xiǎn)交易相關(guān)的投訴信息 |