> ## 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. # 브라질 사망 여부 조회(CPF) API: 실시간 신원 조회 > Didit의 신원 인프라로 브라질 공신력 있는 데이터베이스를 검증하는 사망 여부 확인(CPF) 기능입니다. 호출당 $0.20부터, 계약과 최소 금액이 없습니다. CPF 소지자가 사망자로 기록되어 있는지 확인하고, 소지자의 이름과 생년월일을 Receita Federal 기록과 비교합니다. Didit은 이 서비스를 `POST /v3/database-validation/`을 통해 제공하므로, 제출한 데이터를 공식 출처와 대조하고 정규화된 일치 결과를 받을 수 있습니다. ## 적용 범위 * **적용 범위:** \~ 100% * **국가:** 브라질 * **서비스 ID:** `bra_death_check` * **데이터 도메인:** 기타 * **카테고리:** DeathRecord ## 입력 | 필드 | 필수 여부 | 예시 | | - | -: | - | | `tax_number` | 예 | `12345678909` | | `first_name` | 예 | `John` | | `last_name` | 예 | `Doe` | | `date_of_birth` | 아니요 | `1990-01-01` | | `vendor_data` | 아니요 | `user-1234` | * **필수 입력:** `tax_number`, `first_name`, `last_name` * **선택 입력:** `date_of_birth`, `vendor_data` * **동의:** 필요하지 않음 * **워크플로 사용 가능 여부:** 워크플로에서 사용 가능 * **적용 범위:** \~ 100% * **가격:** 성공한 쿼리당 \$0.20 ## 본문 파라미터 **issuing\_state** `string` *required* (default: BRA) 이 데이터베이스 서비스의 ISO 3166-1 alpha-3 국가 코드입니다. 예시: `BRA` **services** `string` *required* (default: bra\_death\_check) 이 서비스 ID를 포함하는 배열입니다. 서비스를 고정하면 요청이 이 정확한 데이터베이스로만 범위가 지정됩니다. 예시: `bra_death_check` **tax\_number** `string` *required* (default: 12345678909) 납세 또는 재정 식별 번호입니다. 예시: `12345678909` **first\_name** `string` *required* (default: John) 검증할 이름입니다. 예시: `John` **last\_name** `string` *required* (default: Doe) 검증할 성입니다. 예시: `Doe` **date\_of\_birth** `string` (default: 1990-01-01) `YYYY-MM-DD` 형식의 생년월일입니다. 예시: `1990-01-01` **vendor\_data** `string` (default: user-1234) 이 사람을 나타내는 고정된 사용자 참조 값입니다(예: 내부 사용자 ID). Didit은 이 값을 사용해 독립형 검사를 같은 최종 사용자에게 연결하고 중복 감지 노이즈를 줄입니다. 예시: `user-1234` ## 입력 규칙 및 검증 참고 사항 * 브라질 CPF(정확히 11자리 숫자) * `tax_number`는 숫자만 포함해야 합니다. 요청을 보내기 전에 공백, 하이픈, 구두점을 제거하십시오. * `tax_number`는 정확히 11자여야 합니다. * `tax_number`는 `\d{3}\.?\d{3}\.?\d{3}-?\d{2}` 패턴과 일치해야 합니다. ## 호출 방법 ```bash cURL theme={null} curl -X POST "https://verification.didit.me/v3/database-validation/" \ -H "x-api-key: YOUR_API_KEY" \ -F "issuing_state=BRA" \ -F "services=bra_death_check" \ -F "vendor_data=user-1234" \ -F "tax_number=12345678909" \ -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="BRA", services=["bra_death_check"], first_name="John", last_name="Doe", date_of_birth="1990-01-01", tax_number="12345678909", 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: "BRA", services: ["bra_death_check"], first_name: "John", last_name: "Doe", date_of_birth: "1990-01-01", tax_number: "12345678909", 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: "BRA", Services: didit.Some([]string{"bra_death_check"}), FirstName: didit.String("John"), LastName: didit.String("Doe"), DateOfBirth: didit.String("1990-01-01"), TaxNumber: didit.String("12345678909"), 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("BRA") .services(List.of("bra_death_check")) .firstName("John") .lastName("Doe") .dateOfBirth(LocalDate.parse("1990-01-01")) .taxNumber("12345678909") .vendorData("user-1234") .build()); System.out.println(result); ``` ```php PHP theme={null} databaseValidation->validate([ 'issuing_state' => 'BRA', 'services' => ['bra_death_check'], 'first_name' => 'John', 'last_name' => 'Doe', 'date_of_birth' => '1990-01-01', 'tax_number' => '12345678909', '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: "BRA", services: ["bra_death_check"], first_name: "John", last_name: "Doe", date_of_birth: "1990-01-01", tax_number: "12345678909", 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 = "BRA", Services = new string[] { "bra_death_check" }, FirstName = "John", LastName = "Doe", DateOfBirth = "1990-01-01", TaxNumber = "12345678909", 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": "BRA", "match_type": "full_match", "validations": [ { "outcome_code": "MATCH", "service_id": "bra_death_check", "service_name": "Brazil - Death Check (CPF)", "source_data": { "date_of_birth": "1990-01-01", "first_name": "JOHN", "full_name": "JOHN DOE", "identification_number": "12345678909", "is_deceased": false, "last_name": "DOE", "tax_id_status": "REGULAR" }, "validation": { "date_of_birth": "full_match", "full_name": "full_match", "identification_number": "full_match" } } ] } ``` **`PARTIAL_MATCH`** — 식별 번호는 찾았지만, 하나 이상의 개인 필드(대개 이름 또는 생년월일)가 완전히 일치하지 않았습니다. ```json 200 OK — PARTIAL_MATCH theme={null} { "request_id": "req_01H…", "status": "In Review", "issuing_state": "BRA", "match_type": "partial_match", "validations": [ { "outcome_code": "PARTIAL_MATCH", "service_id": "bra_death_check", "service_name": "Brazil - Death Check (CPF)", "source_data": { "date_of_birth": "1990-01-01", "first_name": "JOHN", "full_name": "JOHN DOE", "identification_number": "12345678909", "is_deceased": false, "last_name": "DOE", "tax_id_status": "REGULAR" }, "validation": { "date_of_birth": "full_match", "full_name": "no_match", "identification_number": "full_match" } } ] } ``` **`NO_MATCH`** — 제출한 데이터에 대해 레지스트리에서 일치하는 항목이 반환되지 않았습니다. ```json 200 OK — NO_MATCH theme={null} { "request_id": "req_01H…", "status": "Declined", "issuing_state": "BRA", "match_type": "no_match", "validations": [ { "outcome_code": "NO_MATCH", "service_id": "bra_death_check", "service_name": "Brazil - Death Check (CPF)", "source_data": { "date_of_birth": "NO_MATCH", "full_name": "NO_MATCH", "identification_number": "NO_MATCH" }, "validation": { "date_of_birth": "no_match", "full_name": "no_match", "identification_number": "no_match" } } ] } ``` **`DOCUMENT_NOT_FOUND`** — 제출한 문서 번호에 해당하는 레지스트리 레코드가 없습니다. ```json 200 OK — DOCUMENT_NOT_FOUND theme={null} { "request_id": "req_01H…", "status": "Declined", "issuing_state": "BRA", "match_type": "no_match", "validations": [ { "outcome_code": "DOCUMENT_NOT_FOUND", "service_id": "bra_death_check", "service_name": "Brazil - Death Check (CPF)", "source_data": { "date_of_birth": "NO_MATCH", "full_name": "NO_MATCH", "identification_number": "NO_MATCH" }, "validation": { "date_of_birth": "no_match", "full_name": "no_match", "identification_number": "no_match" } } ] } ``` **`DECEASED`** — 신원은 일치했지만, 레지스트리가 해당 사람을 사망자로 표시합니다. ```json 200 OK — DECEASED theme={null} { "request_id": "req_01H…", "status": "In Review", "issuing_state": "BRA", "match_type": "full_match", "validations": [ { "outcome_code": "DECEASED", "service_id": "bra_death_check", "service_name": "Brazil - Death Check (CPF)", "source_data": { "date_of_birth": "1990-01-01", "death_year": 2021, "first_name": "JOHN", "full_name": "JOHN DOE", "identification_number": "12345678909", "is_deceased": true, "last_name": "DOE", "tax_id_status": "TITULAR FALECIDO" }, "validation": { "date_of_birth": "full_match", "full_name": "full_match", "identification_number": "full_match" } } ] } ``` ## 반환 데이터 `source_data`에 노출되는 정확한 필드는 레지스트리가 반환하는 내용에 따라 달라집니다. `bra_death_check`에 대해 생성된 예시는 현재 다음의 정규화된 형식을 문서화합니다: * `date_of_birth` * `death_year` * `first_name` * `full_name` * `identification_number` * `is_deceased` * `last_name` * `tax_id_status` ## 요금 및 SLA 브라질 - 사망 확인(CPF) 쿼리는 Didit이 검증 소스로부터 확정적인 결과를 받은 경우에만 과금됩니다. * **호출당 가격:** 미화 \$0.20 * **과금:** 성공한 쿼리 건당 과금됩니다. 레지스트리에 연결할 수 없는 경우, 필수 필드가 누락된 경우, 또는 요청이 소스에 도달하기 전에 거부된 경우에는 과금되지 않습니다. * **지연 시간:** 일반적인 p95 2초 미만 * **가용성:** Didit 측 기준 분기당 99.9%입니다. 하위 소스의 가용성은 국가와 데이터 세트에 따라 다릅니다. ## 계속 읽기 * [브라질 데이터베이스 검증 개요](https://docs.didit.me/api-reference/database-validation/brazil.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.