通用认证平台接口规范

北京圣睦德健康科技有限公司
1、概述
圣睦德网络身份证通用认证平台接口规范主要用于制定标准的接口接入准则及流

程，指导用户开发人员及测试等相关技术人员快速了解网络身份证通用认证平台提供

的数据接口方式和相关规范，并且方便快捷的实现接口对接。

2、接口介绍
2.1、通讯协议

网络身份证通用认证平台对外数据接口主要以HTTP+JSON协议的形式发布。认证

请求以POST方式提交JSON格式的字符串(即：HTTP

BODY的内容为JSON字符串)，JSON字符串需进行URLEncoder编码，数据编码格式为UTF

-8， 并 且 请 在 HTTP

HEADER请求头中添加如下设置，以便服务器端识别出请求数据是JSON格式。

Content-Type: application/JSON; charset=utf-8

2.2、安全协议

接入方对请求报文字符串进行签名，签名规则参考第4章节“数字签名计算说

明”。

2.3、报文格式说明
2.3.1、请求报文格式

请求报文由通用参数和业务参数共同组成，通用参数固定不变（下方表中列出的

参数为固定参数），业务参数由具体的业务决定，请求报文格式如下：

序号 参数名称 定义 必填 说明
1 msgtype 业务类型 是 参考“实名认证接口说明”章节
2 username 用户名 是 认证平台提供
3 password 密码 是 认证平台提供
… …… 业务参数 参考具体接口
… …… 业务参数 参考具体接口
… …… 业务参数 参考具体接口
N signature 数字签名 是 详见：数字签名计算说明
 {

msgtype:"",

username:"",

password:"",

……:"",

signature:""

2.3.2、响应报文格式

序号 参数名称 定义 必填 说明
1 resultflow 认证流水号 是 响应唯一流水号
2 result 响应码 是 详见通用响应码
3 msgtype 业务类型 是 值与请求报文相同
4 msg 响应内容 否 如果出现调用错误等，会有提示信息

result:"",

resultflow:"",

msgtype："",

msg：""

2.3.3、通用响应码（身份核验类）

响应码 说明 备注

1. 姓名和身份证号正确；
1 验证一致 2. 姓名、身份证号和有效期都正确；
3. 姓名、身份证号和人像都正确；

1. 姓名和身份证号不匹配
0 库无
2. 姓名、身份证号和有效期不匹配

-1 验证不一致 姓名、身份证号和有效期正确但人像不匹配
2 失败，照片对比不一致 保留字段。
4 失败，身份证信息不一致 保留字段。
5 失败，证件照不存在 制证中心未采集居民照片
 6 失败，照片质量不佳

1. 身份证号码错误
1001 请求参数格式错误
2. 其他

1002 Username或者password错误 http请求包是明文的情况下返回

1004 签名校验未通过，数据错误。
1005 图片大小不符。 图片不得大于32k
1006 图像格式不支持 非jpg格式
2001 没有可用余额
2002 客户端连接数过多，请降低连接数量
2005 数据查询超时

系统错误，或系统无法识别请求信息 1. 人像比对业务中，上传了非人像照片
9999
。 2. 其他

2.3.4、通用响应码（非身份核验类）

适用于除身份核验类接口外的其他接口

响应码 说明 备注
1 成功
-1 失败
1001 请求参数格式错误
1002 Username或者password错误 http请求包是明文的情况下返回
1004 签名校验未通过，数据错误。
1007 视频大小不符。
2001 没有可用余额
2002 客户端连接数过多，请降低连接数量
2005 数据查询超时
系统错误，或系统无法识别请求信息
9999
。

2.4、SDK

Java开发平台SDK请联系相关人员获取。

C#、PHP和Python的加密和签名算法示例请联系相关人员获取。

3、接口说明
3.1、身份证二要素核验
请求参数

序号 参数名称 定义 必填 说明
 1 msgtype 业务类型 是 固定值0001
2 username 用户名 是 平台提供
3 password 密码 是 平台提供
中文明文
4 name 姓名 是
可加密
5 cardno 身份证号 是 可加密
6 signature 数字签名 是 详见：数字签名计算说明

示例:

{
"username": "xxx",
"msgtype": "0001",
"name": "韦xx",
"cardno": "429004xxxxx619",
"password": "xxxxxx",
"signature":
"869D9704CBCD695B6DB4DD625DCA0D1FFD4BBBEBFD07C9A8B5188E302F7CF7E05326D4F5C
4BB13C56DA0F3F66A4276C05933788045FF970B7334C739BE95A6A2F4019850411A0770674
53AB69A2DE1E6FFF307DDD7A043DA5425A362982483A29F58120C43BE2D7666316DAA95F36
A213C1D122CD85B1A104E26A1FD81D810CF"
}

响应参数

序号 参数名称 定义 必填 说明
1 resultflow 认证流水号 是 响应唯一流水号
2 result 响应码 是 详见通用响应码
3 msgtype 业务类型 是 值与请求报文相同
4 msg 响应内容 否 如果出现调用错误等，会有提示信息

示例:

{
"sign": "",
"resultflow": "0190814155131054512287901",
"result": "1",
"serialnum": "",
"msgtype": "0001",
"msg": "验证一致"
}

3.2、身份证四要素核验
请求参数

序号 参数名称 定义 必填 说明
1 msgtype 业务类型 是 固定值0004
 2 username 用户名 是 平台提供
3 password 密码 是 平台提供
中文明文
4 name 姓名 是
可加密
5 cardno 身份证号 是 可加密
身份证有效期开
6 validdate 是 格式为：YYYYMMDD
始时间
身份证有效期结
7 invaliddate 是 格式为:YYYYMMDD,长期有效则输入00000000。
束时间
8 signature 数字签名 是 详见：数字签名计算说明

示例:

{
"username": "xxx",
"invaliddate": "20340310",
"validdate": "20140310",
"msgtype": "0004",
"name": "韦xx",
"cardno": "429004xxxxx619",
"password": "xxxxxx",
"signature":
"869D9704CBCD695B6DB4DD625DCA0D1FFD4BBBEBFD07C9A8B5188E302F7CF7E05326D4F5C
4BB13C56DA0F3F66A4276C05933788045FF970B7334C739BE95A6A2F4019850411A0770674
53AB69A2DE1E6FFF307DDD7A043DA5425A362982483A29F58120C43BE2D7666316DAA95F36
A213C1D122CD85B1A104E26A1FD81D810CF"
}

响应参数

序号 参数名称 定义 必填 说明
1 resultflow 认证流水号 是 响应唯一流水号
2 result 响应码 是 详见通用响应码
3 msgtype 业务类型 是 值与请求报文相同
4 msg 响应内容 否 如果出现调用错误等，会有提示信息

示例:

{
"sign": "",
"resultflow": "0190814155151054512287901",
"result": "1",
"serialnum": "",
"msgtype": "0004",
"msg": "验证一致"
}

3.3、身份证两要素+人像核验
请求参数

序号 参数名称 定义 必填 说明
1 msgtype 业务类型 是 固定值1007
2 username 用户名 是 认证平台提供
3 password 密码 是 认证平台提供
中文明文
4 name 姓名 是
可加密
5 cardno 身份证号 是 可加密
6 imagevalue 图片信息 是 被核验人头像图片信息，Base64加密
7 signature 数字签名 是 详见：数字签名计算说明

响应参数

序号 参数名称 定义 必填 说明
1 resultflow 认证流水号 是 响应唯一流水号
2 result 响应码 是 详见通用响应码
3 msgtype 业务类型 是 值与请求报文相同
4 msg 响应内容 否 如果出现调用错误等，会有提示信息
5 similar 照片相似度 是 0-100之间，小数点后保留一位；-1，无相似度，
6 threshold1 千分之一阈值 否 保留字段
7 Threshold2 万分之一阈值 否 保留字段

3.4、身份证四要素+人像核验
请求参数

序号 参数名称 定义 必填 说明
1 msgtype 业务类型 是 固定值1008
2 username 用户名 是 认证平台提供
3 password 密码 是 认证平台提供
中文明文
4 name 姓名 是
可加密
5 cardno 身份证号 是 可加密
6 imagevalue 图片信息 是 被核验人头像图片信息，Base64加密
身份证有效期开
7 validdate 是 格式为：YYYYMMDD
始时间
身份证有效期结
8 invaliddate 是 格式为:YYYYMMDD,长期有效则输入00000000。
束时间
9 signature 数字签名 是 详见：数字签名计算说明

响应参数

序号 参数名称 定义 必填 说明
1 resultflow 认证流水号 是 响应唯一流水号
2 result 响应码 是 详见通用响应码
3 msgtype 业务类型 是 值与请求报文相同
4 msg 响应内容 否 如果出现调用错误等，会有提示信息
5 similar 照片相似度 是 0-100之间，小数点后保留一位；-1，无相似度，
6 threshold1 千分之一阈值 否 保留字段
7 Threshold2 万分之一阈值 否 保留字段

3.5、不良信息
注意：请不要用在逃人员信息做测试！！！

请求参数

序号 参数名称 定义 必填 说明
1 msgtype 业务类型 是 固定值6001
2 username 用户名 是 认证平台提供
3 password 密码 是 认证平台提供
中文明文
4 name 姓名 是
可加密
5 cardno 身份证号 是 可加密
6 signature 数字签名 是 详见：数字签名计算说明

响应参数

序号 参数名称 定义 必填 说明
1 resultflow 认证流水号 是 响应唯一流水号
2 result 响应码 是 详见通用响应码
3 msgtype 业务类型 是 值与请求报文相同
4 msg 响应内容 是 如果出现调用错误等，会有提示信息

msg字段字典

序号 返回码 说明
1 res 是否命中库（1：命中；2：未命中）
2 code 命中状态码。如果命中多项，则用逗号隔开
如果有前科时间，会返回，表示前科记录距今
3 time
时间。单位：年，如：11.4年

命中状态码

状态码 说明
1 在逃或历史在逃人员
2 吸毒人员
5 违法前科
8 经济前科
12 精神病肇事
13 法院文书
14 其他

3.6、手机号三要素核验(暂不区分运营商)
请求参数
 序号 参数名称 定义 必填 说明
1 msgtype 业务类型 是 固定值0002
2 username 用户名 是 认证平台提供
3 password 密码 是 认证平台提供
中文明文
4 name 姓名 是
可加密
5 cardno 身份证号 是 可加密
11位手机号
6 mobile 手机号 是
可加密
不参与签名计算
7 operator 运营商类型 是
(移动：mobile，联通：unicom，电信：telecom)
8 signature 数字签名 是 详见：数字签名计算说明

示例:

{
"username": "xxx",
"msgtype": "0002",
"name": "李x",
"cardno": "1305*******125****",
"password": "xxxxxxxxx",
"operator": "mobile",
"signature":
"1F2215F4575E0E5CE762FFECCC8F5192EFE53E1258D548F8C9B63EE24A24957C18B21387C
B1571E30D0E5DCEACC1043EA9396748BCBCE7798AF5F224F46202C0DFF0BA413059DB84AFF
CDD83B98E74F6A92F0ED02A3E6E18640AD1BC959BCA34B6BC27ECD9AB16366712CF8A10ED9
7CEBAC62844E237155080E94BE0112AD288",
"mobile": "187xxxx3009"
}

响应参数

序号 参数名称 定义 必填 说明
1 resultflow 认证流水号 是 响应唯一流水号
2 result 响应码 是 详见通用响应码
3 msg 响应内容 是 JSON结构
4 --value 查询结果 是

value取值

返回码 描述
-1 无记录
0 全一致
1 身份证一致，姓名不一致；(预留，暂不返回)
2 身份证不一致，姓名一致；(预留，暂不返回)
3 全不一致；(预留，暂不返回)
4 不一致（具体不一致的字段未知）
 示例:

{
"result": "1",
"msg": {
"value": "4"
},
"sign": "",
"resultflow": "2019121919502505681270275",
"serialnum": "",
"msgtype": "0002"
}

3.7、银行卡三要素核验
请求参数

序号 参数名称 定义 必填 说明
1 msgtype 业务类型 是 固定值0003
2 username 用户名 是 认证平台提供
3 password 密码 是 认证平台提供
中文明文
4 name 姓名 是
可加密
5 cardno 身份证号 是 可加密
银行卡号
6 bankcard 银行卡 是
可加密
7 signature 数字签名 是 详见：数字签名计算说明

响应参数

序号 参数名称 定义 必填 说明
1 resultflow 认证流水号 是 响应唯一流水号
2 result 响应码 是 详见通用响应码
3 msg 响应内容 是 JSON结构
4 --value 查询结果 是

value取值

返回码 描述
-1 无记录；(预留，暂不返回)
1 全匹配
2 部分匹配；（不匹配的字段会拼在结果状态码后面）(预留，暂不返回)
3 无匹配
4 不匹配（具体不匹配的字段未知）
5 已注销(预留，暂不返回)
6 该银行卡暂不支持查询或未开通无卡支付功能
7 当日查询次数超限
8 卡状态异常或卡号错误
3.8、银行卡四要素核验
请求参数

序号 参数名称 定义 必填 说明
1 msgtype 业务类型 是 固定值1003
2 username 用户名 是 认证平台提供
3 password 密码 是 认证平台提供
中文明文
4 name 姓名 是
可加密
5 cardno 身份证号 是 可加密
银行卡号
6 bankcard 银行卡 是
可加密
11位手机号
7 mobile 预留手机号 是
可加密
8 signature 数字签名 是 详见：数字签名计算说明

响应参数

序号 参数名称 定义 必填 说明
1 resultflow 认证流水号 是 响应唯一流水号
2 result 响应码 是 详见通用响应码
3 msg 响应内容 是 JSON结构
4 --value 查询结果 是

value取值

返回码 描述
-1 无记录；(预留，暂不返回)
1 全匹配
2 部分匹配；（不匹配的字段会拼在结果状态码后面）(预留，暂不返回)
3 无匹配
4 不匹配（具体不匹配的字段未知）
5 已注销(预留，暂不返回)
6 该银行卡暂不支持查询或未开通无卡支付功能
7 当日查询次数超限
8 卡状态异常或卡号错误

3.9、银行卡五要素核验
请求参数

序号 参数名称 定义 必填 说明
1 msgtype 业务类型 是 固定值3003
2 username 用户名 是 平台提供
3 password 密码 是 平台提供
中文明文
4 name 姓名 是
可加密
 5 cardno 身份证号 是 可加密
银行卡号
6 bankcard 银行卡 是
可加密
11位手机号
7 mobile 预留手机号 是
可加密
8 transcode 核验类型 是 0023：卡号 0050：卡号+户名+证件号+手机号
9 signature 数字签名 是 详见：数字签名计算说明

响应参数

序号 参数名称 定义 必填 说明
1 resultflow 认证流水号 是 响应唯一流水号
2 result 响应码 是 详见通用响应码
3 msgtype 业务类型 是 值与请求报文相同
4 msg 响应内容 是 JSON结构
5 --value 查询结果 是

value取值

返回码 描述
-1 无记录；(预留，暂不返回)
1 一类卡
2 四要素不一致（仅核验类型为0050时会返回）
3 非一类卡
4 不确定是否为一类户
5 已注销(预留，暂不返回)
6 该银行卡暂不支持查询或未开通无卡支付功能(预留，暂不返回)
7 当日查询次数超限
8 卡状态异常或卡号错误

3.10、企业四要素核验
请求参数

序号 参数名称 定义 必填 说明
1 msgtype 业务类型 是 固定值5001
2 username 用户名 是 平台提供
3 password 密码 是 平台提供
中文明文
4 name 企业法人姓名 是
可加密
企业法人身份证
5 cardno 是 可加密
号
企业名称与注册号二选其一，可传空
6 entName 企业名称 是
可加密
企业工商注册号/ 企业名称与注册号二选其一，可传空
7 regNo 是
统一信用代码 可加密
8 signature 数字签名 是 详见：数字签名计算说明
 示例:

{
"username": "xxx",
"msgtype": "5001",
"name": "吴**",
"entName": "**生态汽车公司",
"cardno": "152*********015",
"regNo": "913************15L",
"password": "xxxxxxxxxxxxxxxxxxxxxx",
"signature":
"377147FFB6ACDFE2F1FC9459399BD9FE3EEA96C8A97C180EC9BD9B506E4F21C13630456CF
8EC691D71A5590634C5CE4828E6FA2388DBAD7DD04A7268F98203A02B70D25CA347EBA9688
73464D9703D19117B3CF0C497E368AA20CC66C5105BA2C395D24F5BE406C04137CAAC652BE
60E9482DA40AA9ADC80B3491A21AAF0873A"
}

响应参数

序号 参数名称 定义 必填 说明
1 resultflow 认证流水号 是 响应唯一流水号
2 result 响应码 是 详见通用响应码
3 msgtype 业务类型 是 值与请求报文相同
4 msg 响应内容 是 如果出现调用错误等，会有提示信息
5 realnameMatch 姓名是否匹配 否 1.匹配 0.不匹配 -1 未验证
身份证号码是否
6 idNoMatch 否 1.匹配 0.不匹配 -1 未验证
匹配
企业名称是否匹
7 entNameMatch 否 1.匹配 0.不匹配 -1 未验证
配
工商注册号是否
8 regNoMatch 否 1.匹配 0.不匹配 -1 未验证
匹配
9 sign 签名 否 预留字段

示例:

{
"result": "1",
"entNameMatch": "1",
"regNoMatch": "1",
"msg": "成功",
"sign": "",
"resultflow": "0000201912261634200554934",
"idNoMatch": "0",
"realnameMatch": "1",
"serialnum": "",
"msgtype": "5001"
}

3.11、企业详情查询
请求参数

序号 参数名称 定义 必填 说明
1 msgtype 业务类型 是 固定值8020
2 username 用户名 是 平台提供
3 password 密码 是 平台提供
4 entName 企业名称 是
5 regNo 企业注册号 是 可传空字符
6 entType 企业类型 是 0-全部；1-企业；2-个体
7 signature 数字签名 是 详见：数字签名计算说明

响应参数

序号 参数名称 定义 必填 说明
1 resultflow 认证流水号 是 响应唯一流水号
2 result 响应码 是 详见通用响应码
3 msgtype 业务类型 是 值与请求报文相同
4 msg 响应内容 否 如果出现调用错误等，会有提示信息
5 sign 签名 否 预留

msg字段字典

名称 类型 描述
BASIC Object 企业基本信息
BASIC.ABUITEM String 许可经营项目
BASIC.APPRDATE String 核准日期
BASIC.CANDATE String 注销日期
BASIC.CREDITCODE String 统一信用代码
BASIC.DOM String 住址
BASIC.DOMDISTRICT String 住所所在行政区划
BASIC.EMAIL String 邮箱
BASIC.ENTNAME String 企业名称
BASIC.ENTNAMEENG String 企业英文名称
BASIC.ENTNAME_OLD String 曾用名
BASIC.ENTSTATUS String 经营状态
BASIC.ENTTYPE String 企业类型
BASIC.ENTTYPECODE String 企业(机构)类型编码
BASIC.ESDATE String 成立日期
BASIC.FRNAME String 法定代表人/负责人/执行事务合伙人
BASIC.ID String 企业ID
BASIC.INDUSTRYCOCODE String 国民经济行业代码
BASIC.INDUSTRYCONAME String 国民经济代码名称
BASIC.OPFROM String 经营期限自
BASIC.OPTO String 经营期限至
BASIC.ORGCODES String 组织机构代码
BASIC.ORIREGNO String 原注册号
BASIC.RECCAP String 实收资本(万元)
BASIC.REGCAP String 注册资本（企业:万元,个体:元）
BASIC.REGCAPCUR String 注册资本币种
BASIC.REGNO String 注册号
BASIC.REGORG String 登记机关
BASIC.REGORGCITY String 所在城市
BASIC.REGORGCODE String 注册地址行政编号
BASIC.REGORGDISTRICT String 所在区/县
BASIC.REGORGPROVINCE String 所在省份
BASIC.REVDATE String 吊销日期
BASIC.ZSOPSCOPE String 经营业务范围
BASIC.LOGOIMGNAME String 企业LOGO图片
BASIC.QRCODE_IMAGE_BASE64 String 企业二维码
ALTER Object[] 变更信息
ALTER[].ALTAF String 变更后内容
ALTER[].ALTBE String 变更前内容
ALTER[].ALTDATE String 变更日期
ALTER[].ALTITEM String 变更事项
BREAKLAW Object[] 严重违法
BREAKLAW[].INDATE String 列入日期
BREAKLAW[].INREASON String 列入原因
BREAKLAW[].INREGORG String 列入作出决定机关
BREAKLAW[].INSN String 列入作出决定文号
BREAKLAW[].OUTDATE String 移出日期
BREAKLAW[].OUTREASON String 移出原因
BREAKLAW[].OUTREGORG String 移出作出决定机关
BREAKLAW[].OUTSN String 移出作出决定文号
DEALIN Object[] 企业年检情况
DEALIN[].ANCHEYEAR String 年检年度
DEALIN[].ASSGRO String 资产总额
DEALIN[].BUSST String 运营状况
DEALIN[].CURRENCY String 币种
DEALIN[].DEFICIT String 亏损额
DEALIN[].LIAGRO String 负债总额
DEALIN[].LTERMINV String 长期投资
DEALIN[].LTERMLIAAM String 长期负债
DEALIN[].NETINC String 净利润
DEALIN[].PROGRO String 利润总额
DEALIN[].RATGRO String 纳税总额
DEALIN[].SERVINC String 服务营业收入
DEALIN[].VENDINC String 销售（营业）收入
ENTCASEBASEINFO Object[] 行政处罚基本信息
ENTCASEBASEINFO[].ILLEGACTTYPE String 违法行为类型
ENTCASEBASEINFO[].PENAUTH String 决定机关
ENTCASEBASEINFO[].PENAUTH_CN String 决定机关名称
ENTCASEBASEINFO[].PENCONTENT String 行政处罚内容
ENTCASEBASEINFO[].PENDECISSDATE String 处罚决定日期
ENTCASEBASEINFO[].PENDECNO String 决定文书号
ENTCASEBASEINFO[].PUBLICDATE String 公示日期
ENTINV Object[] 企业对外投资信息
ENTINV[].BINVVAMOUNT String 企业总数量
ENTINV[].CANDATE String 注销日期
ENTINV[].CONFORM String 出资方式
ENTINV[].CONGROCUR String 认缴出资币种
ENTINV[].CREDITCODE String 统一社会信用代码
ENTINV[].ENTJGNAME String 企业机构名称
ENTINV[].ENTSTATUS String 企业状态
ENTINV[].ENTTYPE String 企业（机构）类型
ENTINV[].ESDATE String 开业日期
ENTINV[].FUNDEDRATIO String 投资比例
ENTINV[].NAME String 法定代表人姓名
ENTINV[].REGCAP String 注册资本（企业:万元,个体:元）
ENTINV[].REGCAPCUR String 注册资本币种
ENTINV[].REGNO String 注册号
ENTINV[].REGORG String 登记机关
ENTINV[].REGORGCODE String 注册地址行政区编号
ENTINV[].REVDATE String 吊销日期
ENTINV[].SUBCONAM String 认缴出资额（万元）
EXCEPTIONLIST Object[] 企业异常名录
EXCEPTIONLIST[].ENTNAME String 企业名称
EXCEPTIONLIST[].INDATE String 列入日期
EXCEPTIONLIST[].INREASON String 列入原因
EXCEPTIONLIST[].OUTDATE String 移出日期
EXCEPTIONLIST[].OUTREASON String 退出异常名录原因
EXCEPTIONLIST[].REGNO String 注册号
EXCEPTIONLIST[].SHXYDM String 统一社会信用代码
EXCEPTIONLIST[].YC_REGORG String 移出机关名称
EXCEPTIONLIST[].YR_REGORG String 列入机关名称
FILIATION Object[] 分支机构
FILIATION[].BRNAME String 分支机构名称
FILIATION[].BRN_CREDIT_CODE String 分支机构统一社会信用代码
FILIATION[].BRN_REG_ORG String 分支机构登记机关
FILIATION[].BRREGNO String 分支机构企业注册号
FRINV Object[] 企业法定代表人对外投资信息
FRINV[].CANDATE String 注销日期
FRINV[].CONFORM String 出资方式
FRINV[].CREDITCODE String 统一社会信用代码
FRINV[].CURRENCY String 认缴出资币种
FRINV[].ENTNAME String 企业(机构)名称
FRINV[].ENTSTATUS String 企业状态
FRINV[].ENTTYPE String 企业（机构）类型
FRINV[].ESDATE String 开业日期
FRINV[].FUNDEDRATIO String 出资比例
FRINV[].NAME String 法定代表人姓名
FRINV[].PINVAMOUNT String 企业总数量
FRINV[].REGCAP String 注册资本（企业:万元,个体:元）
FRINV[].REGCAPCUR String 注册资本币种
FRINV[].REGNO String 注册号
FRINV[].REGORG String 登记机关
FRINV[].REGORGCODE String 注册地址行政区编号
FRINV[].REVDATE String 吊销日期
FRINV[].SUBCONAM String 认缴出资额（万元）
FRPOSITION Object[] 法定代表人其他公司任职
FRPOSITION[].CANDATE String 注销日期
FRPOSITION[].ENTNAME String 企业机构名称
FRPOSITION[].ENTSTATUS String 企业状态
FRPOSITION[].ENTTYPE String 企业（机构）类型
FRPOSITION[].ESDATE String 成立日期
FRPOSITION[].LEREPSIGN String 是否法定代表人
FRPOSITION[].NAME String 法定代表人姓名
FRPOSITION[].POSITION String 职务
FRPOSITION[].PPVAMOUNT String 企业总数量
FRPOSITION[].REGCAP String 注册资本（企业:万元,个体:元）
FRPOSITION[].REGCAPCUR String 注册资本币种
FRPOSITION[].REGNO String 注册号
FRPOSITION[].REGORG String 登记机关
FRPOSITION[].REGORGCODE String 注册地址行政区编号
FRPOSITION[].REVDATE String 吊销日期
INSPECT Object[] 抽查检查
INSPECT[].ISP_DATE String 抽查日期
INSPECT[].ISP_NOTICE String 公告名称
INSPECT[].ISP_NOTICEDA String 公告日期
INSPECT[].ISP_REGORG String 检查核实机关名称
INSPECT[].ISP_REGORGCODE String 检查核实机关代码
INSPECT[].ISP_RESULT String 抽查结果
INSPECT[].ISP_TYPE String 数据类型
LIQUIDATION Object[] 清算信息
LIQUIDATION[].ADDR String 地址
LIQUIDATION[].CLAIMTRANEE String 债权承接人
LIQUIDATION[].DEBTTRANEE String 债务承接人
LIQUIDATION[].LIGENDDATE String 清算完结日期
LIQUIDATION[].LIGPRINCIPAL String 清算负责人
LIQUIDATION[].LIGST String 清算完结情况
UIDATION[].LIQMEN String 清算组成员
MORTGAGEALT Object[] 动产抵押-变更信息
MORTGAGEALT[].MAB_ALT_DATE String 变更日期
MORTGAGEALT[].MAB_ALT_DETAILS String 变更内容
MORTGAGEALT[].MAB_REGNO String 登记编号
MORTGAGEBASIC Object[] 动产抵押-基本信息
MORTGAGEALT[].MAB_GS_DATE String 公示日期
MORTGAGEALT[].MAB_GUAR_AMT String 被担保债权数额
MORTGAGEALT[].MAB_REGNO String 登记编号
MORTGAGEALT[].MAB_REG_DATE String 登记日期
MORTGAGEALT[].MAB_REG_ORG String 登记机关
MORTGAGEALT[].MAB_STATUS String 状态
MORTGAGECAN Object[] 动产抵押-注销信息
MORTGAGECAN[].MAB_CAN_DATE String 注销日期
MORTGAGECAN[].MAB_CAN_RES String 注销原因
MORTGAGECAN[].MAB_REGNO String 登记编号
MORTGAGEDEBT Object[] 动产抵押-被担保主债权信息
MORTGAGEDEBT[].DEBT_EDATE String 履行债务结束日期
MORTGAGEDEBT[].DEBT_SDATE String 履行债务开始日期
MORTGAGEDEBT[].MAB_DEBT_AMT String 数额
MORTGAGEDEBT[].MAB_DEBT_RANGE String 担保范围
MORTGAGEDEBT[].MAB_DEBT_RMK String 备注
MORTGAGEDEBT[].MAB_DEBT_TYPE String 种类
MORTGAGEDEBT[].MAB_REGNO String 登记编号
MORTGAGEPAWN Object[] 动产抵押-抵押物信息
MORTGAGEPAWN[].MAB_PAWN_DETAILS String 数量、质量、状况、所在地等情况
MORTGAGEPAWN[].MAB_PAWN_NAME String 名称
MORTGAGEPAWN[].MAB_PAWN_OWNER String 所有权或使用权归属
MORTGAGEPAWN[].MAB_PAWN_RMK String 备注
MORTGAGEPAWN[].MAB_REGNO String 登记编号
MORTGAGEPER Object[] 动产抵押-抵押权人信息
MORTGAGEPER[].MAB_PER_CERNO String 抵押权人证照/证件号码
MORTGAGEPER[].MAB_PER_CERTYPE String 抵押权人证照/证件类型
MORTGAGEPER[].MAB_PER_DOM String 所在地
MORTGAGEPER[].MAB_PER_NAME String 抵押权人名称
MORTGAGEPER[].MAB_REGNO String 登记编号
MORTGAGEREG Object[] 动产抵押-登记信息
MORTGAGEREG[].DEBT_EDATE String 履行债务结束日期
MORTGAGEREG[].DEBT_SDATE String 履行债务开始日期
MORTGAGEREG[].MAB_GUAR_AMT String 被担保债权数额
MORTGAGEREG[].MAB_GUAR_RANGE String 担保范围
MORTGAGEREG[].MAB_GUAR_TYPE String 被担保债券种类
MORTGAGEREG[].MAB_REGNO String 登记编号
MORTGAGEREG[].MAB_REG_DATE String 登记日期
MORTGAGEREG[].MAB_REG_ORG String 登记机关
MORTGAGEREG[].NODENUM String 省份代码
MORTGAGEREG[].STATUS String 状态
PERSON Object[] 主要管理人员
PERSON[].ENTNAME String 企业名称
PERSON[].PERNAME String 人员姓名
PERSON[].PERSONAMOUNT String 人员总数量
PERSON[].POSITION String 职位
QUICKCANCELBASIC Object 简易注销-基本信息
QUICKCANCELBASIC.CANCELRESULT String 简易注销结果
QUICKCANCELBASIC.CANCELRESULTDATE String 核准日期
QUICKCANCELBASIC.CREDITCODE String 统一社会信用代码
QUICKCANCELBASIC.ENTNAME String 企业名称
QUICKCANCELBASIC.NOTICE_FROMDATE String 公告开始日期
QUICKCANCELBASIC.NOTICE_TODATE String 公告截止日期
QUICKCANCELBASIC.REGNO String 注册号
QUICKCANCELBASIC.REGORG String 登记机关
QUICKCANCELBASIC.REGORGCODE String 登记机关代码
QUICKCANCELDISSENT String 简易注销-异议信息
QUICKCANCELDISSENT.DISSENT_DATE String 异议时间
QUICKCANCELDISSENT.DISSENT_DES String 异议内容
QUICKCANCELDISSENT.DISSENT_ORG String 异议申请人
SHAREHOLDER Object[] 股东及出资信息
SHAREHOLDER[].ACCONAM String 实缴出资额(万元)
SHAREHOLDER[].CONDATE String 出资日期
SHAREHOLDER[].CONFORM String 出资方式
SHAREHOLDER[].COUNTRY String 国别
SHAREHOLDER[].CREDITCODE String 股东统一社会信用代码
SHAREHOLDER[].FUNDEDRATIO String 出资比例
SHAREHOLDER[].INVTYPE String 股东类型
SHAREHOLDER[].REGCAPCUR String 认缴出资币种
SHAREHOLDER[].REGNO String 股东注册号
SHAREHOLDER[].SHANAME String 股东名称
SHAREHOLDER[].SUBCONAM String 认缴出资额（万元）
SHARESFROST Object[] 股权冻结信息
SHARESFROST[].FROAM String 冻结金额（万元）
SHARESFROST[].FROAUTH String 冻结机关
SHARESFROST[].FRODOCNO String 冻结文号
SHARESFROST[].FROFROM String 冻结起始日期
SHARESFROST[].FROTO String 冻结截至日期
SHARESFROST[].THAWAUTH String 解冻机关
SHARESFROST[].THAWCOMMENT String 解冻说明
SHARESFROST[].THAWDATE String 解冻日期
SHARESFROST[].THAWDOCNO String 解冻文号
STOCKPAWN Object[] 股权出质信息（新）
STOCKPAWN[].STK_PAWN_CZAMT String 出质股权数额
STOCKPAWN[].STK_PAWN_CZCERNO String 出质人证件/证件号
STOCKPAWN[].STK_PAWN_CZPER String 出质人
STOCKPAWN[].STK_PAWN_DATE String 公示日期
STOCKPAWN[].STK_PAWN_REGDATE String 质权出质设立登记日期
STOCKPAWN[].STK_PAWN_REGNO String 登记编号
STOCKPAWN[].STK_PAWN_STATUS String 状态
STOCKPAWN[].STK_PAWN_ZQCERNO String 质权人证件/证件号
STOCKPAWN[].STK_PAWN_ZQPER String 质权人姓名
STOCKPAWN[].URL String 关联内容
STOCKPAWNALT Object[] 股权出质信息（新）-变更信息
STOCKPAWNALT[].STK_PAWN_BGNR String 变更内容
STOCKPAWNALT[].STK_PAWN_BGRQ String 变更日期
STOCKPAWNALT[].URL String 关联内容
STOCKPAWNREV Object[] 股权出质信息（新）-注销信息
STOCKPAWNREV[].STK_PAWN_DATE String 注销日期
STOCKPAWNREV[].STK_PAWN_RES String 注销原因
STOCKPAWNREV[].URL String 关联内容
YEARREPORTALTER Object[] 年报-修改信息
YEARREPORTALTER[].ANCHEID String 年报ID
YEARREPORTALTER[].ALITEM String 修改事项
YEARREPORTALTER[].ALTAF String 修改后
YEARREPORTALTER[].ALTBE String 修改前
YEARREPORTALTER[].ALTDATE String 修改日期
YEARREPORTALTERSTOCK Object[] 年报-股权变更信息
YEARREPORTALTERSTOCK[].ALTDATE String 股权变更日期
YEARREPORTALTERSTOCK[].ANCHEID String 年报ID
YEARREPORTALTERSTOCK[].INV String 股东名称
YEARREPORTALTERSTOCK[].TRANSAMAFT String 转让后股权比例
YEARREPORTALTERSTOCK[].TRANSAMPR String 转让前股权比例
YEARREPORTBASIC Object[] 年报-企业年报基本信息
YEARREPORTBASIC[].ADDR String 地址
YEARREPORTBASIC[].ANCHEDATE String 年报日期
YEARREPORTBASIC[].ANCHEID String 年报ID
YEARREPORTBASIC[].ANCHEYEAR String 年报年份
YEARREPORTBASIC[].BUSST String 经营状态
YEARREPORTBASIC[].CREDITNO String 统一信用代码
YEARREPORTBASIC[].EMAIL String 电子邮箱
YEARREPORTBASIC[].ENTNAME String 企业名称
YEARREPORTBASIC[].POSTALCODE String 邮政编码
YEARREPORTBASIC[].REGNO String 注册号
YEARREPORTBASIC[].TEL String 电话
YEARREPORTFORGUARANTEE Object[] 年报-企业对外提供保证担保信息
YEARREPORTFORGUARANTEE[].ANCHEID String 年报ID
YEARREPORTFORGUARANTEE[].GATYPE String 保证的方式
YEARREPORTFORGUARANTEE[].GUARAPPERIOD String 保证的期间
YEARREPORTFORGUARANTEE[].MORE String 债权人
YEARREPORTFORGUARANTEE[].MORTGAGOR String 债务人
YEARREPORTFORGUARANTEE[].PEFPERFORM String 履行债务的期限自
YEARREPORTFORGUARANTEE[].PEFPERTO String 履行债务的期限至
YEARREPORTFORGUARANTEE[].PRICLASECAM String 主债权数额
YEARREPORTFORGUARANTEE[].PRICLASECKIND String 主债权种类
YEARREPORTFORINV Object[] 年报-企业对外投资信息
YEARREPORTFORINV[].ANCHEID String 年报ID
YEARREPORTFORINV[].CREDITNO String 统一信用代码
YEARREPORTFORINV[].ENTNAME String 企业名称
YEARREPORTFORINV[].REGNO String 注册号
YEARREPORTPAIDUPCAPITAL Object[] 年报-企业实缴出资信息
YEARREPORTPAIDUPCAPITAL[].ANCHEID String 年报ID
YEARREPORTPAIDUPCAPITAL[].CONDATE String 实缴出资日期
YEARREPORTPAIDUPCAPITAL[].CONFORM String 出资方式
YEARREPORTPAIDUPCAPITAL[].CURRENCY String 币种
YEARREPORTPAIDUPCAPITAL[].INV String 股东/发起人
YEARREPORTPAIDUPCAPITAL[].LIACCONAM String 累计实缴额（万元）
YEARREPORTSOCSEC Object[] 年报-社会保险信息
YEARREPORTSOCSEC[].ANCHEID String 年报ID
YEARREPORTSOCSEC[].SO110 String 城镇职工基本养老保险参保人数
YEARREPORTSOCSEC[].SO210 String 失业保险参保人数
YEARREPORTSOCSEC[].SO310 String 职工基本医疗保险参保人数
YEARREPORTSOCSEC[].SO410 String 工伤保险参保人数
YEARREPORTSOCSEC[].SO510 String 生育保险参保人数
参加城镇职工基本养老保险本期实际缴费金
YEARREPORTSOCSEC[].TOTALPAYMENT_SO110 String
额
YEARREPORTSOCSEC[].TOTALPAYMENT_SO210 String 参加失业保险本期实际缴费金额
YEARREPORTSOCSEC[].TOTALPAYMENT_SO310 String 参加职工基本医疗保险本期实际缴费金额
YEARREPORTSOCSEC[].TOTALPAYMENT_SO410 String 参加工伤保险本期实际缴费金额
YEARREPORTSOCSEC[].TOTALPAYMENT_SO510 String 参加生育保险本期实际缴费金额
YEARREPORTSOCSEC[].TOTALWAGES_SO110 String 单位参加城镇职工基本养老保险缴费基
YEARREPORTSOCSEC[].TOTALWAGES_SO210 String 单位参加失业保险缴费基数
YEARREPORTSOCSEC[].TOTALWAGES_SO310 String 单位参加职工基本医疗保险缴费基数
YEARREPORTSOCSEC[].TOTALWAGES_SO410 String 单位参加工伤保险缴费基数
YEARREPORTSOCSEC[].TOTALWAGES_SO510 String 单位参加生育保险缴费基数
单位参加城镇职工基本养老保险累计欠缴金
YEARREPORTSOCSEC[].UNPAIDSOCIALINS_SO110 String
额
YEARREPORTSOCSEC[].UNPAIDSOCIALINS_SO210 String 单位参加失业保险累计欠缴金额
YEARREPORTSOCSEC[].UNPAIDSOCIALINS_SO310 String 单位参加职工基本医疗保险累计欠缴金额
YEARREPORTSOCSEC[].UNPAIDSOCIALINS_SO410 String 参加工伤保险累计欠缴金额
YEARREPORTSOCSEC[].UNPAIDSOCIALINS_SO510 String 单位参加生育保险累计欠缴金额
YEARREPORTSUBCAPITAL Object[] 年报-认缴出资信息
YEARREPORTSUBCAPITAL[].ANCHEID String 年报ID
YEARREPORTSUBCAPITAL[].CONDATE String 认缴出资日期
YEARREPORTSUBCAPITAL[].CONFORM String 出资方式
YEARREPORTSUBCAPITAL[].CURRENCY String 出资币种
YEARREPORTSUBCAPITAL[].INV String 投资人/发起人
YEARREPORTSUBCAPITAL[].LISUBCONAM String 累计认缴额
YEARREPORTWEBSITEINFO Object[] 年报-网站信息
YEARREPORTWEBSITEINFO[].ANCHEID String 年报ID
YEARREPORTWEBSITEINFO[].DOMAIN String 网站（网店）地址
YEARREPORTWEBSITEINFO[].WEBSITNAME String 网站（网店）名称
YEARREPORTWEBSITEINFO[].WEBTYPE String 网站（网店）类型
JUDICIALAID Object[] 司法协助基本信息
JUDICIALAID[].PARENT_ID String 被执行人ID
JUDICIALAID[].MODIFYID String 股权变更ID
JUDICIALAID[].INAME String 被执行人
JUDICIALAID[].SHAREAM String 股权数额
JUDICIALAID[].COURTNAME String 执行法院
JUDICIALAID[].COURTNO String 协助公示通知书文号
JUDICIALAID[].STATUS String 股权冻结状态
JUDICIALAID[].CUR String 币种
JUDICIALAIDDETAIL Object[] 司法协助详情
JUDICIALAIDDETAIL[].PARENT_ID String 被执行人ID
JUDICIALAIDDETAIL[].EXECUTION String 执行事项
JUDICIALAIDDETAIL[].COURTNAME String 执行法院
JUDICIALAIDDETAIL[].JUDGMENT_NO String 执行裁定书文号
JUDICIALAIDDETAIL[].EX_NOTICE_NO String 协助执行通知书文号
JUDICIALAIDDETAIL[].INAME_TYPE String 被执行人类型
JUDICIALAIDDETAIL[].INAME String 被执行人
JUDICIALAIDDETAIL[].ID_TYPE String 证件类型
JUDICIALAIDDETAIL[].LICENCE_TYPE String 证照类型
JUDICIALAIDDETAIL[].LICENCE_NO String 证照编号
JUDICIALAIDDETAIL[].MARKET_NAME String 被冻结股权所在市场主体名称
JUDICIALAIDDETAIL[].REGIST_NO String 被冻结股权所在市场主体注册号
JUDICIALAIDDETAIL[].MARKET_CREDIT_CODE String 被冻结股权所在市场统一社会信用代码
JUDICIALAIDDETAIL[].SHAREAM String 股权数额
JUDICIALAIDDETAIL[].SHAREAM_UNIT String 股权数额单位
JUDICIALAIDDETAIL[].CUR String 币种
JUDICIALAIDDETAIL[].FPERIOD String 冻结期限
JUDICIALAIDDETAIL[].FROFROM String 冻结期限自
JUDICIALAIDDETAIL[].FROTO String 冻结期限至
JUDICIALAIDDETAIL[].CFROFROM String 续行冻结期限自
JUDICIALAIDDETAIL[].CFROTO String 续行冻结期限至
JUDICIALAIDDETAIL[].CFPERIOD String 续行冻结期限
JUDICIALAIDDETAIL[].PUBLICDATE String 公示日期
JUDICIALAIDDETAIL[].FREEZE_FLAG String 股权冻结状态
JUDICIALAIDDETAIL[].FREEZE_DATE String 解冻日期
JUDICIALAIDDETAIL[].EXPIRATION_DATE String 失效日期
JUDICIALAIDDETAIL[].EXPIRATION_REASON String 失效原因
JUDICIALAIDALTER Object[] 司法协助变更信息
JUDICIALAIDALTER[].MODIFYID String 股权变更ID
JUDICIALAIDALTER[].COURTNAME String 执行法院
JUDICIALAIDALTER[].EXECUTION String 执行事项
JUDICIALAIDALTER[].JUDGMENT_NO String 执行裁定书文号
JUDICIALAIDALTER[].EX_NOTICE_NO String 协助执行通知书文号
JUDICIALAIDALTER[].INAME String 被执行人
JUDICIALAIDALTER[].INAME_TYPE String 被执行人类型
JUDICIALAIDALTER[].INAME_ITYPE String 被执行人证件类型
JUDICIALAIDALTER[].INAME_LTYPE String 被执行人证照类型
JUDICIALAIDALTER[].INAME_LICENCE String 被执行人证照号码
JUDICIALAIDALTER[].SHAREAM String 股权数额
JUDICIALAIDALTER[].CUR String 币种
JUDICIALAIDALTER[].ASSIGNEE String 受让人
JUDICIALAIDALTER[].ASSIGNEE_TYPE String 受让人类型
JUDICIALAIDALTER[].ASSIGNEE_ITYPE String 受让人证件类型
JUDICIALAIDALTER[].ASSIGNEE_LTYPE String 受让人证照类型
JUDICIALAIDALTER[].ASSIGNEE_LICENCE String 受让人证照号码
JUDICIALAIDALTER[].AEDATE String 协助执行日期

3.12、静默活体检测
请求参数

序号 参数名称 定义 必填 说明
1 msgtype 业务类型 是 固定值0506
2 username 用户名 是 认证平台提供
3 password 密码 是 认证平台提供
不参与签名计算
视频的base64编码（去除编码头）,视频大小建议
4 video 视频 是
在3M以内，超过8M将返回异常，视频长度建议在3
-5s以内，建议格式为mp4
5 signature 数字签名 是 详见：数字签名计算说明

响应参数

序号 参数名称 定义 必填 说明
1 resultflow 认证流水号 是 响应唯一流水号
2 result 响应码 是 详见通用响应码
3 msgtype 业务类型 是 值与请求报文相同
4 msg 响应内容 否 如果出现调用错误等，会有提示信息

msg字段字典

名称 类型 描述
face_img String 人像图片Base64编码
错 误 信 息 提 示
hack： 假 造 人 脸
short_time：视频时长不足2s
errormsg String
no_face_detected：视频中未检测到人脸
loss_tracking：人脸中途出框
face_changed：视频中途人脸被替换

3.13、照片比对
请求参数

序号 参数名称 定义 必填 说明
1 msgtype 业务类型 是 固定值3001
2 username 用户名 是 平台提供
3 password 密码 是 平台提供
databaseImageCo 不参与签名计算
4 登记照片 是
ntent BASE64格式，1M以内
queryImageConte 不参与签名计算
5 比对照片 是
nt BASE64格式，1M以内
6 signature 数字签名 是 详见：数字签名计算说明
响应参数

序号 参数名称 定义 必填 说明
1 resultflow 认证流水号 是 响应唯一流水号
2 result 响应码 是 详见通用响应码
3 msgtype 业务类型 是 值与请求报文相同
4 msg 响应内容 否 如果出现调用错误等，会有提示信息
5 similar 照片相似度 是 0-100之间，小数点后保留一位，分数越高越相似

3.14、OCR识别
请求参数

序号 参数名称 定义 必填 说明
1 msgtype 业务类型 是 固定值0008
2 username 用户名 是 平台提供
3 password 密码 是 平台提供
databaseImageCo 不参与签名计算
4 待识别图片 是
ntent BASE64格式，1M以内
不参与签名计算
idc：
5 enginetype 证件类型 是
身份证；bank-new：银行卡；
blic-new：营业执照
6 signature 数字签名 是 详见：数字签名计算说明

示例:

{
"username": "xxx",
"msgtype": "0008",
"databaseImageContent":
"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAFA3PEY8MlBGQUZaVVBfeMiCeG5uQEF2gLCptQQhs
ADQCCpsDSpsA2AICgA/9k=",
"enginetype": "idc",
"password": "xxxxxxxxx",
"signature":
"623BA0AD7108642D83979CB54EF530B770B6C518E5914842A1A81FDA9450557BF2797F5AB
977E4C384FE158EB650A405F27382888C9A72425C6D30A8625F20BF11AE8A5D2C50C5F9AE9
2350E45428F739AB4BDA3B372DB90039B4C1975BF6DFA7435641BD91141FE626E2D22DE645
587D53C08C34A4989BDB98F135787FD3B70"
}

响应参数

序号 参数名称 定义 必填 说明
1 resultflow 认证流水号 是 响应唯一流水号
2 result 响应码 是 详见通用响应码
3 msgtype 业务类型 是 值与请求报文相同
4 msg 响应内容 否 如果出现调用错误等，会有提示信息
msg字段字典（身份证）

序号 返回码 说明
1 NAME 姓名
2 SEX 性别
3 FOLK 民族
4 BIRTHDAY 出生日期
5 ADDRESS 地址
6 NUM 号码
7 ISSUE 签发机关
8 PERIOD 有效期限
9 typeId 引擎类型；[身份证正面(17)， 身份证背面(20)]
10 IMG_QUALITY 图片质量指数
11 QUALITY_PARSE 质量指数解析（json格式）
12 QC_INFOCUS 图片对焦清晰（0失败，1成功）

13 QC_FITSIZE 图片大小（0失败，1成功）

QC_RIGHTRESUL
14 图片识别结果正确（0失败，1成功）
T
15 QC_ISRGB 图片是彩色（0失败，1成功）

图片质量指数解析（身份证）

返回码 值 说明
IMG_QUAL 为以下四个值
例输出值为60：（4 + 8 + 16 +32 = 60） 则这张图像符合质量评估值
ITY 的和
QC_INFOC
US 16 图片对焦清晰（图像清晰值大于300 ）

QC_FITSI
4 图片大小（640 * 480）
ZE
QC_RIGHT
42 图片识别结果正确
RESULT
QC_ISRGB 8 图片是彩色

msg字段字典（银行卡）

序号 返回码 说明
1 card_number 银行卡号
2 bank_name 发卡行名称
bank_identifi
3 发卡行标识代码
cation_number
4 card_name 卡片名称
卡片类型
5 card_type
（注：支持借记卡、贷记卡、准贷记卡及预付费卡类型的识别）

msg字段字典（营业执照）
序号 返回码 说明
1 code 统一社会信用代码
2 name 名称
3 type 类型
4 addr 住所
5 pers 负责人／法定代表人
6 scope 业务范围
7 time 有效期
8 regi 资金
9 organizer 主管单位
10 date 成立日期
11 comp 颁发机关
12 num 登记号
13 form 组成形式
14 funding 经费来源
15 date_issue 发证日期

4、数字签名计算说明
使用SHA1WithRSA算法计算signature，密钥模长1024。请求接口参数列表中除si

gnature参数外的其他所有参数（特殊说明的除外）参与计算signature，对于可选参

数，如果不存在则不参与计算。请求参数列表中参与计算的参数值按照规范中定义的

序号顺序，依次连接，组成计算signature的源数据。

注意：只有各个参数值参与计算，各参数名称不参与计算，且中间没有任何分隔

符、空格等连接符。

4.1、数字签名计算举例

以手机号三要素核验接口为例，请求参数如下：

序号 参数名称 取值
1 msgtype 0002
2 username 企业甲
3 password 123456
4 name 张三
5 cardno 123456123456
6 mobile 13788888888

计算过程如下：
 第一步，签名源数据：0002企业甲123456张三12345612345613788888888。

第二步，签名源数据转UTF-8编码，（30303032E4BC81E4B89AE794B231323334353

6E5BCA0E4B8893132333435363132333435363133373838383838383838这是UTF8编码的

十六进制字符，实际操作中无需转成十六进制编码）。

第三步，假设私钥为A，计算的signatrue十六进制字符为5682CA278471B23CE55F

51F8A822CED400DC4E83B11818DA2E870262D3F86E04E336262307CC36957DA5B78E8944AD

C425E9468BB77064C15EEA697F6A2CB07CC6B7992C4EDF564E5E114E3C62AFE0C6CECAA4D7

ABCAD1A5BD46D9747A135560CE3BDB9C1A1658C009FEE212939238A89CD7A0FCC9222DDEAE

E51433375B9EFA。

JSON格式请求报文如下：

"msgtype": "0003" ,

"username":"企业甲" ,

"password":"123456" ,

"name": "张三" ,

"cardno": "123456123456" ,

"mobile":"13788888888" ,

"signinfo":

"5682CA278471B23CE55F51F8A822CED400DC4E83B11818DA2E870262D3F86E04E33626230

7CC36957DA5B78E8944ADC425E9468BB77064C15EEA697F6A2CB07CC6B7992C4EDF564E5E1

14E3C62AFE0C6CECAA4D7ABCAD1A5BD46D9747A135560CE3BDB9C1A1658C009FEE21293923

8A89CD7A0FCC9222DDEAEE51433375B9EFA"

}
5、密文的实现方式
5.1、密文的实现流程
5.1.1、生成明文报文

