영국 시민권 확인 API (KO-1)
영국 시민권 기록을 공식 시민권/민사 등록부와 실시간으로 대조하여 유효성을 검사하며, 확정적인 결과에 대해서만 비용을 청구합니다. 엔드포인트, 매개변수, 응답 스키마, 가격 및 통합 방법을 안내합니다.

영국에서 사용자를 온보딩한다는 것은 그들이 주장하는 사람과 동일한지 확인하는 것을 의미합니다. 정부 기관에서 제공하는 선거인 명부 데이터를 기반으로 데이터를 검증합니다. 문서나 입력된 세부 정보는 데이터가 존재한다는 것만 증명할 뿐, 그것이 진짜인지 또는 당신 앞에 있는 사람의 것인지는 증명하지 못합니다. 영국 시민 확인은 공식 시민권/민사 등록부와 데이터를 대조하여 이 간극을 메웁니다. 이 가이드는 이 확인이 무엇을 하는지, 정확한 기술적 세부 사항, 그리고 몇 분 안에 통합하는 방법을 설명합니다.
주요 내용:
- 확인 내용 — 영국 시민 확인은 공식 시민권/민사 등록부에 대해 시민권 기록의 유효성을 검사합니다.
- 반환 내용 — 정규화된
match_type과 승인/검토/거부 로직으로 바로 라우팅할 수 있는 필드 수준 결과. - 중요성 — 원본 등록부에 대해 시민권 상태를 확인하면 신원 위조를 방지하고 거주, 혜택 및 규제된 온보딩 확인을 지원합니다.
- 사용 방법 — Didit의 데이터베이스 유효성 검사 엔드포인트에 한 번의
POST요청, 또는 노코드 워크플로 모듈 사용. 확정적인 쿼리당 $0.75, 몇 초 내에 결과 확인.
영국 시민 확인이 검증하는 내용
정부 기관에서 제공하는 선거인 명부 데이터를 기반으로 데이터를 검증합니다. Didit은 단일 엔드포인트를 통해 이를 노출하므로 제출된 데이터를 공식 시민권/민사 등록부와 대조하여 검증하고, 직접 파싱할 필요 없는 구조화되고 정규화된 결과를 받을 수 있습니다.
확정적인 응답은 일치하는 source_data와 필드별 validation 블록을 반환하므로 위험 엔진이 명확하고 기계 판독 가능한 판정을 얻을 수 있습니다.
중요성
원본 등록부에 대해 시민권 상태를 확인하면 신원 위조를 방지하고 거주, 혜택 및 규제된 온보딩 확인을 지원합니다.
영국의 규제 대상 기업(핀테크, 암호화폐 플랫폼, 대출 기관, 마켓플레이스, 게임 운영자)의 경우, 신뢰할 수 있는 출처를 통해 확인하는 것은 신원이 양식이나 사진에서 단순히 캡처된 것이 아니라 출처에서 확인되었음을 입증하는 방어 가능하고 감사 가능한 기록을 생성합니다.
기술적 세부 사항
Didit은 통합 데이터베이스 유효성 검사 엔드포인트를 통해 이 서비스를 노출합니다. 단일 POST 요청이며, SDK가 필요하지 않습니다.
엔드포인트
POST /v3/database-validation/
요청 매개변수
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
issuing_state | 문자열 | 예 | ISO 3166-1 alpha-3 국가 코드. GBR 사용. |
services | 문자열 | 예 | 서비스 식별자. gbr_kingdom_citizens 사용. |
first_name | 문자열 | 예 | 이름. |
last_name | 문자열 | 예 | 성. |
date_of_birth | 문자열 | 예 | 생년월일. |
address | 문자열 | 예 | 주소. |
예시 요청
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=GBR" \
-F "services=gbr_kingdom_citizens" \
-F "first_name=John" \
-F "last_name=Doe" \
-F "date_of_birth=1990-01-01" \
-F "address=123 Sample Street, Sample City, 10001"
예시 응답 (확정적 일치)
{
"request_id": "req_01H...",
"status": "Approved",
"issuing_state": "GBR",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "gbr_kingdom_citizens",
"service_name": "United Kingdom Citizens",
"source_data": {
"address": "123 Sample Street",
"date_of_birth": "1990-01-01",
"first_name": "John",
"last_name": "Doe"
},
"validation": {
"address": "full_match",
"date_of_birth": "full_match",
"full_name": "full_match"
}
}
]
}
성능 및 청구
- 대기 시간: 일반적으로 몇 초.
- 비용: 확정적인 쿼리당 $0.75. 확정적인 결과에 대해서만 비용이 청구되며, 소스 다운타임, 누락된 필드 또는 소스 전 거부에 대해서는 비용이 청구되지 않습니다.
- 신뢰성: Didit의 인프라에서 실행되며 분기별 99.9%의 가동 시간 목표를 가집니다.
사용 사례
- 핀테크 & 네오뱅크 — 영국에서 지갑을 개설하거나 신용을 제공하기 전에 실제 검증 가능한 계정 소유자를 확인합니다.
- 암호화폐 & Web3 — 신뢰할 수 있는 출처의 신원 증명으로 VASP 온보딩 요구 사항을 충족합니다.
- 대출 — 출처가 확인된 데이터로 합성 신원 및 1인칭 사기를 줄입니다.
- 마켓플레이스 & 긱 플랫폼 — 자체 보고된 양식뿐만 아니라 신뢰할 수 있는 데이터에 대해 사용자를 확인합니다.
- iGaming — 감사 가능한 기록으로 영국 플레이어의 신원 및 자격 확인을 충족합니다.
Didit과 통합하는 방법
영국 시민 확인은 두 가지 방법으로 실행할 수 있습니다.
- 노코드 워크플로. Didit 비즈니스 콘솔에서 워크플로 빌더를 열고 데이터베이스 유효성 검사 모듈을 추가한 다음 영국 → 영국 시민 확인을 선택하고 활성화합니다. 일치하는 사용자는 자동으로 라우팅되며, 엔지니어링이 필요하지 않습니다.
- 직접 API. 위에 표시된
/v3/database-validation/엔드포인트를services=gbr_kingdom_citizens와 함께 호출합니다.match_type과 필드별validation블록을 읽어 승인/검토/거부 로직을 구동합니다.
모든 Didit 계정에는 매월 500건의 무료 확인이 포함되어 있으므로, 단일 쿼리에 대한 비용을 지불하기 전에 전체 흐름을 처음부터 끝까지 테스트할 수 있습니다.
자주 묻는 질문
영국 시민 확인은 무엇을 확인하나요?
제출된 데이터를 공식 시민권/민사 등록부와 대조하여 유효성을 검사하고 정규화된 일치 결과를 반환하므로, 시민권 기록이 신뢰할 수 있는 출처에 존재하는지, 어떤 필드가 일치하는지 알 수 있습니다.
소스가 일시적으로 사용 불가능한 경우 어떻게 되나요?
요금이 청구되지 않습니다. 청구는 확정적인 결과에만 적용되며, 소스 다운타임, 누락된 필드 및 소스 전 거부는 무료입니다.
확인 속도는 얼마나 빠른가요?
데이터베이스 유효성 검사는 일반적으로 몇 초 내에 반환되므로 실시간 온보딩 흐름에 적합합니다.
SDK가 필요한가요?
아니요. 확인은 하나의 엔드포인트에 대한 단일 HTTPS POST입니다. 비즈니스 콘솔에서 노코드 워크플로에 연결할 수도 있습니다.
시작할 준비가 되셨나요?
오늘 첫 영국 시민권 기록을 확인하세요.
- API 참조 읽기: 영국 시민 확인
- 모든 데이터베이스 유효성 검사 보기: 데이터베이스 유효성 검사 가격 및 범위
- 빌드 시작: 무료 Didit 계정 만들기 — 매월 500건의 무료 확인.