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

# Validasi Database Australia: Sertifikat Perubahan Nama

> API Validasi Database Australia untuk sertifikat perubahan nama melalui Didit. Mulai dari $0.75 per panggilan, tanpa kontrak, tanpa minimum.

Memverifikasi data input terhadap Document Verification Service (DVS). Didit menyediakan layanan ini melalui `POST /v3/database-validation/` agar Anda dapat memverifikasi data yang dikirim terhadap sumber otoritatif dan menerima hasil kecocokan yang sudah dinormalisasi.

## Cakupan

* **Cakupan:** 100%\*
* **Negara:** Australia
* **ID layanan:** `aus_change_of_name_certificate`
* **Domain data:** Identitas
* **Kategori:** CivilRegistry

## Input

| Kolom | Wajib | Contoh |
| - | -: | - |
| `first_name` | Ya | `John` |
| `last_name` | Ya | `Doe` |
| `date_of_birth` | Ya | `1990-01-01` |
| `change_of_name_certificate_number` | Ya | `SAMPLE-CON-12345` |
| `vendor_data` | Tidak | `user-1234` |

* **Input wajib:** `first_name`, `last_name`, `date_of_birth`, `change_of_name_certificate_number`
* **Input opsional:** `vendor_data`
* **Persetujuan:** Wajib
* **Ketersediaan alur kerja:** Tersedia dalam alur kerja dengan pemetaan kolom
* **Cakupan:** 100%\*
* **Harga:** \$0.75 per kueri yang berhasil

Dalam alur kerja, `change_of_name_certificate_number` tidak dicetak pada dokumen identitas, sehingga tidak ada langkah yang menghasilkannya sendiri. Kumpulkan dari jawaban Kuesioner, kolom hasil ekstraksi Document AI, atau nilai yang Anda kirim saat membuat sesi, lalu petakan pada langkah Validasi Database. Sampai dipetakan, editor alur kerja menampilkan layanan ini dalam keadaan nonaktif dan menyebutkan input yang hilang. Saat dijalankan, input yang hilang berarti pemeriksaan dilewati sebelum ada kueri apa pun, sehingga Anda tidak pernah ditagih untuk database yang tidak dapat dikueri.

## Parameter body

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

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

Contoh: `AUS`

**services** `string` *required* (default: aus\_change\_of\_name\_certificate)

Array yang berisi ID layanan ini. Mengunci layanan membuat permintaan hanya mengarah ke database yang tepat ini.

Contoh: `aus_change_of_name_certificate`

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

Persetujuan eksplisit dari pengguna akhir untuk layanan ini.

Contoh: `true`

**first\_name** `string` *required* (default: John)

Nama depan yang akan divalidasi.

Contoh: `John`

**last\_name** `string` *required* (default: Doe)

Nama belakang yang akan divalidasi.

Contoh: `Doe`

**date\_of\_birth** `string` *required* (default: 1990-01-01)

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

Contoh: `1990-01-01`

**change\_of\_name\_certificate\_number** `string` *required* (default: SAMPLE-CON-12345)

Nilai `change_of_name_certificate_number` yang dibutuhkan oleh layanan database ini.

Contoh: `SAMPLE-CON-12345`

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

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

Contoh: `user-1234`

## Aturan input & catatan validasi

* Kirimkan kolom yang tercantum di atas persis seperti yang ditangkap dari pengguna atau dokumen.
* Didit memvalidasi kolom wajib sebelum memanggil database. Permintaan yang ditolak sebelum pencarian ke sumber tidak dikenakan biaya.

## 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=AUS" \
  -F "services=aus_change_of_name_certificate" \
  -F "vendor_data=user-1234" \
  -F "consent=true" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "change_of_name_certificate_number=SAMPLE-CON-12345"
