API更新日志

更新时间：2025/01/24

[新增] 【人脸照片核验比对】响应参数新增：confidence - 库照比对综合分数，取值［0，100］。

更新时间：2025/01/02

[新增] 【获取个人核身认证地址】请求参数新增：maxFrequencyLimit - 规定当前流程可使用的认证次数最大上限、failRedirectUrl - 认证失败后页面跳转地址。

更新时间：2024/12/06

[新增] 【获取个人核身认证地址】认证方式新增 PSN_AUDIO_VIDEO_ESIGN - 智能视频认证、audioVideoTemplateId（智能视频认证模板ID）、audioVideoActiveField（智能视频认证文案中的动态朗读内容）。

更新时间：2024/11/07

[新增] 【组织机构3要素信息比对】、【企业3要素信息比对】、【企业4要素信息比对】三个接口新增相应参数：信息不一致的errCode（子错误码）和errMsg（子错误信息详情）

[新增] 功能新增：快捷刷脸新增支持：港澳台居民居住证、外国人永久居留身份证

更新时间：2024/10/11

[新增] 【【人脸识别认证】个人核身】接口新增智能视频认证（PSN_AUDIO_VIDEO_ESIGN）刷脸方式。

更新时间：2024/09/11

[新增] 移动端SDK对接方式：详见 【移动端SDK对接说明】。

更新时间：2024/08/16

[新增] 【查询认证信息】接口新增响应参数：agentFlowId（企业实名认证中，经办人个人的认证流程ID）。

更新时间：2024/06/06

[新增] 【【人脸识别认证】个人核身】接口新增抖音小程序刷脸对接方式：【抖音小程序对接刷脸API流程】

更新时间：2024/04/25

[新增] 【【银行卡认证】银行卡4要素核身】、【【人脸识别认证】个人核身】新增 certType（个人证件类型）字段，并新增对应港澳台居民等证件类型。

【个人银行卡4要素信息比对（国际版）】新增 港澳台居民居住证类型 枚举。

【获取个人核身认证地址】、【获取组织机构核身认证地址】新增 港澳台居民居住证 和 外国人永久居留身份证证件类型。

更新时间：2024/04/12

[新增] 【【手机号认证】运营商3要素核身】与【【银行卡认证】银行卡4要素核身】接口新增请求参数：source（指定信息比对来源）、响应参数：behavior（本次核身认证流程行为数据）。

更新时间：2023/12/22

[变更]优化：【【人脸识别认证】个人核身】接口：ZHIMACREDIT - 支付宝刷脸认证 链接有效期从30分钟调整为23小时，ESIGN - 快捷刷脸认证 链接有效期从10分钟调整到60分钟。

更新时间：2023/11/29

[新增] 【查询认证信息】接口新增响应参数：faceVideoUrl（刷脸认证时刷脸视频）、faceType（腾讯云刷脸时的刷脸模式）、idCardFrontPicUrl（微信小程序刷脸认证时上传的身份证正面照片）、idCardBackPicUrl（微信小程序刷脸认证时上传的身份证反面照片）。

更新时间：2023/04/13

[变更]更名：所有涉及e签宝刷脸的认证方式全部变更为快捷刷脸

• 2023/04/13-e签宝刷脸服务升级通知

更新时间：2023/03/31

[新增] 【查询打款银行信息】接口新增入参：cnapsCode（联行号），并将原有参数：keyWord（银行名称）改为非必填。

更新时间：2022/08/03

[新增] 【发起企业核身认证4要素校验】接口新增入参：agentFlowId（经办人个人认证流程Id）

更新时间：2022/07/25

[新增] 【驾驶证OCR】响应参数新增：issueDate（初次领证日期）字段。

更新时间：2022/07/19

[变更]【获取组织机构实名认证地址】接口去掉：organizationType（组织机构类型：1 - 企业类；2 - 个体工商户；99 - 其他组织）字段，新版机构实名页面不支持指定机构类型，是自动适配的（老版本是支持指定的）。

更新时间：2022/05/20

[新增] 新增企业工商信息查询接口【工商信息查询】。

更新时间：2022/05/05

[新增] 【查询认证信息】接口新增agentAuthType字段。

更新时间：2022/03/01

[新增] 移动端SDK产品说明由组文件改为组内新建文件方式【移动端SDK】，【Android集成说明】新增功能方法说明模块（包含页面自定义颜色等功能），【iOS集成流程】新增e签宝刷脸页自定义颜色。

更新时间：2022/01/13

[变更]为了接口错误码规范化管理，【个人银行卡4要素信息比对（详情版）】接口返回错误码code和msg的文案变更，请开发者依据最新的错误码进行逻辑判断，详情请见：【个人银行卡4要素信息比对（详情版）-错误码】

更新时间：2022/01/13

[变更]【获取组织机构实名认证地址】接口和【获取组织机构核身认证地址】接口，请求参数organizationType组织机构类型为“其他组织”时，入参值由 3 变更为 99。

更新时间：2022/01/06

[新增]【人脸照片核验比对】新增该接口，支持用户上传人脸照片base64编码与个人姓名、证件号来核验是否为本人。

更新时间：2021/12/20

[新增] 【获取组织机构核身认证地址】接口中 availableAuthTypes（指定页面显示组织机构认证方式）字段新增【LEGAL_REP_AUTH】法定代表人认证方式。

