코스타리카 신원 검증

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

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

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

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

• 전체 성명 및 CCCR 번호: Cédula de Identidad Costarricense(CCCR)를 지원합니다.
• 신원 일치 여부: 제공된 이름이 CCCR 번호와 일치하는지 확인합니다.

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

API 레퍼런스

엔드포인트

https://api.verifik.co/v2/cr/cedula

본 엔드포인트는 CCCR(Cédula de Identidad Costarricense)을 공식 출처로 검증합니다. documentType 으로 CCCR을, documentNumber(공백 없는 cédula 번호)를 GET 요청으로 전달하면, 응답에는 KYC, 온보딩, 사기 점검에 활용 가능한 구조화된 이름 필드가 포함됩니다.

헤더(Headers)

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

매개변수(Parameters)

이름	형식	필수	설명
documentType	string	예	문서 종류. 허용 값: CCCR.
documentNumber	string	예	공백 없이 입력한 cédula 번호.

요청(Request)

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/cr/cedula", {
  params: { documentType: "CCCR", 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/cr/cedula");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Accept: application/json",
    "Authorization: Bearer " . getenv("VERIFIK_TOKEN")
]);
$query = http_build_query([
    "documentType" => "CCCR",
    "documentNumber" => "123456789"
]);
curl_setopt($ch, CURLOPT_URL, "https://api.verifik.co/v2/cr/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/cr/cedula"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CCCR", "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/cr/cedula?documentType=CCCR&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": {
    "documentType": "CCCR",
    "documentNumber": "123456789",
    "firstName": "Ana",
    "lastName": "Rodríguez",
    "fullName": "Ana Rodríguez",
    "status": "valid"
  },
  "signature": {"message": "Certified by Verifik.co", "dateTime": "January 16, 2024 3:44 PM"},
  "id": "CR001"
}

400

{
  "message": "Invalid document number",
  "code": "INVALID_DOCUMENT"
}

401

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

500

{
    "code": "InternalServerError",
    "message": "Server error."
}

비고

• 번호는 공백이나 점 없이 입력해 주십시오.

---

일반적인 활용 사례

• 핀테크 및 은행: 계좌 개설 또는 대출 신청 시 즉시 신원을 검증합니다.
• 이커머스 및 배달: 사용자나 배송원이 플랫폼에 활성화되기 전에 인증합니다.
• 인사 및 채용: 채용 절차의 일환으로 후보자의 문서를 검증합니다.
• 보험 및 의료: 보험 가입 또는 의료 혜택 제공 전에 신원을 확인합니다.

공식 출처와 신뢰성

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

주요 이점

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

컴플라이언스와 보안

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

Verifik 소개

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