根据本接口文档生成明文报文(已生成数字签名)。

5.1.2、修改明文报文生成加密报文，步骤如下:

第一步，msgtype加前缀DE，如:0001—>DE0001

第二步，对name字段进行UTF-8编码；再用对称密钥password，通过3DES-ECB加

密算法对其进行加密；并对加密后的name进行base64编码。

第三步，对cardno进行UTF-8编码；再用对称密钥password，通过3DES-ECB加密

算法对cardno进行加密；并对加密后的cardno进行base64编码。

第四步，用修改后的msgtype、name、cardno替换原报文中的msgtype、name、ca

rdno。

第五步，删除password节点，生成加密报文。

5.2、安全算法
5.2.1、加密算法

3DES-ECB

5.2.2、填充规则

如果明文的数据长度不足8字节的整数倍，以PKCS5Padding的填充规则进行补位

6、人像核验相关参数说明
6.1、照片及人脸姿势规范
6.2、错误接受率和阈值比对分数
错误接受率 阈值比对分数
1% 50
0.1% 60
0.01% 70
0.001% 80
0.0001% 90

平台采用错误接受率万分之一，阈值比对分数70这一档，客户可以根据场景自己

定义多少分算通过。

7、附录
7.1、证件类型代码
代码 说明
IDC 身份证
PASSPORT 护照
HK_AND_MO 港澳证
TAIWAN 台胞证
OFFICER 军官证
POLICE 警官证
SOLDIER 士兵证
DRIVER 驾驶证
STU 学生证
ORG 组织机构代码
HOMETOWN 回乡证

