委内瑞拉身份核验
Verifik 的身份核验 API 可基于政府官方数据对委内瑞拉公民进行身份核实。该接口旨在简化您的 KYC(了解您的客户)流程、防范欺诈,并轻松满足合规要求。
我们专为需要快速、安全且自动化确认用户、员工或客户真实身份的企业打造此集成。
此 API 验证哪些内容?
我们的 API 直接对接官方记录,验证以下内容:
- 姓名全称与证件号码:支持委内瑞拉身份证件(CCVE)。
- 身份匹配:确认所提供姓名与证件号码相符。
- 可选个人详情:在数据可用时可包含出生日期、性别与婚姻状态。
通过验证这些信息,您可以确信对接的人员真实存在并持有有效证件,从而显著降低身份冒用与欺诈风险。
API 参考
Endpoint
https://api.verifik.co/v2/ve/cedula
该接口面向委内瑞拉本国公民,使用 CCVE(Cédula de Identidad)证件类别返回身份数据。请将 cédula 号码作为 documentNumber 传入;API 会查询记录并返回结构化的姓名字段,适用于 KYC、客户开通与反欺诈核查。如需核验外国居民,请改用 GET /v2/ve/foreigner-id(CEVE)。
请求头(Headers)
| 名称 | 取值 |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
参数(Parameters)
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
documentNumber | string | 是 | 国民 cédula 号码(CCVE)。无需传 documentType,本接口会自动按 CCVE 处理。 |
请求(Request)
- Node.js
- PHP
- Python
- Go
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/ve/cedula", {
params: { documentNumber: "123456789" },
headers: { Accept: "application/json", Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` },
});
console.log(data);
<?php
$ch = curl_init("https://api.verifik.co/v2/ve/cedula");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Accept: application/json",
"Authorization: Bearer " . getenv("VERIFIK_TOKEN")
]);
$query = http_build_query([
"documentNumber" => "123456789"
]);
curl_setopt($ch, CURLOPT_URL, "https://api.verifik.co/v2/ve/cedula?".$query);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
import os, requests
url = "https://api.verifik.co/v2/ve/cedula"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentNumber": "123456789"}
r = requests.get(url, headers=headers, params=params)
print(r.json())
package main
import (
"fmt"
"net/http"
)
func main() {
url := "https://api.verifik.co/v2/ve/cedula?documentNumber=123456789"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Set("Accept", "application/json")
req.Header.Set("Authorization", "Bearer "+getenv("VERIFIK_TOKEN"))
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
fmt.Println(resp.Status)
}
响应(Response)
- 200
- 200(含可选字段)
- 401
- 403
- 404
- 409
- 500
{
"data": {
"arrayName": [
"CARLA",
"SARAI",
"PULIDO",
"RAMIREZ"
],
"documentNumber": "30246051",
"documentType": "CCVE",
"firstName": "CARLA SARAI",
"fullName": "CARLA SARAI PULIDO RAMIREZ",
"lastName": "PULIDO RAMIREZ"
},
"signature": {
"dateTime": "November 13, 2025 3:52 PM",
"message": "Certified by Verifik.co"
},
"id": "OHZC9"
}
{
"data": {
"arrayName": [
"NEIVIS",
"JOSEFINA",
"PEREZ",
"VARGAS"
],
"birthDate": "1998-03-01",
"documentNumber": "28055196",
"documentType": "CCVE",
"firstName": "NEIVIS JOSEFINA",
"fullName": "NEIVIS JOSEFINA PEREZ VARGAS",
"gender": "FEMENINO",
"lastName": "PEREZ VARGAS"
},
"signature": {
"dateTime": "November 13, 2025 8:12 PM",
"message": "Certified by Verifik.co"
},
"id": "GGLIK"
}
{
"message": "Authentication required",
"code": "UNAUTHORIZED"
}
{
"message": "Access forbidden",
"code": "FORBIDDEN"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing documentNumber"
}
{
"code": "InternalServerError",
"message": "Server error."
}
备注
documentNumber为必填项。- 视数据可用性,响应中可能包含
birthDate、gender与maritalStatus字段;并非所有响应都会返回这些字段。 - 当返回
birthDate时,格式为YYYY-MM-DD(例如 "1998-03-01")。
常见使用场景
- 金融科技与银行:在开户或贷款申请过程中即时核验身份。
- 电商与配送:在用户与配送员入驻您的平台前完成身份核验。
- 人力资源与招聘:将候选人证件核验纳入招聘流程。
- 保险与医疗:在出单或提供医疗福利前确认身份。
官方数据源与可靠性
我们直接对接委内瑞拉政府官方数据源,确保您获得经过验证且最新的信息。 每次查询均严格遵循安全与监管标准。
主要优势
- 自动化合规:在不增加用户摩擦的前提下简化 KYC 检查并防范欺诈。
- 即时结果:在数秒内完成核验,适用于实时数字化开通。
- 可信数据:采用直接来源于官方记录的数据。
- 轻松集成:通过 REST API 或兼容 SDK 即可便捷接入。
合规与安全
我们高度重视您的数据安全。Verifik 采用高级加密(HTTPS / TLS 1.3)和严格的隐私管理标准以确保机密性。 我们的服务全天候 24/7 监控可用性,并提供基于角色的访问控制以保障团队访问安全。
关于 Verifik
Verifik 是拉丁美洲领先的身份核验、合规与反欺诈平台。 我们的 API 自动化 KYC、KYB、AML 与生物识别验证流程,将企业与哥伦比亚、墨西哥、秘鲁、智利、乌拉圭、阿根廷、巴西、委内瑞拉及更多地区的官方数据源相连。