涉外身份实名认证
请求Header:
名称 | 值 | |
---|---|---|
Content-Type | application/x-www-form-urlencoded |
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 | |
realname | 是 | string | 姓名 | |
idcard | 是 | string | 证件号码 | |
nation | 是 | string | 国家/地区名英文缩写,除港澳以外参照ISO3166标准,华侨和港澳人员使用CHN | |
id_type | 是 | string | 证件类型, 说明
414 - 华侨护照 516 - 港澳居民来往内地通行证 553 - 外国人永久居留身份证 511 - 台湾居民来往大陆通行证、台胞证 |
|
mode | 是 | string | 认证模式, 说明
0 - 姓名+证件号 1 - 姓名+证件号+人像 4 - 证件号+姓名+出生日期+性别+有效期至 5 - 证件号+姓名+人像+出生日期+性别+有效期至 |
|
image | 否 | string | 人像图片内容,Base64字符串,5KB-40KB以内 | |
sex | 否 | string | 男:1,女:2 | |
birthDate | 否 | string | 出生日期,格式19910101 | |
expiryDate | 否 | string | 证件有效期至,格式20010101 | |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 状态码 | |
reason | string | 状态提示 | |
result | jsonObject | 返回结果 | |
data | string | 认证结果, 结果说明 第一个字符:文本信息匹配比对结果; 0:文本信息比对一致 7:文本信息比对不一致(不存在该证或该人,或证件与人不符); 第二字符:人像比对结果; 0:同一人 1:比对不是同一人(1、 照片为本人,但是照片可能有角度、光线过暗、脸部区域有亮斑 ) |
JSON返回示例:JSON在线格式化工具 >
{
"reason": "成功",
"result": {
"orderid": "JH55120231130102011iqID",
"data": "7X"
},
"error_code": 0
}
服务级错误码参照(error_code):
错误码 | 说明 | |
---|---|---|
255101 | 参数错误 | |
255103 | 校验失败 | |
255106 | 数据源异常 | |
255107 | 数据源超时 |
系统级错误码参照:
错误码 | 说明 | 旧版本(resultcode) | |
---|---|---|---|
10001 | 错误的请求KEY | 101 | |
10002 | 该KEY无请求权限 | 102 | |
10003 | KEY过期 | 103 | |
10004 | 错误的OPENID | 104 | |
10005 | 应用未审核超时,请提交认证 | 105 | |
10007 | 未知的请求源 | 107 | |
10008 | 被禁止的IP | 108 | |
10009 | 被禁止的KEY | 109 | |
10011 | 当前IP请求超过限制 | 111 | |
10012 | 请求超过次数限制 | 112 | |
10013 | 测试KEY超过请求限制 | 113 | |
10014 | 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) | 114 | |
10020 | 接口维护 | 120 | |
10021 | 接口停用 | 121 |
错误码格式说明(示例:200201):
2 | 002 | 01 | |
---|---|---|---|
服务级错误(1为系统级错误) | 服务模块代码(即数据ID) | 具体错误代码 |