> ## 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.

# Pencocokan Wajah CPF Brasil (Datavalid) - API ID Match

> Pencocokan wajah dan pencarian CPF di database resmi Brasil lewat Didit. Bayar per panggilan mulai $0.45, tanpa kontrak, tanpa minimum.

SERPRO Datavalid v4 pf-facial memvalidasi CPF (wajib) terhadap Receita Federal dan mencocokkan swafoto langsung (wajib) dengan potret CNH yang disimpan di Senatran. Secara opsional, layanan ini juga memeriksa nama dan tanggal lahir. Didit menyediakan layanan ini melalui `POST /v3/database-validation/` sehingga Anda dapat memverifikasi data yang dikirim terhadap sumber otoritatif dan menerima hasil pencocokan yang ternormalisasi. Format input: `tax_number` menerima CPF Brasil (tepat 11 digit).

## Cakupan

* **Cakupan:** \~50%
* **Negara:** Brasil
* **ID layanan:** `bra_cpf_facial`
* **Domain data:** Biometrik
* **Kategori:** NationalIDRegistry

Sekitar 50% orang dewasa di Brasil dapat dicocokkan; langkah pencocokan wajah bergantung pada potret CNH yang disimpan di Senatran, sehingga hanya pemegang SIM (CNH) yang dapat dicocokkan.

## Input

| Kolom | Wajib | Contoh |
| - | -: | - |
| `tax_number` | Ya | `11111111111` |
| `selfie` | Ya | `@./selfie.jpg` |
| `first_name` | Tidak | `John` |
| `last_name` | Tidak | `Doe` |
| `date_of_birth` | Tidak | `1990-01-01` |
| `vendor_data` | Tidak | `user-1234` |

* **Input wajib:** `tax_number`, `selfie`
* **Input opsional:** `first_name`, `last_name`, `date_of_birth`, `vendor_data`
* **Persetujuan:** Wajib
* **Ketersediaan alur kerja:** Tersedia dalam alur kerja
* **Cakupan:** \~50%
* **Harga:** \$0.45 per kueri yang berhasil

## Parameter body

**issuing\_state** `string` *required* (default: BRA)

Kode negara ISO 3166-1 alpha-3 untuk layanan basis data ini.

Contoh: `BRA`

**services** `string` *required* (default: bra\_cpf\_facial)

Larik yang berisi ID layanan ini. Menetapkan layanan ini membuat permintaan hanya mengacu pada basis data yang tepat ini.

Contoh: `bra_cpf_facial`

**consent** `boolean` *required* (default: true)

Persetujuan eksplisit dari pengguna akhir untuk layanan ini.

Contoh: `true`

**tax\_number** `string` *required* (default: 11111111111)

Nomor identifikasi pajak atau fiskal.

Contoh: `11111111111`

**selfie** `file` *required*

File gambar swafoto yang diunggah untuk validasi basis data biometrik. Format yang diterima: JPEG, PNG, atau WebP.

Contoh: `@./selfie.jpg`

**first\_name** `string`

Nama depan yang akan divalidasi.

Contoh: `John`

**last\_name** `string`

Nama belakang yang akan divalidasi.

Contoh: `Doe`

**date\_of\_birth** `string`

Tanggal lahir dalam format `YYYY-MM-DD`.

Contoh: `1990-01-01`

**vendor\_data** `string` (default: user-1234)

Referensi pengguna yang stabil untuk orang ini, misalnya ID pengguna internal Anda. Didit menggunakannya untuk menautkan pemeriksaan terpisah ke pengguna akhir yang sama dan mengurangi gangguan dalam deteksi duplikat.

Contoh: `user-1234`

## Aturan input & catatan validasi

* CPF Brasil (tepat 11 digit)
* `tax_number` hanya boleh berisi digit; hapus spasi, tanda hubung, dan tanda baca sebelum mengirim permintaan.
* `tax_number` harus tepat 11 karakter.

## Cara memanggilnya

```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_cpf_facial" \
  -F "vendor_data=user-1234" \
  -F "consent=true" \
  -F "tax_number=11111111111" \
  -F "selfie=@./selfie.jpg"
```

