接入文档
证件信息验真（海外版）
墨西哥
人证官方一致性校验
人证官方一致性校验

# 1 功能描述

  • 该产品主要解决身份冒用、他人代操作、虚假实名等风控问题，适用于实名认证、在线开户、权限开通、高风险业务办理等场景，实现“人、证、本人”三位一体的真实身份核验。
  • 支持墨西哥选民卡“G”“H”类。

# 2 使用说明

# 2.1 调用URL

  • 新加坡地址：https://api-sgp.yljz.com/finauth/v5/ine/personmatch
  • 墨西哥地址：https://api-mx.yljz.com/finauth/v5/ine/personmatch

注意：生产环境必须使用 HTTPS 通信方式；HTTP 属于不安全链路，存在安全风险，禁止在生产环境使用，且不提供服务可靠性保障。

# 2.2 调用方法

  • 请求方式：POST
  • 请求格式：form-data
  • 说明：客户端通过 apikey 和 secret 生成加密签名 sign，同时传入证件反面图片、人像图片及业务流水号，接口返回人证比对核验结果及置信分数。

# 3 请求参数

参数 参数名 是否必填 类型 说明
sign 签名 是 String 签名生成规则参考鉴权说明
sign_version 签名算法版本号 是 String 固定传值：hmac_sha1 或 hmac_sha256
image_reverse ine反面图片 是 File 与人像图片一致，客户方自行拍摄的照片
图片限制：
1. 图片大小 ≤ 5MB
2. 分辨率≤ 5000×5000 px
3. 格式：JPG/JPEG/PNG
image_ref 人像图片 是 File
biz_no 业务流水号 否 String 自定义本次业务唯一流水号

# 4 返回参数

字段 字段名 类型 参数说明
code 返回码 String 比对成功返回“0000”，详见返回码描述对照表
request_id 请求号 String 用于区分每一次请求的唯一的字符串。除非发生404（API_NOT_FOUND）或 403 （AUTHORIZATION_ERROR）错误，剩余情况此字段必定返回。
time_used 请求耗时 Int 整个请求所花费的时间，单位为毫秒。此字段必定返回。
biz_no 业务流水号 String 传入的业务流水号，原封不动地返回。
verification 人脸比对结果 JSON 人脸比对结果详情，包含比对分数等核心数据
--confidence 比对分数 Float 示例值：88.038055判定规则：高于74.39926为可信分值，分数越高人脸比对可信度越高

# 5 ERROR 错误信息对照表

HTTP状态代码 返回码描述 是否计费 说明
200 0000 是 比对一致
200 0002 是 人证比对不一致
400 ID_CARD_NOT_FOUND 否 未检测到卡证
400 LOW_QUALITY 否 卡证质量异常
400 ID_CARD_UNRECOGNIZABLE 否 卡证无法识别
400 NO_FACE_FOUND 否 未检测到人脸
400 MULTIPLE_FACES 否 检测到多张人脸
400 MISSING_ARGUMENTS:<key> 否 缺少某个必选参数
400 BAD_ARGUMENTS:<key> 否 某个参数解析出错（比如必须是数字，但是输入的是非数字字符串; 或者长度过长）
400 IMAGE_ERROR_UNSUPPORTED_FORMAT:<param> 否 对应的图像无法解析，有可能不是图像文件、或有数据破损。
400 INVALID_IMAGE_SIZE:<param> 否 客户上传的图像太大，具体是指像素尺寸的长或宽超过接口限制像素。
403 AUTHENTICATION_ERROR 否 无效签名
403 AUTHORIZATION_ERROR:<reason> 否 api_key被停用、调用次数超限、没有调用此API的权限，或者没有以当前方式调用此API的权限
403 CONCURRENCY_LIMIT_EXCEEDED 否 并发数超过限制
404 API_NOT_FOUND 否 所调用的API不存在
413 Request Entity Too Large 否 客户发送的请求大小超过了限制。该错误的返回格式为纯文本，不是json格式
500 INTERNAL_ERROR 否 服务器内部错误，当此类错误发生时请再次请求，如果持续出现此类错误，请及时联系FaceID客服或商务
Copyright © 2026 原力金智（重庆）科技有限公司