7.2、交易场景字典
编码 说明
01 直销银行
02 消费金融
03 银行二三类账户开户
04 征信
05 保险
06 基金
07 证券
08 租赁
09 海关申报
99 其他

7.3、号牌种类表
编码 说明
01 大型汽车
02 小型汽车
03 使馆汽车
04 领馆汽车
05 境外汽车
06 外籍汽车
07 普通摩托车
08 轻便摩托车
09 使馆摩托车
10 领馆摩托车
11 境外摩托车
12 外籍摩托车
13 低速车
14 拖拉机
15 挂车
16 教练汽车
17 教练摩托车
20 临时入境汽车
21 临时入境摩托车
22 临时行驶车
23 警用汽车
24 警用摩托
51 大型新能源车辆
52 小型新能源车辆

7.4、车辆类型表
编码 说明
B11 重型普通半挂车
B12 重型厢式半挂车
B13 重型罐式半挂车
B14 重型平板半挂车
B15 重型集装箱半挂车
B16 重型自卸半挂车
B17 重型特殊结构半挂车
B18 重型仓栅式半挂车
B19 重型旅居半挂车
B1A 重型专项作业半挂车
B1B 重型低平板半挂车
B1C 重型车辆运输半挂车
B1D 重型罐式自卸半挂车
B1E 重型平板自卸半挂车
B1F 重型集装箱自卸半挂车
B1G 重型特殊结构自卸半挂车
B1H 重型仓栅式自卸半挂车
B1J 重型专项作业自卸半挂车
B1K 重型低平板自卸半挂车
B1U 重型中置轴旅居挂车
B1V 重型中置轴车辆运输车
B1W 重型中置轴普通挂车
B21 中型普通半挂车
B22 中型厢式半挂车
B23 中型罐式半挂车
B24 中型平板半挂车
B25 中型集装箱半挂车
B26 中型自卸半挂车
B27 中型特殊结构半挂车
B28 中型仓栅式半挂车
B29 中型旅居半挂车
B2A 中型专项作业半挂车
B2B 中型低平板半挂车
B2C 中型车辆运输半挂车
B2D 中型罐式自卸半挂车
B2E 中型平板自卸半挂车
B2F 中型集装箱自卸半挂车
B2G 中型特殊结构自卸半挂车
B2H 中型仓栅式自卸半挂车
B2J 中型专项作业自卸半挂车
B2K 中型低平板自卸半挂车
B2U 中型中置轴旅居挂车
B2V 中型中置轴车辆运输车
B2W 中型中置轴普通挂车
B31 轻型普通半挂车
B32 轻型厢式半挂车
B33 轻型罐式半挂车
B34 轻型平板半挂车
B35 轻型自卸半挂车
B36 轻型仓栅式半挂车
B37 轻型旅居半挂车
B38 轻型专项作业半挂车
B39 轻型低平板半挂车
B3C 轻型车辆运输半挂车
B3D 轻型罐式自卸半挂车
B3E 轻型平板自卸半挂车
B3F 轻型集装箱自卸半挂车
B3G 轻型特殊结构自卸半挂车
B3H 轻型仓栅式自卸半挂车
B3J 轻型专项作业自卸半挂车
B3K 轻型低平板自卸半挂车
B3U 轻型中置轴旅居挂车
B3V 轻型中置轴车辆运输车
B3W 轻型中置轴普通挂车
D11 无轨电车
D12 有轨电车
G11 重型普通全挂车
G12 重型厢式全挂车
G13 重型罐式全挂车
G14 重型平板全挂车
G15 重型集装箱全挂车
G16 重型自卸全挂车
G17 重型仓栅式全挂车
G18 重型旅居全挂车
G19 重型专项作业全挂车
G1A 重型厢式自卸全挂车
G1B 重型罐式自卸全挂车
G1C 重型平板自卸全挂车
G1D 重型集装箱自卸全挂车
G1E 重型仓栅式自卸全挂车
G1F 重型专项作业自卸全挂车
G21 中型普通全挂车
G22 中型厢式全挂车
G23 中型罐式全挂车
G24 中型平板全挂车
G25 中型集装箱全挂车
G26 中型自卸全挂车
G27 中型仓栅式全挂车
G28 中型旅居全挂车
G29 中型专项作业全挂车
G2A 中型厢式自卸全挂车
G2B 中型罐式自卸全挂车
G2C 中型平板自卸全挂车
G2D 中型集装箱自卸全挂车
G2E 中型仓栅式自卸全挂车
G2F 中型专项作业自卸全挂车
G31 轻型普通全挂车
G32 轻型厢式全挂车
G33 轻型罐式全挂车
G34 轻型平板全挂车
G35 轻型自卸全挂车
G36 轻型仓栅式全挂车
G37 轻型旅居全挂车
G38 轻型专项作业全挂车
G3A 轻型厢式自卸全挂车
G3B 轻型罐式自卸全挂车
G3C 轻型平板自卸全挂车
G3D 轻型集装箱自卸全挂车
G3E 轻型仓栅式自卸全挂车
G3F 轻型专项作业自卸全挂车
H11 重型普通货车
H12 重型厢式货车
H13 重型封闭货车
H14 重型罐式货车
H15 重型平板货车
H16 重型集装厢车
H17 重型自卸货车
H18 重型特殊结构货车
H19 重型仓栅式货车
H1A 重型车辆运输车
H1B 重型厢式自卸货车
H1C 重型罐式自卸货车
H1D 重型平板自卸货车
H1E 重型集装厢自卸货车
H1F 重型特殊结构自卸货车
H1G 重型仓栅式自卸货车
H21 中型普通货车
H22 中型厢式货车
H23 中型封闭货车
H24 中型罐式货车
H25 中型平板货车
H26 中型集装厢车
H27 中型自卸货车
H28 中型特殊结构货车
H29 中型仓栅式货车
H2A 中型车辆运输车
H2B 中型厢式自卸货车
H2C 中型罐式自卸货车
H2D 中型平板自卸货车
H2E 中型集装厢自卸货车
H2F 中型特殊结构自卸货车
H2G 中型仓栅式自卸货车
H31 轻型普通货车
H32 轻型厢式货车
H33 轻型封闭货车
H34 轻型罐式货车
H35 轻型平板货车
H37 轻型自卸货车
H38 轻型特殊结构货车
H39 轻型仓栅式货车
H3A 轻型车辆运输车
H3B 轻型厢式自卸货车
H3C 轻型罐式自卸货车
H3D 轻型平板自卸货车
H3F 轻型特殊结构自卸货车
H3G 轻型仓栅式自卸货车
H41 微型普通货车
H42 微型厢式货车
H43 微型封闭货车
H44 微型罐式货车
H45 微型自卸货车
H46 微型特殊结构货车
H47 微型仓栅式货车
H4A 微型车辆运输车
H4B 微型厢式自卸货车
H4C 微型罐式自卸货车
H4F 微型特殊结构自卸货车
H4G 微型仓栅式自卸货车
H51 普通低速货车
H52 厢式低速货车
H53 罐式低速货车
H54 自卸低速货车
H55 仓栅式低速货车
H5B 厢式自卸低速货车
H5C 罐式自卸低速货车
J11 轮式装载机械
J12 轮式挖掘机械
J13 轮式平地机械
K10 大型客车
K11 大型普通客车
K12 大型双层客车
K13 大型卧铺客车
K14 大型铰接客车
K15 大型越野客车
K16 大型轿车
K17 大型专用客车
K18 大型专用校车
K20 中型客车
K21 中型普通客车
K22 中型双层客车
K23 中型卧铺客车
K24 中型铰接客车
K25 中型越野客车
K26 中型轿车
K27 中型专用客车
K28 中型专用校车
K30 小型客车
K31 小型普通客车
K32 小型越野客车
K33 小型轿车
K34 小型专用客车
K38 小型专用校车
K39 小型面包车
K40 微型客车
K41 微型普通客车
K42 微型越野客车
K43 微型轿车
K49 微型面包车
M11 普通正三轮摩托车
M12 轻便正三轮摩托车
M13 正三轮载客摩托车
M14 正三轮载货摩托车
M15 侧三轮摩托车
M21 普通二轮摩托车
M22 轻便二轮摩托车
N11 三轮汽车
Q11 重型半挂牵引车
Q12 重型全挂牵引车
Q21 中型半挂牵引车
Q22 中型全挂牵引车
Q31 轻型半挂牵引车
Q32 轻型全挂牵引车
T11 大型轮式拖拉机
T21 小型轮式拖拉机
T22 手扶拖拉机
T23 手扶变形运输机
X99 其它
Z11 大型非载货专项作业车
Z12 大型载货专项作业车
Z21 中型非载货专项作业车
Z22 中型载货专项作业车
Z31 小型非载货专项作业车
Z32 小型载货专项作业车
Z41 微型专项作业车
Z42 微型载货专项作业车
Z51 重型专项作业车
Z52 重型载货专项作业车
Z71 轻型专项作业车
Z72 轻型载货专项作业车
Z 其他
X100 商用车
X200 乘用车及客车