更新时间：2021/12/15

[新增] 【获取组织机构实名认证地址】接口中 availableAuthTypes（指定页面显示组织机构认证方式）字段新增【LEGAL_REP_AUTH】法定代表人认证方式。

更新时间：2021/12/09

[新增] 【获取组织机构实名认证地址】接口和【获取组织机构核身认证地址】接口：

（1）新增agentAvailableAuthTypes（指定页面显示办理人认证方式）字段；

（2）authType（指定组织机构默认认证类型）字段新增：【LEGAL_REP_AUTH】法定代表人认证方式。

更新时间：2021/11/23

[变更]

模拟环境中自 2021年11月23日的14:20时起，正式环境中自 2021年11月25日的20:00时起

使用【创建个人签署账号】接口和【创建机构签署账号】接口创建账号时：

（1）同一个AppId下，同一个idNumber证件号最多只允许被创建100个账号accountId或orgId，即一个证件号只可以被100个thirdPartyUserId创建账号。

（2）如果超过100个，再调用【创建个人签署账号】或【创建机构签署账号】接口时将返回报错信息：“该证件号创建用户数已达最大数量100个，不允许再继续创建”。

如果遇到 “该证件号创建用户数已达最大数量100个，不允许再继续创建” 的报错时：

（1）请贵司研发人员查询贵司库中所保留的最新一个账号ID，如此账号ID正确无误，可直接用于发起签署使用。

（2）如果已存在账号ID信息不正确，可以通过【修改个人签署账号】或【修改机构签署账号】接口进行更新。

（3）如果还想再新创建账号，可以先通过【注销个人签章账号】或【注销机构签署账号】接口注销后再创建。

更新时间：2021/10/27

应国家要求，个人信息严格把控，自2021年10月28日起，查询认证信息接口响应参数facePhotoUrl不再返回任何信息。

更新时间：2021/09/24

个人运营商3要素信息比对（详情版）接口错误码信息全量更新

更新时间：2021/07/09

微信小程序对接说明文档迭代更新

更新时间：2021/04/13

更新范围：

正式环境全量发版上线

更新内容：

企业认证支持外籍法人。涉及新增法人证件类型字段更新的接口：获取组织机构实名认证地址，获取组织机构核身认证地址，发起企业核身认证4要素校验。涉及法人证件号说明更新的接口：企业4要素信息比对，创建机构账号。

更新时间：2021/03/04

更新范围：

正式环境全量发版上线

更新内容：

更新时间：2021/02/04

更新范围：

正式环境全量发版上线

更新内容：

企业信息比对接口（二要素、三要素、四要素）、企业实名认证/核身认证（网页版、发起三要素校验认证、发起企业四要素校验认证）将新增详情版通道，如需接口返回详细不匹配的信息，请联系e签宝相关人员进行配置。

本次新增错误码：

更新时间：2021/01/15

更新范围：

正式环境全量发版上线

更新内容：

• 将原有“企业2要素信息比对”改名为“组织机构2要素信息比对”；
• 本次更新的“组织机构二要素信息比对”接口，支持：对企业、律所、非工商社会组织的组织机构名称，组织机构证件号一致性做核验。

更新时间：2020/12/28

更新范围：

正式环境全量发版上线

更新内容：

更新发版上线《认证服务-错误码对照表》。

• 本期错误码只更新信息比对API和个人实名认证API的错误描述，针对错误描述的文案优化，企业实名认证的错误码请继续参考对应API的错误码描述。
• 本期新增认证过程错误码对照表，主要针对用户在访问认证链接并在认证过程中出现的错误提示做对照，方便开发者快速定位报错原因。

更新时间：2020/12/10

更新范围：

12月09号，沙箱环境已发版上线；预计12月17号，正式环境将全量发版上线。

更新内容：

企业实名认证/核身认证-网页版进行排版优化；页面新增【法定代表人认证】方式等。

具体可参考：《认证服务API用户使用手册》

更新时间：2020/12/04

更新范围：

正式环境全量发版上线

更新内容：

1、个人信息比对新增三个详情版接口，详情版信息比对接口，当信息比对不通过时，会返回具体不一致的响应结果。接口详情请参考：

• 个人运营商3要素信息比对（详情版）
• 个人银行卡3要素信息比对（详情版）
• 个人银行卡4要素信息比对（详情版）

2、个人实名认证/核身认证网页版，新增是否使用详情版字段：authAdvancedEnabled。

入参格式： "authAdvancedEnabled":["PSN_BANK4_AUTHCODE","PSN_TELECOM_AUTHCODE"]

接口详情参考：

• 获取个人实名认证地址
• 获取个人核身认证地址

3、个人实名认证/核身认证API版，运营商3要素认证和发起银行卡4要素认证，新增是否使用详情版字段：grade

接口详情参考：

• 发起运营商3要素实名认证
• 发起运营商3要素核身认证

• 发起银行卡4要素实名认证
• 发起银行卡4要素核身认证

4、企业实名认证/核身认证网页版，新增是否使用详情版字段：agentAuthAdvancedEnabled。

入参格式： "agentAuthAdvancedEnabled":["PSN_BANK4_AUTHCODE","PSN_TELECOM_AUTHCODE"]

接口详情参考：

• 获取组织机构实名认证地址
• 获取组织机构核身认证地址