1 适用范围
如今随着互联网产业的多元化发展,尤其是互联网金融,O2O,移动支付,共享经济等新兴商业形式的兴起,企业对实名认证业务的数据形式和数据质量有了更高的需求。
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银行卡实名认证接口
接口流程介绍
接口地址:http:// p.139buy.net.cn:99/gway/httpRealNameCheck.action
返回格式:JSON
请求方式:GET/POST
接口作用:对外提供给用户,进行实名校验。需要IP绑定,只能在绑定的IP上访问接口。
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.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 | 响应信息,描述错误信息,可为空,仅供参考! |
2.2三元素实名认证:
3.2.1输入参数
请求示例:URL?code=账号&pass=密码&goodsNo=业务编号&name=姓名&idCard=身份证& cardNum=银行卡号
参数名 | 参数类型 | 描述 | 处理要求 |
code | string | 实名验证业务账号 | 必填 |
pass | string | 账号密码 | 必填 |
goodsNo | string | 业务编号 | 必填 |
name | string | 持卡人姓名 | (UTP-8格式)必填 |
idCard | string | 持卡人18位身份证号码 | 必填 |
cardNum | 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 | 响应信息,描述错误信息,可为空,仅供参考! |
3.3四元素实名认证:
3.3.1输入参数
请求示例:URL?code=账号&pass=密码&goodsNo=业务编号&name=姓名&idCard=身份证&cardNum=银行卡号& phoneNum=手机号码
参数名 | 参数类型 | 描述 | 处理要求 |
code | string | 实名验证业务账号 | 必填 |
pass | string | 账号密码 | 必填 |
goodsNo | string | 业务编号 | 必填 |
name | string | 持卡人姓名 | (UTP-8格式)必填 |
idCard | string | 持卡人18位身份证号码 | 必填 |
cardNum | string | 持卡人银行卡号 | 必填 |
phoneNum | string | 银行预留手机号 | 必填 |
3.3.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银行卡实名查询数量接口:
4.1输入参数
请求示例:http:// p.139buy.net/gway/queryBusinessCount.action?code=账号&pass=密码&goodsNo=业务编号
参数名 | 参数类型 | 描述 | 处理要求 |
code | string | 实名验证业务账号 | 必填 |
pass | string | 账号密码 | 必填 |
goodsNo | string | 业务编号 | 必填 |
4.2输出结果
返回结果报文json:
[{"count":"123","resp_code":"10000"}]
count:数量
resp_code:状态码
参数名 | 参数类型 | 描述 |
resp_code | string | “10000”成功,其他失败原因描述请参阅“返回结果” |
count | string | 账号查询数量 |
5 返回结果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 | 查询成功 | 查询到银行大数据返回银行具体错误描述! |
有需要申请免费试用接口参数可以添加 qq:1537925185 获取免费试用秘钥信息