베네수엘라 신원 검증

Verifik의 신원 확인 API는 정부 공식 데이터를 활용해 베네수엘라 국민의 신원을 인증할 수 있도록 합니다. KYC(Know Your Customer) 절차를 자동화하고, 사기를 예방하며, 규제 요구사항을 손쉽게 충족할 수 있도록 설계되었습니다.

사용자, 직원, 고객의 진짜 신원을 빠르고 안전하게 자동으로 확인해야 하는 비즈니스를 위해 만들어졌습니다.

이 API는 무엇을 검증합니까?

당사의 API는 공식 기록과 직접 연결되어 다음을 검증합니다.

• 전체 성명 및 문서 번호: 베네수엘라 신분증(CCVE)을 지원합니다.
• 신원 일치 여부: 제공된 이름이 문서 번호와 일치하는지 확인합니다.
• 선택적 개인 상세 정보: 출생일, 성별, 혼인 상태가 가용할 경우 포함될 수 있습니다.

이러한 항목을 검증함으로써 거래 상대가 실존하며 유효한 문서를 보유하고 있음을 확신할 수 있고, 신원 도용 및 사기 위험을 크게 낮출 수 있습니다.

API 레퍼런스

엔드포인트

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

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

<?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;

Python

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())

Go

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

{
  "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"
}

200 (선택 필드 포함)

{
  "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"
}

401

{
  "message": "Authentication required",
  "code": "UNAUTHORIZED"
}

403

{
  "message": "Access forbidden",
  "code": "FORBIDDEN"
}

404

{
  "code": "NotFound",
  "message": "Record not found."
}

409

{
  "code": "MissingParameter",
  "message": "missing documentNumber"
}

500

{
    "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, 생체 인증 절차를 자동화하며, 콜롬비아, 멕시코, 페루, 칠레, 우루과이, 아르헨티나, 브라질, 베네수엘라 및 그 외 지역의 공식 데이터 소스와 비즈니스를 연결합니다.