> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # 미국 금융 서비스 데이터베이스 검증 API > Didit를 통한 미국 공인 데이터베이스 조회. 건당 $0.20부터 종량제이며, 계약이나 최소 사용량이 없습니다. 정부 및 공공 기록, 신원 조회 기록 및 기타 서비스를 통합한 서비스입니다. Didit는 이 서비스를 `POST /v3/database-validation/`로 제공하여 제출된 데이터를 신뢰할 수 있는 원본 출처와 대조하고 정규화된 일치 결과를 받을 수 있게 합니다. ## 적용 범위 * **적용 범위:** \~ 85% * **국가:** 미국 * **서비스 ID:** `usa_states_financial_services` * **데이터 영역:** 금융 * **카테고리:** 금융 서비스 ## 입력 항목 | 필드 | 필수 여부 | 예시 | | - | -: | - | | `first_name` | 예 | `John` | | `last_name` | 예 | `Doe` | | `date_of_birth` | 예 | `1990-01-01` | | `address.street_1` | 아니요 | `123 Sample Street` | | `address.street_2` | 아니요 | `Unit 4` | | `address.city` | 아니요 | `Sample City` | | `address.region` | 아니요 | `Sample State` | | `address.postal_code` | 아니요 | `10001` | | `phone` | 아니요 | `+15550101000` | | `ssn` | 아니요 | `123456789` | | `email` | 아니요 | `john.doe@example.com` | | `vendor_data` | 아니요 | `user-1234` | * **필수 입력:** `first_name`, `last_name`, `date_of_birth` * **선택 입력:** `address.street_1`, `address.street_2`, `address.city`, `address.region`, `address.postal_code`, `phone`, `ssn`, `email`, `vendor_data` * **동의:** 필요하지 않습니다 * **워크플로 사용 가능 여부:** 워크플로에서 사용할 수 있습니다 * **적용 범위:** \~ 85% * **가격:** 성공한 조회 건당 \$0.20 ## 본문 파라미터 **issuing\_state** `string` *required* (default: USA) 이 데이터베이스 서비스에 사용하는 ISO 3166-1 alpha-3 국가 코드입니다. 예시: `USA` **services** `string` *required* (default: usa\_states\_financial\_services) 이 서비스 ID를 포함하는 배열입니다. 서비스를 고정하면 요청이 이 정확한 데이터베이스로 한정됩니다. 예시: `usa_states_financial_services` **first\_name** `string` *required* (default: John) 검증할 이름입니다. 예시: `John` **last\_name** `string` *required* (default: Doe) 검증할 성입니다. 예시: `Doe` **date\_of\_birth** `string` *required* (default: 1990-01-01) `YYYY-MM-DD` 형식의 생년월일입니다. 예시: `1990-01-01` **address** `object` 구조화된 거주 주소 객체입니다. `street_1`, `street_2`, `city`, `region`, `postal_code`, `country`를 사용합니다. 완전한 레거시 주소 문자열도 여전히 허용되지만 권장하지 않습니다. 예시: `{"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}` **phone** `string` 국제 형식의 전화번호입니다. 예시: `+15550101000` **ssn** `string` 이 데이터베이스 서비스에 필요한 `ssn` 값입니다. 예시: `123456789` **email** `string` 이메일 주소입니다. 예시: `john.doe@example.com` **vendor\_data** `string` (default: user-1234) 이 사용자를 나타내는 고정된 사용자 참조값으로, 예를 들어 내부 사용자 ID입니다. Didit는 이 값을 사용해 단독으로 수행된 검사를 같은 최종 사용자와 연결하고 중복 감지 노이즈를 줄입니다. 예시: `user-1234` ## 입력 규칙 및 검증 참고 사항 * 이 서비스에서 `address`는 선택 사항입니다. 전체 주소를 하나의 `address` 문자열로 보내면 Didit가 가능한 경우 구조화된 주소 요소로 나누며, 구조화된 필드를 명시적으로 보낼 수도 있습니다. * 미국 사회보장번호(SSN) 또는 ITIN은 전체 9자리(하이픈 생략 가능) 또는 마지막 4자리만 사용할 수 있습니다. * `ssn`은 `(?:\d{9}|\d{3}-\d{2}-\d{4}|\d{4})` 형식과 일치해야 합니다. * `ssn`에는 전체 9자리 SSN/ITIN(하이픈 생략 가능) 또는 마지막 4자리만 보내십시오. * 이 서비스는 `first_name`, `last_name`, `date_of_birth`를 필수로 요구하며, 이는 원본 소스가 요구하는 최소 조건인 이름과 추가 신원 필드 1개를 이미 충족합니다. 선택 필드(`ssn`, `address`, `phone`, `email`)를 사용하면 일치 가능성이 더 높아집니다. * 주소 기반 서비스의 경우 가능하면 단일 `address` 문자열 대신 구조화된 주소 필드를 보내십시오. * `address.street_1`은 번지수와 도로 유형을 포함한 도로 주소입니다. * `address.street_2`는 아파트, 호수, 건물, 층 또는 추가 주소 줄입니다. 해당 정보가 있을 때만 보내십시오. * `address.city`는 도시, 교외 지역, 구, 행정 구역 또는 동네입니다. * `address.region`은 주(state), 도, 지역 또는 읍·면입니다. * `address.postal_code`는 우편번호입니다. * 주소 기반 데이터베이스 서비스는 최소한 도로 주소와 우편번호가 필요합니다. 원본 소스 조회 전에 거부된 요청은 과금되지 않습니다. ## 호출 방법 ```bash cURL theme={null} curl -X POST "https://verification.didit.me/v3/database-validation/" \ -H "x-api-key: YOUR_API_KEY" \ -F "issuing_state=USA" \ -F "services=usa_states_financial_services" \ -F "vendor_data=user-1234" \ -F "first_name=John" \ -F "last_name=Doe" \ -F "date_of_birth=1990-01-01" ``` ```python Python theme={null} from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.database_validation.validate( issuing_state="USA", services=["usa_states_financial_services"], first_name="John", last_name="Doe", date_of_birth="1990-01-01", vendor_data="user-1234", ) print(result) ``` ```javascript Node.js theme={null} import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.databaseValidation.validate({ issuing_state: "USA", services: ["usa_states_financial_services"], first_name: "John", last_name: "Doe", date_of_birth: "1990-01-01", vendor_data: "user-1234", }); console.log(result); ``` ```go Go theme={null} ctx := context.Background() // Reads DIDIT_API_KEY. client := didit.NewClient() result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{ IssuingState: "USA", Services: didit.Some([]string{"usa_states_financial_services"}), FirstName: didit.String("John"), LastName: didit.String("Doe"), DateOfBirth: didit.String("1990-01-01"), VendorData: didit.String("user-1234"), }) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", result) ``` ```java Java theme={null} import java.time.LocalDate; import java.util.List; import me.didit.Didit; import me.didit.types.DatabaseValidationValidateParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder() .issuingState("USA") .services(List.of("usa_states_financial_services")) .firstName("John") .lastName("Doe") .dateOfBirth(LocalDate.parse("1990-01-01")) .vendorData("user-1234") .build()); System.out.println(result); ``` ```php PHP theme={null} databaseValidation->validate([ 'issuing_state' => 'USA', 'services' => ['usa_states_financial_services'], 'first_name' => 'John', 'last_name' => 'Doe', 'date_of_birth' => '1990-01-01', 'vendor_data' => 'user-1234', ]); print_r($result->toArray()); ``` ```ruby Ruby theme={null} require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.database_validation.validate( issuing_state: "USA", services: ["usa_states_financial_services"], first_name: "John", last_name: "Doe", date_of_birth: "1990-01-01", vendor_data: "user-1234" ) puts result.to_h ``` ```csharp .NET theme={null} using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams { IssuingState = "USA", Services = new string[] { "usa_states_financial_services" }, FirstName = "John", LastName = "Doe", DateOfBirth = "1990-01-01", VendorData = "user-1234", }); Console.WriteLine(JsonSerializer.Serialize(result)); ``` 성공한 호출은 모두 HTTP `200`을 반환합니다. **`outcome_code`** 필드는 실제로 어떤 일이 있었는지 알려 줍니다. 예를 들어 실제 생체 인식 불일치(`BIOMETRIC_NO_MATCH`)와 판독할 수 없었던 셀피(`BIOMETRIC_IMAGE_UNUSABLE`)를 구분합니다. 표시된 `status`는 기본 기능 상태이며, 구성한 [부분 일치 / 불일치 작업](https://docs.didit.me/ko/core-technology/database-validation/database-validation-warnings.md)에 따라 재정의될 수 있습니다. **`MATCH`** — 레지스트리에서 신원을 확인했으며, 확인된 모든 필드가 일치했습니다. ```json 200 OK — MATCH theme={null} { "request_id": "req_01H…", "status": "Approved", "issuing_state": "USA", "match_type": "full_match", "validations": [ { "outcome_code": "MATCH", "service_id": "usa_states_financial_services", "service_name": "United States of America - United States Financial Services", "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", "state": "Sample State", "street": "sample_value", "verifications": { "date_of_birth": true, "full_name": true } }, "validation": { "date_of_birth": "full_match", "full_name": "full_match" } } ] } ``` **`PARTIAL_MATCH`** — 이 서비스가 비교하는 필드 중 하나 이상이 완전히 일치하지 않았습니다. 이 예시에서는 `full_name`이 일치하지 않았지만 `date_of_birth`는 일치했습니다. ```json 200 OK — PARTIAL_MATCH theme={null} { "request_id": "req_01H…", "status": "In Review", "issuing_state": "USA", "match_type": "partial_match", "validations": [ { "outcome_code": "PARTIAL_MATCH", "service_id": "usa_states_financial_services", "service_name": "United States of America - United States Financial Services", "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", "state": "Sample State", "street": "sample_value", "verifications": { "date_of_birth": true, "full_name": false } }, "validation": { "date_of_birth": "full_match", "full_name": "no_match" } } ] } ``` **`NO_MATCH`** — 제출된 데이터에 대해 레지스트리에서 일치하는 결과가 반환되지 않았습니다. ```json 200 OK — NO_MATCH theme={null} { "request_id": "req_01H…", "status": "Declined", "issuing_state": "USA", "match_type": "no_match", "validations": [ { "outcome_code": "NO_MATCH", "service_id": "usa_states_financial_services", "service_name": "United States of America - United States Financial Services", "source_data": { "date_of_birth": "NO_MATCH", "full_name": "NO_MATCH" }, "validation": { "date_of_birth": "no_match", "full_name": "no_match" } } ] } ``` ## 반환 데이터 `source_data`에 노출되는 정확한 필드는 레지스트리가 반환하는 내용에 따라 달라집니다. `usa_states_financial_services`에 대해 생성된 예시는 현재 다음과 같은 정규화된 구조를 문서화하고 있습니다: * `address` * `address_match_score` * `city` * `date_of_birth` * `first_name` * `full_name` * `last_name` * `name_match_score` * `postal_code` * `state` * `street` ## 요금 및 SLA 미국 금융 서비스(United States Financial Services) 조회는 Didit이 검증 소스로부터 확정적인 결과를 받은 경우에만 과금됩니다. * **호출당 가격:** \$0.20 USD * **과금:** 성공한 조회 건당 과금됩니다. 레지스트리에 연결할 수 없는 경우, 필수 필드가 누락된 경우, 또는 요청이 소스에 도달하기 전에 거부된 경우에는 요금이 청구되지 않습니다. * **지연 시간:** 일반적인 p95 \< 2 s * **가용성:** Didit 측 기준 분기당 99.9%입니다. 하위 데이터 소스의 가용성은 국가와 데이터셋에 따라 다릅니다. ## 계속 읽기 * [미국 데이터베이스 검증 개요](https://docs.didit.me/api-reference/database-validation/united-states.md) * [데이터베이스 검증 개요](https://docs.didit.me/ko/core-technology/database-validation/overview.md) * [결과 코드](https://docs.didit.me/ko/core-technology/database-validation/database-validation-outcome-codes.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.