同人判断接口文档

更新时间：2019/06/13 访问次数：4406

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) 参数说明

当前同人识别服务支持身份证号，银行卡号，绑定手机号，姓名，支付宝id，支付宝登入邮箱 6种介质的调用
?必传介质：支付宝账号（手机或邮箱二选一）
其他选填介质：身份证号、姓名、银行卡、支付宝用户ID（需选填一项或者一项以上）
?因为判断口径从严，如果非必要介质，建议填null
口径说明：
1.非同人口径：如所传介质中，有一个和其他介质不同人则返回非同人;RANK1
例：如调用介质：身份证号，手机号，姓名。其中手机号与姓名为同人，而身份证号不与手机号/姓名同人，则返回非同人（rank1）。
2.未识别口径：如所传介质中，有一个介质在支付宝体系内无数据，则返回未识别
例：如调用介质：身份证号，手机号，姓名。其中姓名与手机号同人，但身份证的信息在支付宝体系内无数据，则返回未识别（rank0）。

1、调用参数说明

通过手机号等信息来判断用户账户和支付宝账户是否是同一自然人。

2、返回参数说明

rank0 参数有误或者未识别到

rank1 表示非同人

rank2 表示同人

rank3 表示实名且同人

3) 业务请求参数

参数	类型	是否必填	最大长度	描述	示例值
service	String	是	128	合作伙伴匹配服务类型,请按照示例值填写	account_same
risk_type	String	是	1024	风险咨询类型，请按示例值填写	riskinfo_account_same
mobile_no	String	是	128	用户手机号	13810935692
pid	String	是	128	申请业务合作伙伴ID
user_id	String	否	128	支付宝用户ID
bank_card_no	String	否	128	银行卡号
cert_no	String	否	128	用于输入用户的身份证号码	230109199911110921
email_address	String	否	128	支付宝登录邮箱账号	zhifubao@163.com
user_name	String	是	128	用户姓名	张三

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

是

128

风险分析结果，返回针对用户拒付场景下返回的风险值

"riskinfo_account_same":"rank0"}

risk_result_desc

String

是

1024

风险结果分析返回值

rank0 提供信息不足，提供参数信息有误，或提供的支付宝账号不存在。

rank1 表示非同人

rank2 表示同人

rank3 表示实名且同人

rank1

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": "account_same", 
"risk_type": "riskinfo_account_same", 
"pid": "2088031872450000", 
"mobile_no": "18511897888", 
"user_id": "20889883883838388", 
"user_name": "20889883883838388", 
"bank_card_no": "18988888888", 
"email_address": "null"}}

响应示例

{"alipay_security_risk_customerrisk_query_response":{"code": "10000","msg": "Success","risk_result_desc":"{\"rank1\":\"等级1\"}","risk_result":"{\"riskinfo_account_same\":\"rank1\",\"riskinfo_account_same_infocode\":\"84\"}" },"sign":

"fZj1PJ5rKxaww1g/VnQxFI38CRThsT1utfLZY97GBOkOK6MGNf+X5Os2Gi/A+krr8ogE2FYtdyEKPEF0ieUIA2mR9mceNMjW0VnnbWdbjpC/fWYBIaBFIvvHh72/zyTZSZaeb39y8v5pmTbPXSSEd3nzVFClW4P+VEcioLCrc3ktoEnNADxL1oLDVjdwn5fNMiJUp3ERdOsnKLtmoUWAAwD/0f6rNkAr25WnE5ADqbtGxVM5YF+dNPsNR2aP/uE3z92SalM9GQd/ZzuVH1Tj1zBpWU/UT/Sp3AzaJyqzA7Jw2gs+VpvtBSMIMcndBHaw5Ne4K9cAKzygjuEkNrx4QA==" }

8) 报错说明

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

3. 常见问题

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问

开放平台

RiskGo安全合作平台文档