🇻🇪 베네수엘라 — 외국인 신분증

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

베네수엘라에 있는 외국인 고객, 직원, 파트너의 신원을 빠르고 안전하게 자동으로 확인해야 하는 비즈니스를 위해 만들어졌습니다.

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

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

• 전체 성명 및 문서 번호: 외국인 신분증(CEVE — Cédula de Identidad de Extranjero)을 지원합니다.
• 신원 일치 여부: 반환된 이름이 등록 문서와 일치합니다.
• 문서 종류: 본 라우트의 응답에는 documentType: "CEVE" 가 포함됩니다.

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

API 레퍼런스

엔드포인트

https://api.verifik.co/v2/ve/foreigner-id

본 엔드포인트는 CEVE cédula로 등록된 외국인 을 위한 것입니다. 문서 번호를 documentNumber 로 전달하면 API가 CEVE 를 적용해 구조화된 신원 필드를 반환합니다. 베네수엘라 국민(국가 CCVE)의 경우에는 GET /v2/ve/cedula를 사용하시기 바랍니다.

헤더(Headers)

이름	값
Accept	application/json
Authorization	Bearer <token>

매개변수(Parameters)

이름	형식	필수	설명
documentNumber	string	예	외국인 거주자의 CEVE cédula 번호. documentType 쿼리는 필요하지 않으며, 본 엔드포인트에서는 CEVE 가 자동 적용됩니다.

요청(Request)

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/ve/foreigner-id", {
  params: { documentNumber: "123456789" },
  headers: { Accept: "application/json", Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` },
});
console.log(data);

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer <your_token>"
}

conn.request("GET", "/v2/ve/foreigner-id?documentNumber=123456789", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

PHP

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.verifik.co/v2/ve/foreigner-id?documentNumber=123456789', [
  'headers' => [
    'Accept' => 'application/json',
    'Authorization' => 'Bearer <your_token>',
  ],
]);

echo $response->getBody();

Swift

import Foundation

let headers = [
  "Accept": "application/json",
  "Authorization": "Bearer <your_token>"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.verifik.co/v2/ve/foreigner-id?documentNumber=123456789")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()

응답(Response)

200

{
  "data": {
    "documentType": "CEVE",
    "documentNumber": "123456789",
    "fullName": "MATEO VENEZUELA VERIFIK",
    "lastName": "MATEO",
    "firstName": "VENEZUELA VERIFIK",
    "arrayName": [
      "MATEO",
      "VENEZUELA",
      "VERIFIK"
    ]
  },
  "signature": {
    "dateTime": "March 13, 2024 2:01 AM",
    "message": "Certified by Verifik.co"
  },
  "id": "7VWXP"
}

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

---

일반적인 활용 사례

• 외국인 거주자 검증: 채용 목적의 베네수엘라 내 외국인 신원을 검증합니다.
• 금융 서비스: 은행 및 금융 서비스 신청 시 외국인의 신원을 검증합니다.
• 법적 컴플라이언스: 외국인 거주자에 대한 베네수엘라 규정 준수를 보장합니다.
• 문서 인증: 공식 목적의 외국인 문서를 인증합니다.
• 신원 검증: 외국인의 신원 검증 절차를 효율화합니다.

공식 출처와 신뢰성

베네수엘라 정부 공식 데이터 소스와 직접 연결되어 검증되고 최신 상태의 정보를 제공합니다. 모든 조회는 보안 및 규제 표준을 엄격히 준수하여 처리됩니다.

주요 이점

• 자동화된 컴플라이언스: 사용자 경험을 해치지 않으면서 KYC 점검을 자동화하고 사기를 방지합니다.
• 즉각적인 결과: 수 초 내에 검증을 처리하므로 실시간 신원 확인에 적합합니다.
• 신뢰할 수 있는 데이터: 공식 기록을 직접 참조한 데이터를 사용합니다.
• 간편한 통합: REST API 또는 호환 SDK를 통해 손쉽게 연결할 수 있습니다.

컴플라이언스와 보안

Verifik은 데이터 안전을 최우선으로 합니다. 고급 암호화(HTTPS/TLS 1.3)와 엄격한 개인정보 관리 표준을 사용해 기밀성을 보장합니다. 서비스는 24/7 가용성 모니터링을 적용하고, 팀 접근 제어를 위해 역할 기반 접근 제어를 제공합니다.

Verifik 소개

Verifik은 라틴아메리카 전역에서 신원 확인, 컴플라이언스, 사기 예방을 제공하는 선도적인 플랫폼입니다. 저희 API는 KYC, KYB, AML, 생체 인증 절차를 자동화하며, 콜롬비아, 멕시코, 페루, 칠레, 우루과이, 아르헨티나, 브라질, 베네수엘라 및 그 외 지역의 공식 데이터 소스와 비즈니스를 연결합니다.