독일 거주지 확인 API 연동 가이드 (KO)
독일 주소 및 거주 데이터를 신뢰할 수 있는 주거 및 소비자 데이터 소스와 실시간으로 대조하여 검증합니다. 결과가 확정된 경우에만 비용이 청구됩니다. 엔드포인트, 매개변수, 응답 스키마, 가격 및 통합 방법을 안내합니다.

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