```

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

# Reads DIDIT_API_KEY.
client = Didit()

result = client.database_validation.validate(
    issuing_state="AUS",
    services=["aus_change_of_name_certificate"],
    consent=True,
    first_name="John",
    last_name="Doe",
    date_of_birth="1990-01-01",
    change_of_name_certificate_number="SAMPLE-CON-12345",
    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: "AUS",
  services: ["aus_change_of_name_certificate"],
  consent: true,
  first_name: "John",
  last_name: "Doe",
  date_of_birth: "1990-01-01",
  change_of_name_certificate_number: "SAMPLE-CON-12345",
  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:                  "AUS",
	Services:                      didit.Some([]string{"aus_change_of_name_certificate"}),
	Consent:                       didit.Bool(true),
	FirstName:                     didit.String("John"),
	LastName:                      didit.String("Doe"),
	DateOfBirth:                   didit.String("1990-01-01"),
	ChangeOfNameCertificateNumber: didit.String("SAMPLE-CON-12345"),
	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("AUS")
        .services(List.of("aus_change_of_name_certificate"))
        .consent(true)
        .firstName("John")
        .lastName("Doe")
        .dateOfBirth(LocalDate.parse("1990-01-01"))
        .changeOfNameCertificateNumber("SAMPLE-CON-12345")
        .vendorData("user-1234")
        .build());
System.out.println(result);
```

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

require 'vendor/autoload.php';

use Didit\DiditClient;

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

$result = $didit->databaseValidation->validate([
    'issuing_state' => 'AUS',
    'services' => ['aus_change_of_name_certificate'],
    'consent' => true,
    'first_name' => 'John',
    'last_name' => 'Doe',
    'date_of_birth' => '1990-01-01',
    'change_of_name_certificate_number' => 'SAMPLE-CON-12345',
    '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: "AUS",
  services: ["aus_change_of_name_certificate"],
  consent: true,
  first_name: "John",
  last_name: "Doe",
  date_of_birth: "1990-01-01",
  change_of_name_certificate_number: "SAMPLE-CON-12345",
  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 = "AUS",
    Services = new string[] { "aus_change_of_name_certificate" },
    Consent = true,
    FirstName = "John",
    LastName = "Doe",
    DateOfBirth = "1990-01-01",
    ChangeOfNameCertificateNumber = "SAMPLE-CON-12345",
    VendorData = "user-1234",
});
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 sungguhan (`BIOMETRIC_NO_MATCH`) dari swafoto yang tidak dapat dibaca (`BIOMETRIC_IMAGE_UNUSABLE`). `status` yang ditampilkan adalah status fitur default. [Tindakan Kecocokan Sebagian / Tidak Cocok](https://docs.didit.me/id/core-technology/database-validation/database-validation-warnings.md) yang Anda konfigurasi dapat menimpanya.

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

```json 200 OK — MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "AUS",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "aus_change_of_name_certificate",
      "service_name": "Australia - DVS – Change of Name Certificate",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}
```

**`PARTIAL_MATCH`**: Nomor identifikasi ditemukan, tetapi satu atau lebih kolom pribadi (biasanya nama atau tanggal lahir) tidak sepenuhnya cocok.

```json 200 OK — PARTIAL_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "In Review",
  "issuing_state": "AUS",
  "match_type": "partial_match",
  "validations": [
    {
      "outcome_code": "PARTIAL_MATCH",
      "service_id": "aus_change_of_name_certificate",
      "service_name": "Australia - DVS – Change of Name Certificate",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "no_match",
        "identification_number": "full_match"
      }
    }
  ]
}
```

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

```json 200 OK — NO_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "AUS",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "aus_change_of_name_certificate",
      "service_name": "Australia - DVS – Change of Name Certificate",
      "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"
      }
    }
  ]
}
```

## Data yang dikembalikan

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

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

## Harga & SLA

Kueri Australia - DVS – Sertifikat Perubahan Nama hanya ditagih ketika Didit menerima hasil yang pasti dari sumber validasi.

* **Harga per panggilan:** \$0.75 USD.
* **Penagihan:** per kueri yang berhasil. Anda tidak dikenakan biaya ketika registri tidak dapat dijangkau, 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 dataset.

## Lanjutkan membaca

* [Ikhtisar Validasi Database Australia](https://docs.didit.me/api-reference/database-validation/australia.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.