```python Python theme={null}
from didit import Didit

# Reads DIDIT_API_KEY.
client = Didit()

result = client.database_validation.validate(
    issuing_state="BRA",
    services=["bra_cpf_facial"],
    consent=True,
    tax_number="11111111111",
    vendor_data="user-1234",
    selfie=open("selfie.jpg", "rb"),
)
print(result)
```

```javascript Node.js theme={null}
import Didit, { fileFromPath } from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY.
const didit = new Didit();

const result = await didit.databaseValidation.validate({
  issuing_state: "BRA",
  services: ["bra_cpf_facial"],
  consent: true,
  tax_number: "11111111111",
  vendor_data: "user-1234",
  selfie: await fileFromPath("selfie.jpg"),
});
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_cpf_facial"}),
	Consent:      didit.Bool(true),
	TaxNumber:    didit.String("11111111111"),
	VendorData:   didit.String("user-1234"),
	Selfie:       didit.Some(didit.FileFromPath("selfie.jpg")),
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)
```

```java Java theme={null}
import java.nio.file.Path;
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_cpf_facial"))
        .consent(true)
        .taxNumber("11111111111")
        .vendorData("user-1234")
        .selfie(Path.of("selfie.jpg"))
        .build());
System.out.println(result);
```

```php PHP theme={null}
<?php

require 'vendor/autoload.php';

use Didit\DiditClient;
use Didit\File;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->databaseValidation->validate([
    'issuing_state' => 'BRA',
    'services' => ['bra_cpf_facial'],
    'consent' => true,
    'tax_number' => '11111111111',
    'vendor_data' => 'user-1234',
    'selfie' => File::fromPath('selfie.jpg'),
]);
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_cpf_facial"],
  consent: true,
  tax_number: "11111111111",
  vendor_data: "user-1234",
  selfie: Pathname("selfie.jpg")
)
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_cpf_facial" },
    Consent = true,
    TaxNumber = "11111111111",
    VendorData = "user-1234",
    Selfie = FileUpload.FromPath("selfie.jpg"),
});
Console.WriteLine(JsonSerializer.Serialize(result));
```

