商户真实性认证接口文档

更新时间：2019/08/13 访问次数：5072

1. 服务说明

1) 服务适用场景

针对服务商行业，在进行商户准入过程中，存在对于商户底线风险及真实性风险进行校验。

2) 服务调用方式

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

3) 服务申请前的准备工作

有效的APPID：您需提供一个有效的应用ID（APPID）来调用此服务，您可前往

https://openhome.alipay.com/platform/appManage.htm#/apps生成一个专属应用，

或使用现有的APPID来申请此服务。

2. 接口说明

1) 接口名称

alipay.security.risk.customerrisk.query

2) 参数说明

1、入参说明

business_license_no必填；其余字段选填；

入参信息里包含身份证（cert_no）、银行卡号（bank_card_no）和手机号（mobile_no）策略识别会更准确。

2、返回参数说明

风险评级说明：

评级结果	评级说明
rank0	信息不足或提供的参数有误
rank1	表示真实性风险较高
rank2	表示真实性风险中等
rank3	表示真实性风险较低

3) 业务请求参数

参数	类型	是否必填	最大长度	描述	示例值
service	String	是	128	服务类型,请按照示例值填写	固定值mer_authen
risk_type	String	是	1024	用于输入商户风险类型	固定值riskinfo_indirect_mer_authen
pid	String	是	128	合作客户支付宝账号	2088123476549876
business_license_no	String	是	128	用于传递需查询商户的营业执照号码	440306123456776
user_name	String	是	128	法人姓名	张三
external_id	String	是	128	间联外部商户号	6787632221
cert_no	String	否	128	用于传递需查询商户风险的身份证号码	412829111111000000
bank_card_no	String	否	128	用于传递需查询商户的银行卡卡号；	6228480402637874213
mobile_no	String	否	128	用于输入用户注册的手机号码。	13810935692
company_name	String	否	128	公司名称	支付宝中国有限公司
store_name	String	否	128	店铺名称	兰州拉面
store_mcc_desc	String	否	128	店铺MCC中文类目	餐饮
outlet_address	String	否	128	门店地址	浙江省杭州市万塘路18号
extended_info	String	否	128	拓展字段；JSON格式，；可以单独约定额外字段	"extended_info ": { " key": "value"}

4) 公共请求参数

参数	类型	是否必填	最大长度	描述	示例值
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	商户生成签名字符串所使用的签名算法类型，目前支持RSA/RSA2。推荐使用RSA2	RSA2
sign	String	是	256	商户请求参数的签名串，详见（https://docs.open.alipay.com/200/105351）	详见示例
timestamp	String	是	19	发送请求的时间，格式"yyyy-MM-dd HH:mm:ss"	2014-07-24 03:07:50
version	String	是	3	调用的接口版本，固定为：1.0	1.0
notify_url	String	否	256	支付宝服务器主动通知商户服务器里指定的页面http/https路径。	http://api.test.alipay.net/atinterface/receive_notify.htm
app_auth_token	String	否	40	详见应用授权概述（https://docs.open.alipay.com/common/105193）
biz_content	String	是	-	请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

5) 业务返回参数

参数	类型	是否必填	最大长度	描述	示例值
risk_result	String	是	1024	风险分析结果，返回针对商户评级场景的等级值	{"riskinfo_indirect_mer_authen":"rank0"}
risk_result_desc	String	是	1024	风险结果分析返回值rank0,rank1,rank2,rank3

6) 公共返回参数

参数	类型	是否必须	最大长度	描述	示例值
code	String	是	～	网关返回码，详见文档 : https://docs.open.alipay.com/common/105806	40004
msg	String	是	～	网关返回码描述，详见文档 : https://docs.open.alipay.com/common/105806	Business Failed
sub_code	String	否	～	网关明细返回码，详见文档 : https://docs.open.alipay.com/common/105806	isv.invalid-signature
sub_msg	String	否	～	网关明细返回码描述，详见文档 : https://docs.open.alipay.com/common/105806	交易已被支付
sign	String	是	64	签名，详见文档 :hhttps://docs.open.alipay.com/common/105806

7) 代码样例

请求示例

{
"biz_content": {
"service": "mer_authen",
"risk_type": "riskinfo_indirect_mer_authen",
"cert_no": "230106198601127876",
"business_license_no": "39284729387492232",
"bank_card_no": "6214867559610000",
"pid": "20887629272772",
"user_name": "张三",
"company_name": "支付宝有限公司",
"store_name": "兰州拉面",
"store_mcc_desc": "餐饮",
"outlet_address": "浙江省杭州市万塘路18号",
"extended_info": {" external_id": "2343342298"}
}
}

响应示例

{

"alipay_security_risk_customerrisk_query_response": {

"code": "10000",

"msg": "Success",

"risk_result_desc": "{\"rank0\":\"等级0\"}",

"risk_result": "{\" riskinfo_indirect_mer_authen \":\"RANK0\"}"

"sign": "c4TdBOxQIhYk3WEZuXYAcyarxjQoIXoyI2EGoJ8Ss1U/C/BdS4AaFd025NXlewatubYalad9vlRf69T8e6MnfDGlHydh85uXOUZLWLBEs2HMg8LsiVpWyK2vCLqNAIEBOrHYqeC0w+PuLOaB4Qcv7E36dS2aCitRaRDQboP/jD3UTwiUde0/tKdnySV8AO3SYuM+b6mVwEyY1I21rMTomQtXgWV5ASb9Z/F75Pu/YupdRN1JVEP6nRWgHnAXUVARMK7W167N0KvR17On7iejtkzbBaqdqSyk+WDBkWbOOKcOoI8se11ouU+C+5fkHXRz3YAJxEIahn2bYeNC04bX5A=="

}

8) 报错说明

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

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问

开放平台

RiskGo安全合作平台文档