블로그 · 2026년 5월 20일

스페인 거주지 확인 API (KO)

스페인 주소 및 거주 데이터를 신뢰할 수 있는 주거 및 소비자 데이터 소스와 실시간으로 대조하여 유효성을 검사합니다. 확실한 결과에 대해서만 비용이 청구됩니다. 엔드포인트, 매개변수, 응답 스키마, 가격 및 통합 방법을 안내합니다.

작성자: Didit2026년 5월 20일업데이트됨 2026년 5월 20일

스페인에서 사용자를 온보딩한다는 것은 사용자가 주장하는 본인임을 확인하는 것을 의미합니다. 정부 및 공공 기록, 배경 기록, 공공 전문 프로필을 통합 서비스로 제공합니다. 문서나 입력된 세부 정보는 데이터가 존재한다는 것만 증명할 뿐, 그것이 진짜이거나 사용자 본인의 것임을 증명하지는 않습니다. 스페인 거주지 확인은 신뢰할 수 있는 주거 및 소비자 데이터 소스와 데이터를 대조하여 이러한 격차를 해소합니다. 이 가이드에서는 확인 과정, 정확한 기술 세부 정보 및 몇 분 안에 통합하는 방법을 설명합니다.

주요 내용:

확인 내용 — 스페인 거주지 확인은 신뢰할 수 있는 주거 및 소비자 데이터 소스와 주소 및 거주 데이터를 대조하여 유효성을 검사합니다.
결과물 — 정규화된 match_type과 함께 승인/검토/거부 로직에 바로 연결할 수 있는 필드 수준 결과를 제공합니다.
중요성 — 신뢰할 수 있는 데이터에 대한 주소 확인은 신청자가 주장하는 곳에 실제로 거주하는지 확인합니다. 이는 핵심적인 부정 방지 및 규정 준수 신호입니다.
사용 방법 — Didit의 데이터베이스 검증 엔드포인트에 POST 요청 한 번, 또는 노코드 워크플로 모듈을 사용합니다. 확실한 쿼리당 0.24달러이며, 몇 초 안에 결과를 얻을 수 있습니다.

스페인 거주지 확인이 검증하는 내용

정부 및 공공 기록, 배경 기록, 공공 전문 프로필을 통합 서비스로 제공합니다. Didit은 단일 엔드포인트를 통해 이를 노출하여 제출된 데이터를 신뢰할 수 있는 주거 및 소비자 데이터 소스와 대조하여 검증하고, 직접 파싱할 필요 없는 구조화되고 정규화된 결과를 받을 수 있도록 합니다.

확실한 응답은 일치하는 source_data와 필드별 validation 블록을 반환하므로, 위험 엔진은 명확하고 기계가 읽을 수 있는 판정을 받습니다.

중요성

신뢰할 수 있는 데이터에 대한 주소 확인은 신청자가 주장하는 곳에 실제로 거주하는지 확인합니다. 이는 핵심적인 부정 방지 및 규정 준수 신호입니다.

스페인의 규제 대상 기업(핀테크, 암호화폐 플랫폼, 대출 기관, 마켓플레이스, 게임 운영자)의 경우, 신뢰할 수 있는 소스와의 대조를 통해 신원이 단순히 양식이나 사진에서 캡처된 것이 아니라 원본에서 확인되었음을 입증할 수 있는 감사 가능한 기록을 생성합니다.

기술 세부 정보

Didit은 통합 데이터베이스 검증 엔드포인트를 통해 이 서비스를 노출합니다. SDK가 필요 없는 단일 POST 요청입니다.

엔드포인트

POST /v3/database-validation/

요청 매개변수

매개변수	유형	필수 여부	설명
`issuing_state`	문자열	예	ISO 3166-1 alpha-3 국가 코드. `ESP`를 사용합니다.
`services`	문자열	예	서비스 식별자. `esp_residential`을 사용합니다.
`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=ESP" \
  -F "services=esp_residential" \
  -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": "ESP",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "esp_residential",
      "service_name": "Spain Residential",
      "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.24달러. 확실한 결과에 대해서만 비용이 청구됩니다. 소스 다운타임, 누락된 필드 또는 사전 소스 거부에 대해서는 요금이 부과되지 않습니다.
신뢰성: Didit의 인프라에서 실행되며 분기별 99.9%의 가동 시간 목표를 가집니다.

사용 사례

핀테크 및 네오뱅크 — 스페인에서 지갑을 개설하거나 신용을 연장하기 전에 실제적이고 검증 가능한 계정 소유자를 확인합니다.
암호화폐 및 Web3 — 권위 있는 출처의 신원 증명으로 VASP 온보딩 요구 사항을 충족합니다.
대출 — 출처가 확인된 데이터로 합성 신원 및 제1자 사기를 줄입니다.
마켓플레이스 및 긱 플랫폼 — 자체 보고된 양식뿐만 아니라 권위 있는 데이터에 대해 사용자를 확인합니다.
iGaming — 감사 가능한 기록으로 스페인 플레이어의 신원 및 적격성 확인을 충족합니다.

Didit과 통합하는 방법

스페인 거주지 확인은 두 가지 방법으로 실행할 수 있습니다.

노코드 워크플로. Didit Business Console에서 워크플로 빌더를 열고 데이터베이스 검증 모듈을 추가한 다음 스페인 → 스페인 거주지 확인을 선택하고 활성화합니다. 일치하는 사용자는 자동으로 라우팅됩니다. 엔지니어링이 필요하지 않습니다.
직접 API. 위에서 설명한 /v3/database-validation/ 엔드포인트를 services=esp_residential과 함께 호출합니다. match_type 및 필드별 validation 블록을 읽어 승인/검토/거부 로직을 구동합니다.

모든 Didit 계정에는 매월 500회의 무료 확인이 포함되어 있으므로, 단일 쿼리에 대한 비용을 지불하기 전에 전체 흐름을 처음부터 끝까지 테스트할 수 있습니다.

자주 묻는 질문

스페인 거주지 확인 검사는 무엇을 확인합니까?

제출된 데이터를 권위 있는 주거 및 소비자 데이터 소스와 대조하여 유효성을 검사하고 정규화된 일치 결과를 반환하므로, 주소 및 거주 데이터가 권위 있는 소스에 존재하는지, 어떤 필드가 일치하는지 알 수 있습니다.

소스가 일시적으로 사용할 수 없는 경우 어떻게 됩니까?

요금이 청구되지 않습니다. 청구는 확실한 결과에만 적용됩니다. 소스 다운타임, 누락된 필드 및 사전 소스 거부는 무료입니다.

검사 속도는 얼마나 빠릅니까?

데이터베이스 검증은 일반적으로 몇 초 안에 반환되므로 실시간 온보딩 흐름에 적합합니다.

SDK가 필요합니까?

아니요. 검사는 하나의 엔드포인트에 대한 단일 HTTPS POST입니다. 비즈니스 콘솔의 노코드 워크플로에 연결할 수도 있습니다.

시작할 준비가 되셨습니까?

오늘 첫 번째 스페인 주소 및 거주 데이터를 확인하세요.

API 참조 읽기: 스페인 거주지 확인
모든 데이터베이스 검증 보기: 데이터베이스 검증 가격 및 범위
빌드 시작: 무료 Didit 계정 생성 — 매월 500회 확인 무료.