alipay.security.risk.customerrisk.query(商户风险服务输出) 在线调试(沙箱环境)

服务商/银行准入商户时,根据身份证,银行卡号判断待准入商户是否有风险

公共参数

请求地址

环境HTTPS请求地址
正式环境 https://openapi.alipay.com/gateway.do

公共请求参数

参数 类型 是否必填最大长度描述示例值
app_id String 32 支付宝分配给开发者的应用ID 2014072300007148
method String 128 接口名称 alipay.security.risk.customerrisk.query
format String 40 仅支持JSON JSON
charset String 10 请求使用的编码格式,如utf-8,gbk,gb2312等 utf-8
sign_type String 10 商户生成签名字符串所使用的签名算法类型,目前支持RSA2和RSA,推荐使用RSA2 RSA2
sign String 344 商户请求参数的签名串,详见签名 详见示例
timestamp String 19 发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" 2014-07-24 03:07:50
version String 3 调用的接口版本,固定为:1.0 1.0
app_auth_token String 40 详见应用授权概述
biz_content String 请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

请求参数

参数 类型 是否必填 最大长度 描述 示例值
risk_type String 必选 1024 查询商户风险类型时:支持以下三种:riskinfo_cert_no(身份证风险查询),riskinfo_bank_card_no(银行卡风险查询),riskinfo_business_license_no(营业执照风险查询)
查询ISV风险类型时:支持以下二种:riskinfo_cert_no_isv(服务商法人身份证风险查询),riskinfo_business_license_no_isv(营业执照风险查询)。
营销作弊风险场景:riskinfo_marketing
先享后付保障风险场景:riskinfo_nsf
使用服务时指定查询风险类型,且一次调用可以传递多个风险类型,用英文逗号隔开。
riskinfo_cert_no,riskinfo_bank_card_no,riskinfo_business_license_no,riskinfo_cert_no_isv,riskinfo_business_license_no_isv
cert_no String 可选 128 用于传递需查询风险的身份证号码 412829111111XXXXX
card_no String 可选 128 用于境外银行卡号的查询(预留) 6228480402637874213
mobile_no String 可选 128 用于查询手机号是否来自风险用户 13810935692
bank_card_no String 可选 128 用于查询银行卡号是否有风险 6228480402637874213
business_license_no String 可选 1024 用于查询营业执照是否来自风险商户 76s4sf2323
company_name String 可选 1024 用于查询公司名称是否来自风险公司 杭州支小宝有限责任公司
external_id String 可选 1024 间连交易场景下,银行类合作伙伴记录的风险商户ID 34s3erwes6

响应参数

参数 类型 是否必填 最大长度 描述 示例值
risk_result String 必填 1024 risk_result:风险分析结果,主要有三种类型,分别为是否有风险(has_risk,no_risk),风险等级("rank_1"...,"rank_10"),归一化的风险评分(0-100),每一次返回,根据配置的不同,可以返回样的风险类型,也可以返回不同的风险结果类型 {"merchant_fraud ": "has_risk" , "merchant_general":"rank_1","merchant_busiess":"71.5"}
risk_result_desc String 必填 1024 risk_result_desc:风险结果的返回值描述,因为每次返回值不一样,因此需要给出返回值说明,避免接入方维护这种对应关系 {"has_risk":"有风险","rank_1":"等级1","71.5":"评分71.5"}

请求示例

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AlipaySecurityRiskCustomerriskQueryRequest request = new AlipaySecurityRiskCustomerriskQueryRequest();
request.setBizContent("{" +
"\"risk_type\":\"riskinfo_cert_no,riskinfo_bank_card_no,riskinfo_business_license_no,riskinfo_cert_no_isv,riskinfo_business_license_no_isv\"," +
"\"cert_no\":\"412829111111XXXXX\"," +
"\"card_no\":\"6228480402637874213\"," +
"\"mobile_no\":\"13810935692\"," +
"\"bank_card_no\":\"6228480402637874213\"," +
"\"business_license_no\":\"76s4sf2323\"," +
"\"company_name\":\"杭州支小宝有限责任公司\"," +
"\"external_id\":\"34s3erwes6\"" +
"  }");
AlipaySecurityRiskCustomerriskQueryResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

响应示例

{
    "alipay_security_risk_customerrisk_query_response": {
        "code": "10000",
        "msg": "Success",
        "risk_result": "{\"merchant_fraud \": \"has_risk\" , \"merchant_general\":\"rank_1\",\"merchant_busiess\":\"71.5\"}",
        "risk_result_desc": "{\"has_risk\":\"有风险\",\"rank_1\":\"等级1\",\"71.5\":\"评分71.5\"}"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

异常示例

{
    "alipay_security_risk_customerrisk_query_response": {
        "code": "20000",
        "msg": "Service Currently Unavailable",
        "sub_code": "isp.unknow-error",
        "sub_msg": "系统繁忙"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

业务错误码

公共错误码

错误码错误描述解决方案
BIZ_ERROR 业务异常服务没有被授权,比如虽然已经签约query服务,但是没有被授权查询商户综合风险,出这个异常 联系商户服务团队,在服务申请页面中申请此细项服务的授权
INVALID_PARAMETER 参数有误没有按照要求进行入参,比如要求mobile_no,但是输入了mobile 请查看接口文档,查看参数是否正确配置
SYSTEM_ERROR 系统繁忙 内部系统分析超时,请给出时间,以及入参,联系BD,进行内部分析
INVALID_PARAMETER 参数有误缺少必选参数 请查看接口文档,查看参数是否配置正确。比如查询身份证号黑名单风险,但是传递的是银行卡号。
onlineServer