Setiap panggilan yang berhasil mengembalikan HTTP `200`. Kolom **`outcome_code`** memberi tahu Anda apa yang sebenarnya terjadi, misalnya membedakan ketidakcocokan biometrik yang nyata (`BIOMETRIC_NO_MATCH`) dari swafoto yang tidak dapat dibaca (`BIOMETRIC_IMAGE_UNUSABLE`). `status` yang ditampilkan adalah status fitur default; [tindakan Partial Match / No Match](https://docs.didit.me/id/core-technology/database-validation/database-validation-warnings.md) yang Anda konfigurasi dapat menggantinya.

**`MATCH`**: Registri mengonfirmasi identitas dan setiap kolom yang diperiksa cocok.

```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_cpf_facial",
      "service_name": "Brazil - CPF + face match (Datavalid)",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "face_match_probability": "Altíssima probabilidade",
        "face_match_score": "0.990",
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "name_match_score": "1.000",
        "verifications": {
          "identification_number": true
        }
      },
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}
```

**`NO_MATCH`**: Registri tidak menemukan kecocokan untuk data yang dikirim.

```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_cpf_facial",
      "service_name": "Brazil - CPF + face match (Datavalid)",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}
```

**`BIOMETRIC_NO_MATCH`**: Skor pencocokan wajah berada di bawah ambang batas penerimaan, yaitu orang dalam swafoto bukan orang yang sama dengan orang dalam foto di registri.

```json 200 OK — BIOMETRIC_NO_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "BRA",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "BIOMETRIC_NO_MATCH",
      "service_id": "bra_cpf_facial",
      "service_name": "Brazil - CPF + face match (Datavalid)",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}
```

**`BIOMETRIC_IMAGE_UNUSABLE`**: Swafoto tidak dapat diproses (kosong, tidak ada wajah, kualitas rendah, atau registri tidak dapat membacanya). Minta pengguna untuk mengambil ulang swafoto.

```json 200 OK — BIOMETRIC_IMAGE_UNUSABLE theme={null}
{
  "request_id": "req_01H…",
  "status": "In Review",
  "issuing_state": "BRA",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "BIOMETRIC_IMAGE_UNUSABLE",
      "service_id": "bra_cpf_facial",
      "service_name": "Brazil - CPF + face match (Datavalid)",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}
```

**`INCONCLUSIVE`**: Registri mengonfirmasi CPF (serta nama dan tanggal lahir yang Anda kirim), tetapi wajah tidak dapat dibandingkan: tidak ada foto referensi yang tersimpan untuk CPF ini, atau swafoto tidak dapat digunakan (wajah tidak ditemukan, ukuran gambar salah, kualitas rendah, atau lebih dari satu wajah). Kolom yang dikonfirmasi tetap ada di `validation`, sehingga `match_type` mencerminkannya, tetapi pemeriksaan wajah wajib belum terselesaikan, sehingga pemeriksaan dikirim untuk ditinjau. Minta swafoto baru, atau alihkan ke verifikasi dokumen untuk orang yang tidak memiliki foto di arsip.

```json 200 OK — INCONCLUSIVE theme={null}
{
  "request_id": "req_01H…",
  "status": "In Review",
  "issuing_state": "BRA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "INCONCLUSIVE",
      "service_id": "bra_cpf_facial",
      "service_name": "Brazil - CPF + face match (Datavalid)",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "name_match_score": "1.000"
      },
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}
```

## Data yang dikembalikan

Kolom persis yang ditampilkan di `source_data` bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk `bra_cpf_facial` saat ini mendokumentasikan bentuk ternormalisasi berikut:

* `date_of_birth`
* `first_name`
* `identification_number`
* `last_name`
* `name_match_score`

## Harga & SLA

Brasil - kueri CPF + pencocokan wajah (Datavalid) ditagih hanya ketika Didit menerima hasil yang konklusif dari sumber validasi.

* **Harga per panggilan:** \$0.45 USD.
* **Penagihan:** per kueri yang berhasil. Anda tidak dikenakan biaya ketika registri tidak dapat dihubungi, ketika kolom wajib tidak ada, atau ketika permintaan ditolak sebelum mencapai sumber.
* **Latensi:** p95 tipikal \< 2 s.
* **Ketersediaan:** 99.9% per kuartal di sisi Didit; ketersediaan sumber hilir bervariasi menurut negara dan kumpulan data.

## Tentang sumber ini

Ini adalah sumber resmi pemerintah: [SERPRO](https://www.serpro.gov.br) Datavalid, yang dioperasikan oleh layanan pemrosesan data federal Brasil. CPF diperiksa terhadap Receita Federal, dan swafoto dicocokkan dengan potret yang tersimpan untuk orang tersebut di Senatran, registri nasional surat izin mengemudi.

Karena potret berasal dari catatan CNH (surat izin mengemudi), hanya orang yang memiliki CNH yang memiliki data wajah. Hal inilah yang membatasi cakupan hingga sekitar 50% penduduk dewasa: datanya otoritatif, tetapi tidak tersedia bagi setiap warga Brasil yang belum pernah memiliki surat izin mengemudi.

**Butuh cakupan yang lebih luas?** Gunakan [BRA - Unico IDCloud (CPF + selfie)](https://docs.didit.me/id/api-reference/database-validation/brazil/unico-idcloud.md) sebagai gantinya. Layanan ini menjangkau sekitar 96% penduduk dewasa Brasil melalui registri biometrik privat Unico, dan biayanya \$0.20, dibandingkan \$0.45 di sini. Pilih Datavalid jika Anda secara khusus memerlukan registri pemerintah sebagai sumber kebenaran; pilih IDCloud jika Anda perlu memverifikasi semua orang.

## Lanjut membaca

* [Ikhtisar Validasi Database Brasil](https://docs.didit.me/api-reference/database-validation/brazil.md)
* [Ikhtisar Validasi Database](https://docs.didit.me/id/core-technology/database-validation/overview.md)
* [Kode Hasil](https://docs.didit.me/id/core-technology/database-validation/database-validation-outcome-codes.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.