뉴질랜드 거주자 확인 API (KO-1)

뉴질랜드에서 사용자를 온보딩한다는 것은 그들이 주장하는 사람과 동일한지 확인하는 것을 의미합니다. 뉴질랜드 거주자 신원 데이터를 권한 기반 기록과 대조하여 확인합니다. 문서나 입력된 세부 정보는 데이터가 존재한다는 것만 증명할 뿐, 그것이 진짜인지 또는 당신 앞에 있는 사람의 것인지는 증명하지 못합니다. 뉴질랜드 거주자 확인은 신뢰할 수 있는 거주 및 소비자 데이터 소스와 데이터를 대조하여 이러한 격차를 해소합니다. 이 가이드는 검사가 무엇을 하는지, 정확한 기술적 세부 정보, 그리고 몇 분 안에 통합하는 방법을 설명합니다.

주요 내용:

• 무엇을 확인하는가 — 뉴질랜드 거주자 확인은 주소 및 거주 데이터를 신뢰할 수 있는 거주 및 소비자 데이터 소스와 대조하여 확인합니다.
• 무엇을 얻는가 — 정규화된 match_type과 승인/검토/거부 로직으로 바로 라우팅할 수 있는 필드 수준 결과를 얻습니다.
• 왜 중요한가 — 신뢰할 수 있는 데이터에 대한 주소 확인은 신청자가 실제로 주장하는 주소에 거주하는지 확인합니다. 이는 핵심적인 사기 방지 및 규정 준수 신호입니다.
• 사용 방법 — Didit의 데이터베이스 유효성 검사 엔드포인트에 POST 한 번 또는 노코드 워크플로 모듈을 사용합니다. 확정적인 쿼리당 $0.93이며, 몇 초 안에 결과를 얻습니다.

뉴질랜드 거주자 확인은 무엇을 검증하는가

뉴질랜드 거주자 신원 데이터를 권한 기반 기록과 대조하여 확인합니다. Didit은 단일 엔드포인트를 통해 이를 노출하므로 제출된 데이터를 신뢰할 수 있는 거주 및 소비자 데이터 소스와 대조하여 확인하고, 직접 파싱할 필요 없는 구조화되고 정규화된 결과를 받을 수 있습니다.

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

왜 중요한가

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

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

기술적 세부 정보

Didit은 통합 데이터베이스 유효성 검사 엔드포인트를 통해 이 서비스를 노출합니다. 단일 POST이며, SDK가 필요 없습니다.

엔드포인트

POST /v3/database-validation/

요청 매개변수

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

예시 요청

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=NZL" \
  -F "services=nzl_zealand_residential" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01"

예시 응답 (확정적 일치)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "NZL",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "nzl_zealand_residential",
      "service_name": "New Zealand Residential",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "full_name": "John Doe",
        "last_name": "Doe",
        "name_match_score": "1.000",
        "verifications": {
          "date_of_birth": true,
          "full_name": true
        }
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "full_match"
      }
    }
  ]
}

성능 및 요금

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

사용 사례

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

Didit과 통합하는 방법

뉴질랜드 거주자 확인은 두 가지 방법으로 실행할 수 있습니다.

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

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

자주 묻는 질문

뉴질랜드 거주자 확인은 무엇을 확인하나요?

제출된 데이터를 신뢰할 수 있는 거주 및 소비자 데이터 소스와 대조하여 확인하고 정규화된 일치 결과를 반환합니다. 따라서 주소 및 거주 데이터가 신뢰할 수 있는 소스에 존재하는지, 어떤 필드가 일치하는지 알 수 있습니다.

소스가 일시적으로 사용할 수 없는 경우 어떻게 되나요?

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

확인 속도는 얼마나 빠릅니까?

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

SDK가 필요합니까?

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

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

오늘 뉴질랜드 주소 및 거주 데이터를 처음으로 확인하십시오.

• API 참조 읽기: 뉴질랜드 거주자 확인
• 모든 데이터베이스 유효성 검사 보기: 데이터베이스 유효성 검사 가격 및 범위
• 시작하기: 무료 Didit 계정 만들기 — 매월 500회 무료 확인.