认证(身份证-手机实名-银行卡四要素)接口规范

一、简介

此文档为认证接口，提供接口出来供使用方调用。接口能力说明：为商户提供认证服务，认证功能包括（公安部）身份证验证、手机实名验证、银行卡四要素验证。

加解密及签名：

生成随机密钥，将随机密钥使用RSA公钥加密

将交易接口中的数据组装成json，要求值为字符串

使用随机密钥对上一步生成的json字符串进行AES加密

使用RSA私钥对json字符串进行签名

二、身份证验证

请求参数：

参数	备注	是否必填	说明
cert_no	合法身份证号	Y
name	姓名	Y
partner_id	平台号	Y
v	版本	Y	统一1.1
method	接口方法	Y	yumei.auth.idcard
timestamp	时间戳	Y
format	参数类型	Y	JSON
sign_method	加密	Y	rsa

三、手机实名验证

请求参数：

参数	备注	是否必填	说明
cert_no	合法身份证号	Y
mobile	合法手机号	Y
partner_id	平台号	Y
v	版本	Y	统一1.1
method	接口方法	Y	yumei.auth.mobile
timestamp	时间戳	Y
format	参数类型	Y	JSON
sign_method	加密	Y	rsa

四、银行卡四要素验证：

请求参数

参数	备注	是否必填	说明
cert_no	合法身份证号	Y
mobile	合法手机号	Y
card_no	银行卡号	Y
name	姓名	Y
partner_id	平台号	Y
v	版本	Y	统一1.1
method	接口方法	Y	yumei.auth.bankcard
timestamp	时间戳	Y
format	参数类型	Y	JSON
sign_method	加密	Y	rsa

统一返回结果：

参数	备注	说明
success	接口是否调用成功	true/false
result_code	系统级结果码	详见服务系统级结果码
result_code_msg	结果详情
sign	签名

五、结果码

返回码	含义
0000	交易成功
T202	没有权限访问
0030	格式错
T427	账号不能为空
0012	无效交易
T434	接口维护中
0096	系统异常
T450	手机号码不能为空
0098	交易超时
T453	姓名不能为空
00A0	校验失败
T455	身份证不能为空
00A1	商户身份验证失败
T458	身份证格式不对
00A2	无效签到
T471	认证接口调用超限
T472	地址不能为空
T489	暂不支持的手机号