服务商/银行准入商户时，根据身份证，银行卡号，营业执照等信息查询商户是否有风险；银行与服务商开展合作时，根据服务商法人身份证，营业执照等信息查询服务商是否有风险。
| 环境 |
HTTPS请求地址 |
| 正式环境 |
https://openapi.alipay.com/gateway.do |
有效的APPID：您需提供一个有效的应用ID（APPID）来调用此服务，您可前往https://openhome.alipay.com/platform/appManage.htm#/apps生成一个专属应用，或使用现有的APPID来申请此服务。
alipay.security.risk.customerrisk.query
2.1、请求入参说明
根据risk_type选择的不同，必传字段也不同
| Risk_type |
必填字段 |
场景 |
| riskinfo_cert_no |
cert_no |
通过商家身份证号识别风险 |
| riskinfo_bank_card_no |
bank_card_no |
通过商家银行卡识别风险 |
| riskinfo_business_license_no |
business_license_no |
通过商家营业执照编号识别风险 |
| riskinfo_merchant_name |
company_name | 通过商户名称查询 |
| riskinfo_contact_phone | mobile_no | 通过商户联系手机号进行查询 |
2.2、返回参数说明
has risk 有风险；当前咨询介质有风险；
no risk 无风险；或者相关介质主体信息有误；
请求地址：
| 环境 | HTTPS请求地址 |
|---|---|
| 正式环境 | https://openapi.alipay.com/gateway.do |
公共请求参数：
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
| app_id | String | 是 | 32 | 支付宝分配给开发者的应用ID | 2014072300007148 |
| method | String | 是 | 128 | 接口名称 | alipay.security.risk.customerrisk.query |
| format | String | 否 | 32 | 仅支持JSON | JSON |
| charset | String | 是 | 32 | 请求使用的编码格式，如utf-8,gbk,gb2312等 | utf-8 |
| sign_type | String | 是 | 32 | 商户生成签名字符串所使用的签名算法类型，目前支持RSA/RSA2。推荐使用RSA2 | RSA2 |
| sign | String | 是 | 1024 | 商户请求参数的签名串，详见签名 | 详见示例 |
| timestamp | String | 是 | 32 | 发送请求的时间，格式"yyyy-MM-dd HH:mm:ss" | 2014-07-24 03:07:50 |
| version | String | 是 | 12 | 调用的接口版本，固定为：1.0 | 1.0 |
| notify_url | String | 否 | 256 | 支付宝服务器主动通知商户服务器里指定的页面http/https路径 | http://api.test.alipay.net/atinterface/receive_notify.htm |
| app_auth_token | String | 否 | 40 | 详见应用授权概述 | |
| biz_content | String | 是 | 请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档 |
业务请求参数：
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
| service | String | 是 | 128 | 服务类型；固定值，riskinfo_query | riskinfo_query |
| risk_type | String | 是 | 1024 | riskinfo_cert_no（身份证风险查询）、 |
riskinfo_cert_no,riskinfo_bank_card_no ,riskinfo_business_license_no |
| cert_no | String | 是 | 128 | 身份证号，用于传递服务商查询接入的商户风险所需要的身份证号 | 412829111111XXXXX |
| bank_card_no | String | 是 | 128 | 银行卡号，用于传递服务商查询接入的商户的银行卡卡号 | 6228480402637874213 |
| business_license_no | String | 是 | 1024 | 营业执照号码 | 76s4sf2323 |
| mobile_no | String | 是 | 128 | 手机号，用于传递服务商查询接入的商户的手机号 | 13810935692 |
| company_name | String | 是 | 128 | 公司名称 | 杭州贸易有限公司 |
| external_id | String | 是 | 128 | 间连外部商户号；直连场景可以不传； 银行客户如果此时没有间联外部商户号，可以传client_id;同时在【间连商户分级入驻接口】memo中也传这个字段。 |
34s3erwes6 |
| store_mcc_desc | String | 否 | 128 | 门店行业类目 | 餐饮 |
| province_code |
String | 否 | 128 | 省编码；请按照https://gw.alipayobjects.com/os/basement_prod/253c4dcb-b8a4-4a1e-8be2-79e191a9b6db.xlsx 表格中内容填写。 （参考资料： http://www.stats.gov.cn/tjsj/tjbz/tjyqhdmhcxhfdm/） | 370000 |
| city_code | String | 否 | 128 | 城市编码；请按照https://gw.alipayobjects.com/os/basement_prod/253c4dcb-b8a4-4a1e-8be2-79e191a9b6db.xlsx 表格中内容填写。 （参考资料： http://www.stats.gov.cn/tjsj/tjbz/tjyqhdmhcxhfdm/） | 371000 |
| district_code |
String | 否 | 128 | 区域编码；请按照https://gw.alipayobjects.com/os/basement_prod/253c4dcb-b8a4-4a1e-8be2-79e191a9b6db.xlsx 表格中内容填写。 （参考资料： http://www.stats.gov.cn/tjsj/tjbz/tjyqhdmhcxhfdm/） | 371002 |
| outlet_address | String | 否 | 128 | 门店地址；不需要传城市和行政区 | 万塘路18号 |
公共响应参数：
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| code | String | 是 | - | 网关返回码 | 40004 |
| msg | String | 是 | - | 网关返回码描述 | Business Failed |
| sub_code | String | 否 | - | 业务返回码 | ACQ.TRADE_HAS_SUCCESS |
| sub_msg | String | 否 | - | 业务返回码描述 | 交易已被支付 |
| sign | String | 是 | - | 签名,详见文档 |
业务返回参数：
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| risk_result | String | 是 | 1024 | 风险分析结果，是否有风险以及参数是否合法（hasRisk,noRisk,illegalParameter) | {"riskinfo_business_license_no":"noRisk", "riskinfo_cert_no":"hasRisk", "riskinfo_bank_card_no":"noRisk"} |
| risk_result_desc | String | 是 | 1024 | 风险结果的返回值描述 | {"hasRisk":"有风险","noRisk":"无风险","illegalParameter":"入参不合法"} |
调用样例
{"biz_content":{"risk_type": "riskinfo_cert_no","cert_no": "232330199104112893","bank_card_no": "null","mobile_no": "18511908763","business_license_no": "98767888726","company_name": "测试有限公司","external_id": "104112893"}
}
返回数据样例
{"alipay_security_risk_customerrisk_query_response": {"code": "10000","msg": "Success","risk_result_desc": "{\"has risk\":\"有风险\"}","risk_result": "{\"risk_result\":\"no risk\"}"},"sign": "MYGSTtwUjh55AT1D9CMLqfM75CCZ5P8udILbpw6qYsfJK+s9qUf90WM1bQvUNKBq3n8Km1q6gud7Q+js+1lqCVKrXj4xHIQMjLcvbILz1AzL0a7vMyJrWugm0OJqpy1RK5sf/H7I8xo5wp3ZoN0DMgLRVRwPsvU7Qxv8SpgHVoa/YXIZIdfK+lBVTiXJaSPgoGCjAyXux+RV4XzMqQsXRgUW8PGPLjEVuZ69CiYfHyNrPZXyjgXopmNxG0YiCr5VrvPTg3TuKvfR7OiqqLR381LcM/Ar+jh99FaSyBjXFjQpZihXKqHM485OswiRyNtFllMkNmqaXPBn9epoPUicqg=="}
