블로그 · 2026년 5월 20일

포르투갈 거주지 확인 API (KO)

권위 있는 거주 및 소비자 데이터 소스와 비교하여 포르투갈 주소 및 거주 데이터를 실시간으로 검증하며, 확정적인 결과에 대해서만 비용을 청구합니다. 엔드포인트, 매개변수, 응답 스키마, 가격 및 통합에 대해 설명합니다.

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

포르투갈에서 사용자를 온보딩하는 것은 사용자가 본인임을 확인하는 것을 의미합니다. 입력된 데이터는 부동산 소유권 및 공공기관 등록부의 결합된 데이터 소스와 대조하여 확인됩니다. 문서나 입력된 세부 정보는 데이터가 존재한다는 것만 증명할 뿐, 그것이 진정한 것이거나 사용자 본인의 것임을 증명하지는 않습니다. 포르투갈 거주지 확인은 권위 있는 거주 및 소비자 데이터 소스와 데이터를 대조하여 이러한 격차를 해소합니다. 이 가이드는 검사가 수행하는 작업, 정확한 기술 세부 정보 및 몇 분 안에 통합하는 방법을 설명합니다.

주요 내용:

확인 내용 — 포르투갈 거주지 확인은 권위 있는 거주 및 소비자 데이터 소스와 대조하여 주소 및 거주 데이터를 검증합니다.
반환 내용 — 정규화된 match_type과 필드 수준 결과가 반환되어 승인/검토/거부 논리로 직접 라우팅할 수 있습니다.
중요성 — 권위 있는 데이터에 대한 주소 확인은 신청자가 주장하는 곳에 실제로 거주하는지 확인합니다. 이는 핵심적인 사기 방지 및 규정 준수 신호입니다.
사용 방법 — Didit의 데이터베이스 검증 엔드포인트에 POST 한 번 또는 코드 없는 워크플로 모듈을 사용합니다. 확정적인 쿼리당 $1.02이며, 몇 초 안에 결과를 얻을 수 있습니다.

포르투갈 거주지 확인이 검증하는 내용

입력된 데이터는 부동산 소유권 및 공공기관 등록부의 결합된 데이터 소스와 대조하여 확인됩니다. Didit은 단일 엔드포인트를 통해 이를 노출하므로, 제출된 데이터를 권위 있는 거주 및 소비자 데이터 소스와 대조하여 확인하고 원시 레지스트리 덤프를 직접 구문 분석할 필요 없이 구조화되고 정규화된 결과를 받을 수 있습니다.

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

중요성

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

포르투갈의 규제 대상 기업(핀테크, 암호화폐 플랫폼, 대출 기관, 마켓플레이스 및 게임 운영자)의 경우, 권위 있는 소스와 비교하여 확인하면 신원이 단순히 양식이나 사진에서 캡처된 것이 아니라 원본에서 확인되었다는 방어 가능하고 감사 가능한 기록이 생성됩니다.

기술 세부 정보

Didit은 통합 데이터베이스 검증 엔드포인트를 통해 이 서비스를 노출합니다. 단일 POST이며 SDK가 필요하지 않습니다.

엔드포인트

POST /v3/database-validation/

요청 매개변수

매개변수	유형	필수	설명
`issuing_state`	문자열	예	ISO 3166-1 알파-3 국가 코드. `PRT`를 사용합니다.
`services`	문자열	예	서비스 식별자. `prt_residential`을 사용합니다.
`first_name`	문자열	예	이름.
`last_name`	문자열	예	성.
`address`	문자열	예	주소.
`date_of_birth`	문자열	아니요	생년월일 (선택적 교차 확인).

예시 요청

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=PRT" \
  -F "services=prt_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": "PRT",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "prt_residential",
      "service_name": "Portugal Residential",
      "source_data": {
        "address": "123 Sample Street",
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "last_name": "Doe"
      },
      "validation": {
        "address": "full_match",
        "full_name": "full_match"
      }
    }
  ]
}

성능 및 청구

지연 시간: 일반적으로 몇 초.
비용: 확정적인 쿼리당 $1.02. 확정적인 결과에 대해서만 비용이 청구됩니다. 소스 다운타임, 누락된 필드 또는 소스 이전 거부에 대해서는 요금이 부과되지 않습니다.
신뢰성: Didit의 인프라에서 실행되며 분기별 목표 가동 시간은 99.9%입니다.

사용 사례

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

Didit과 통합하는 방법

포르투갈 거주지 확인은 두 가지 방법으로 실행할 수 있습니다.

코드 없는 워크플로. Didit 비즈니스 콘솔에서 워크플로 빌더를 열고, 데이터베이스 검증 모듈을 추가하고, 포르투갈 → 포르투갈 거주지 확인을 선택한 다음 활성화합니다. 일치하는 사용자는 자동으로 라우팅됩니다. 엔지니어링이 필요하지 않습니다.
직접 API. services=prt_residential과 함께 위에 표시된 /v3/database-validation/ 엔드포인트를 호출합니다. match_type과 필드별 validation 블록을 읽어 승인/검토/거부 논리를 구동합니다.

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

자주 묻는 질문

포르투갈 거주지 확인 검사는 무엇을 확인합니까?

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

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

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

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

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

SDK가 필요합니까?

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

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

오늘 첫 번째 포르투갈 주소 및 거주 데이터를 검증하십시오.

API 참조 읽기: 포르투갈 거주지 확인
모든 데이터베이스 검증 보기: 데이터베이스 검증 가격 및 범위
빌드 시작: 무료 Didit 계정 만들기 — 매월 500건의 확인이 무료입니다.