파나마 신원 검증

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

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

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

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

• 전체 성명 및 CCPA 번호: 국민 및 거주자를 위한 Cédula de Identidad Personal(CCPA)을 지원합니다.
• 신원 일치 여부: 제공된 이름이 CCPA 번호와 일치하는지 확인합니다.
• 출생일 검증: 출생일이 공식 기록과 일치하는지 검증합니다.

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

API 레퍼런스

엔드포인트

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

공식 민정 등기소 출처를 기반으로 파나마 CCPA(Cédula de Identidad Personal) 데이터를 검증합니다. documentType(CCPA), 정규화된 documentNumber, DD/MM/YYYY 형식의 dateOfBirth 를 전달하면, KYC, 고객 온보딩, 사기 통제에 활용할 수 있도록 신원 기록의 일치 여부를 응답으로 확인합니다.

헤더(Headers)

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

매개변수(Parameters)

이름	형식	필수	설명
documentType	string	예	문서 종류. 허용 값: CCPA.
documentNumber	string	예	정규화 후 완전한 파나마 cédula. 아래 허용되는 documentNumber 형식 참고.
dateOfBirth	string	예	DD/MM/YYYY 형식의 출생일.

허용되는 documentNumber 형식

본 API는 완전한 cédula 문자열을 허용합니다. 입력 값은 서버에서 정규화됩니다. 공백 제거, 대문자 변환, 반복된 구분자를 단일 하이픈으로 통합합니다. 공백, /, _, ., 유니코드 대시류 문자는 구분자로 처리됩니다. 주(州) 코드와 접미사 AV 또는 PI 사이에 추가 하이픈이 있을 경우(예: 10-AV-1234-12345), 검증 전 10AV-1234-12345 형태로 병합됩니다.

구조: firstSegment-libro-tomo

• Libro(중간 세그먼트): 1–4자리 숫자
• Tomo(마지막 세그먼트): 1–6자리 숫자

First segment(다음 중 하나):

1. 파나마 출생 — 주 코드 1, 2–9, 또는 10–13, 그 다음 libro, tomo. 예: 8-1234-12345, 4-56-789, 12-12-12345
2. 해외 출생 파나마인 — 접두사 PE. 예: PE-1234-12345
3. cédula 보유 외국인 — 접두사 E. 예: E-1234-12345, E-8-102017
4. 귀화인 — 접두사 N. 예: N-1234-12345
5. 2006년 이전 민정 등기소(AV) — 주 코드 바로 뒤에 AV. 예: 10AV-1234-12345
6. 원주민(PI) — 주 코드 바로 뒤에 PI. 예: 1PI-1234-12345

공식 주 코드는 1–13입니다. 잘못된 코드(예: 14)는 거부됩니다.

쿼리 문자열: documentNumber를 전달할 때 하이픈이 보존되도록 해야 합니다. 일부 클라이언트나 파서는 E-8-197698과 같은 값을 잘못 처리할 수 있으므로(예: 과학적 표기), 원시 쿼리 문자열, 적절한 인코딩, 또는 값을 문자열로 유지하는 라이브러리를 사용해 주십시오.

검증 오류: documentNumber가 정규화 후에도 완전한 유효 cédula가 아닐 경우, API는 형식 오류를 나타내는 메시지(예: Format incorrect: documentNumber)와 함께 409를 반환합니다.

형식 규칙은 오픈 소스 cedula-panama 검증기(MIT 라이선스)와 일치합니다.

요청(Request)

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/pa/cedula", {
  params: { documentType: "CCPA", documentNumber: "8-1251-1829", dateOfBirth: "02/03/1992" },
  headers: { Accept: "application/json", Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` },
});
console.log(data);

PHP

<?php
$ch = curl_init("https://api.verifik.co/v2/pa/cedula");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Accept: application/json",
    "Authorization: Bearer " . getenv("VERIFIK_TOKEN")
]);
$query = http_build_query([
    "documentType" => "CCPA",
    "documentNumber" => "8-1251-1829",
    "dateOfBirth" => "02/03/1992"
]);
curl_setopt($ch, CURLOPT_URL, "https://api.verifik.co/v2/pa/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/pa/cedula"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CCPA", "documentNumber": "8-1251-1829", "dateOfBirth": "02/03/1992"}
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/pa/cedula?documentType=CCPA&documentNumber=8-1251-1829&dateOfBirth=02/03/1992"
    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": "CCPA",
    "documentNumber": "8-1251-1829",
    "firstName": "Roberto",
    "lastName": "Martínez",
    "fullName": "Roberto Martínez",
    "dateOfBirth": "1992-03-02",
    "status": "valid"
  },
  "signature": {"message": "Certified by Verifik.co", "dateTime": "January 16, 2024 3:44 PM"},
  "id": "PA001"
}

400

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

409

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

401

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

500

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

비고

• 출생일은 필수이며, 신분증 명의자와 일치해야 합니다.
• 모든 지원 cédula 패턴 및 정규화 동작은 허용되는 documentNumber 형식 을 참고해 주십시오.

---

일반적인 활용 사례

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

공식 출처와 신뢰성

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

주요 이점

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

컴플라이언스와 보안

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

Verifik 소개

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