1 适用范围
如今随着互联网产业的多元化发展,尤其是互联网金融,O2O,移动支付,共享经济等新兴商业形式的兴起,企业对实名认证业务的数据形式和数据质量有了更高的需求。
2身份证实名认证接口
接口地址:http://www.139buy.net.cn/card.aspx
返回格式:JSON
请求方式:GET/POST
接口作用:对外提供给用户,进行实名校验。需要IP绑定,只能在绑定的IP上访问接口。
2.1身份证实名认证:
2.1.1输入参数
请求示例:URL?code=账号&pass=密码&goodsNo=业务编号& cardNum=银行卡号&name=姓名&phoneNum=预留手机号
|
参数名 |
参数类型 |
描述 |
处理要求 |
|
code |
string |
实名验证业务账号 |
必填 |
|
pass |
string |
账号密码 |
必填 |
|
goodsNo |
string |
业务编号 |
必填 |
|
cardNum |
string |
持卡人银行卡号 |
必填 |
|
name |
string |
持卡人姓名 |
(姓名UTP-8格式) 二者必填一项 |
|
phoneNum |
String |
银行预留手机号 |
2.1.1输出结果
返回结果报文json:
[{"orderNumber":"1601051531229446176","resp_code":"10000","resp_msg":"一致" }]
orderNumber:交易编号
resp_code:状态码“10000”成功
resp_msg:响应信息,描述错误信息
|
参数名 |
参数类型 |
描述 |
|
resp_code |
string |
“10000”认证成功,其他失败原因描述请参阅“返回结果” |
|
orderNumber |
string |
交易编号,查询完成后提供作为交易标识 |
|
resp_msg |
string |
响应信息,描述错误信息,可为空,仅供参考! |
3.1身份证实名认证(返照):
3.1.1输入参数
请求示例:URL?code=账号&pass=密码&goodsNo=业务编号& cardNum=银行卡号&name=姓名&phoneNum=预留手机号
|
参数名 |
参数类型 |
描述 |
处理要求 |
|
code |
string |
实名验证业务账号 |
必填 |
|
pass |
string |
账号密码 |
必填 |
|
goodsNo |
string |
业务编号 |
必填 |
|
cardNum |
string |
持卡人银行卡号 |
必填 |
|
name |
string |
持卡人姓名 |
(姓名UTP-8格式) 二者必填一项 |
|
phoneNum |
String |
银行预留手机号 |
3.2.1输出结果
返回结果报文json:
[{"orderNumber":"1601051531229446176","resp_code":"10000","resp_msg":"一致" }]
orderNumber:交易编号
resp_code:状态码“10000”成功
resp_msg:响应信息,描述错误信息
|
参数名 |
参数类型 |
描述 |
|
resp_code |
string |
“10000”认证成功,其他失败原因描述请参阅“返回结果” |
|
orderNumber |
string |
交易编号,查询完成后提供作为交易标识 |
|
resp_msg |
string |
响应信息,描述错误信息,可为空,仅供参考! |
4 返回结果resp_code
|
代码 |
状态 |
意义 |
|
10000 |
成功 |
认证成功 |
|
1000001 |
失败 |
认证失败 |
|
C1 |
失败 |
账号不正确 |
|
C2 |
失败 |
账号密码不对 |
|
C3 |
失败 |
未开通实名验证 |
|
C4 |
失败 |
实名验证可用次数不足 |
|
C5 |
失败 |
实名验证查询时间范围不满足一周内 |
|
C6 |
失败 |
实名验证ip校验不通过 |
|
C7 |
失败 |
查询完成 |
|
C8 |
失败 |
查询日期条件不充足 |
|
C9 |
失败 |
查询结果为空 |
|
C10 |
失败 |
查询异常 |
|
C11 |
失败 |
用户被禁用 |
|
C12 |
失败 |
实名认证业务禁用 |
|
C13 |
失败 |
实名认证业务不存在 |
|
C14 |
失败 |
手机号码交易失败 |
|
C15 |
失败 |
实名认证姓名不能为空 |
|
C16 |
失败 |
实名认证银行卡号不能为空 |
|
C17 |
失败 |
实名认证身份证不能为空 |
|
C18 |
失败 |
没有触发查询接口 |
|
C20 |
失败 |
手机号码和姓名同时为空或有误 |
|
03 |
验证异常 |
报文解析异常 请求银行超时 请求银行异常 解析银行返回报文失败 发送银行加密异常 其他错误 |
|
ZZ |
查询成功 |
查询到银行大数据返回 银行具体错误描述! |