7.5、车身颜色表
编码 说明
A 白
B 灰
C 黄
D 粉
E 红
F 紫
G 绿
H 蓝
I 棕
J 黑

7.6、使用性质表
编码 说明
A 非营运
B 公路客运
C 公交客运
D 出租客运
E 旅游客运
F 货运
G 租赁
H 警用
I 消防
J 救护
K 工程救险
L 营转非
M 出租转非
N 教练
O 幼儿校车
P 小学生校车
Q 初中生校车
R 危化品运输
S 中小学生校车

7.7、机动车状态表
编码 说明
A 正常
B 转出
C 被盗抢
D 停驶
E 注销
G 违法未处理
H 海关监管
I 事故未处理
J 嫌疑车
K 查封
L 暂扣
M 强制注销
N 事故逃逸
O 锁定
Q 逾期未检验

7.8、燃料种类表
编码 说明
A 汽油
B 柴油
C 电
D 混合油
E 天然气
F 液化石油气
L 甲醇
M 乙醇
N 太阳能
O 混合动力
P 氢
Q 生物燃料
Y 无
Z 其他

7.9、车辆状态表
编码 说明
A 正常
B 超分
C 转出
D 暂扣
E 撤销
F 吊销
G 注销
H 违法未处理
U 扣留
I 事故未处理
J 停止使用
K 协查
L 锁定
M 逾期未换证
N 延期换证
P 延期体检
R 逾期未体检
Z 其他
S 逾期未审验