接入文档
证件信息验真（海外版）
印尼身份证信息验真API
印尼身份证信息验真API

# 1 功能描述

  • 支持验证用户姓名、证件号、出生日期、自拍照信息真伪一致性；
  • 支持证件覆盖范围：印尼身份证

# 2 使用说明

# 2.1 调用URL

  • 印尼地址：https://api-idn.yljz.com/finauth/v5/oversea_validation

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

# 2.2 调用方法

  • 请求方式：POST
  • 请求格式：form-data
  • 说明：客户端通过 apikey 和 secret 生成加密签名 sign，同时传入证件相关信息及自拍照，接口返回证件信息核验结果。

# 3 请求参数

参数 参数名 是否必填 类型 说明
sign 签名 是 String 签名生成规则参考鉴权文档
sign_version 签名算法版本号 是 String 固定传值：hmac_sha1
certificate_id 证件类型id 是 String 印尼身份证：ID_ID
biz_no 业务流水号 否 String 自定义本次业务唯一流水号
id_no 国家统一证件号 是 String 印尼传入NIK号
name 用户姓名 是 String 用户完整全名
dob 出生日期 是 String 格式要求：DD-MM-YYYY
selfie 自拍照 是 String 1. Base64编码
2. 图片大小 ≤ 2MB
3. 支持格式：JPG/JPEG/PNG
4. 示例：/9j/7DFKAeSLkgEQABAAD/
validate_auth 身份验证 是 String 固定只能传：true

# 4 返回参数

备注：不同卡证类型仅返回适配字段，非全部返回。

字段 字段名 类型 参数说明
request_id 请求号 String 请求唯一标识；除404、403错误外必返回
time_used 请求耗时 Int 请求整体耗时，单位：毫秒，必返回
biz_no 业务流水号 String 原样返回入参的业务流水号
certificate_id 证件类型id String 返回客户端传入的证件类型ID
status 验证状态 String 数据整体验真结果：
0：全部数据验证为真
1：部分数据验证为真
2：全部数据验证为假
validate_result 验证结果 JSON 字段级精细化验证结果，返回 true / false
--id_no 国家统一证件号 String 证件号单项核验结果
--name 用户姓名 String 姓名单项核验结果
--dob 出生日期 String 出生日期单项核验结果
--selfie 自拍照 String 人脸自拍照单项核验结果
error 错误信息 String 接口异常时返回对应错误码

# 5 ERROR 错误信息对照表

HTTP 状态代码 返回码 是否计费 说明
200 SUCCESS 是 接口调用成功
400 MISSING_ARGUMENTS: 否 缺失必要请求参数
400 BAD_ARGUMENTS: 否 参数解析异常（类型错误、长度超限、图片无法解析等）
404 API_NOT_FOUND 否 调用接口地址不存在
403 AUTHORIZATION_ERROR 否 签名无效
403 AUTHORIZATION_ERROR: 否 api_key被停用、无调用权限、IP未授权、调用量超限
5001：api_key无权限或已停用
5002：未经授权IP（预留）
5007：测试key接口调用量达上限
403 CONCURRENCY_LIMIT_EXCEEDED 否 超出接口并发数限制
500 INTERNAL_ERROR 否 服务器内部错误，可重试；持续异常联系客服
Copyright © 2026 原力金智（重庆）科技有限公司