> ## 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 de verificació de crèdit a Austràlia: ID Match

> Oficina de crèdit d'Austràlia: validació de bases de dades fiable amb Didit. Des de $1.17 per crida, sense contractes ni mínims.

Verifica les dades introduïdes amb les dades de la capçalera de crèdit obtingudes de la central de crèdit més gran d'Austràlia. Didit ofereix aquest servei mitjançant `POST /v3/database-validation/` perquè puguis verificar les dades enviades amb la font de referència i rebre resultats de coincidència normalitzats.

## Cobertura

* **Cobertura:** \~ 75%
* **País:** Austràlia
* **ID del servei:** `aus_credit_bureau`
* **Àmbit de dades:** Financer
* **Categoria:** CreditBureau

## Entrades

| Camp | Obligatori | Exemple |
| - | -: | - |
| `first_name` | Sí | `John` |
| `last_name` | Sí | `Doe` |
| `date_of_birth` | Sí | `1990-01-01` |
| `address.street_1` | Sí | `123 Sample Street` |
| `address.postal_code` | Sí | `10001` |
| `address.street_2` | No | `Unit 4` |
| `address.city` | No | `Sample City` |
| `address.region` | No | `Sample State` |
| `phone` | No | `+15550101000` |
| `email` | No | `john.doe@example.com` |
| `vendor_data` | No | `user-1234` |

* **Entrades obligatòries:** `first_name`, `last_name`, `date_of_birth`, `address.street_1`, `address.postal_code`
* **Entrades opcionals:** `address.street_2`, `address.city`, `address.region`, `phone`, `email`, `vendor_data`
* **Consentiment:** Obligatori
* **Disponibilitat al flux de treball:** Disponible al flux de treball
* **Cobertura:** \~ 75%
* **Preu:** \$1.17 per consulta satisfactòria

## Paràmetres del cos

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

Codi de país ISO 3166-1 alpha-3 d'aquest servei de base de dades.

Exemple: `AUS`

**services** `string` *required* (default: aus\_credit\_bureau)

Matriu que conté aquest identificador de servei. Fixar el servei circumscriu la sol·licitud exactament a aquesta base de dades.

Exemple: `aus_credit_bureau`

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

Consentiment explícit de l'usuari final per a aquest servei.

Exemple: `true`

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

Nom de pila a validar.

Exemple: `John`

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

Cognom a validar.

Exemple: `Doe`

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

Data de naixement en format `YYYY-MM-DD`.

Exemple: `1990-01-01`

**address** `object` *required* (default: \{"street\_1":"123 Sample Street","street\_2":"Unit 4","city":"Sample City","region":"Sample State","postal\_code":"10001","country":"US"})

Objecte d'adreça residencial estructurat. Utilitza `street_1`, `street_2`, `city`, `region`, `postal_code` i `country`. Encara s'accepta una cadena d'adreça completa en format antic, però no es recomana.

Exemple: `{"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}`

**phone** `string`

Número de telèfon en format internacional.

Exemple: `+15550101000`

**email** `string`

Adreça de correu electrònic.

Exemple: `john.doe@example.com`

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

La teva referència estable d'usuari per a aquesta persona, com ara el teu ID d'usuari intern. Didit l'utilitza per vincular les comprovacions independents amb el mateix usuari final i reduir el soroll de la detecció de duplicats.

Exemple: `user-1234`

## Regles d'entrada i notes de validació

* Per als serveis basats en adreces, envia camps d'adreça estructurats en lloc d'una sola cadena `address` sempre que sigui possible.
* `address.street_1` és l'adreça del carrer, incloent-hi el número i el tipus de via.
* `address.street_2` és l'apartament, la unitat, l'edifici, la planta o una línia addicional de l'adreça. Envia-la només quan la tinguis.
* `address.city` és la ciutat, el suburbi, el districte, la localitat o el barri.
* `address.region` és l'estat, la província, la regió o la població.
* `address.postal_code` és el codi postal.
* Els serveis de base de dades basats en adreces requereixen com a mínim l'adreça del carrer i el codi postal; les sol·licituds rebutjades abans de la consulta a la font no es cobren.

## Com cridar-lo

```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_credit_bureau" \
  -F "vendor_data=user-1234" \
  -F "consent=true" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01" \
  -F 'address={"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}'
```

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

# Reads DIDIT_API_KEY.
client = Didit()

result = client.database_validation.validate(
    issuing_state="AUS",
    services=["aus_credit_bureau"],
    consent=True,
    first_name="John",
    last_name="Doe",
    date_of_birth="1990-01-01",
    address={"street_1": "123 Sample Street", "street_2": "Unit 4", "city": "Sample City", "region": "Sample State", "postal_code": "10001", "country": "US"},
    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_credit_bureau"],
  consent: true,
  first_name: "John",
  last_name: "Doe",
  date_of_birth: "1990-01-01",
  address: { street_1: "123 Sample Street", street_2: "Unit 4", city: "Sample City", region: "Sample State", postal_code: "10001", country: "US" },
  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_credit_bureau"}),
	Consent:      didit.Bool(true),
	FirstName:    didit.String("John"),
	LastName:     didit.String("Doe"),
	DateOfBirth:  didit.String("1990-01-01"),
	Address:      didit.Some[any](map[string]any{"street_1": "123 Sample Street", "street_2": "Unit 4", "city": "Sample City", "region": "Sample State", "postal_code": "10001", "country": "US"}),
	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_credit_bureau"))
        .consent(true)
        .firstName("John")
        .lastName("Doe")
        .dateOfBirth(LocalDate.parse("1990-01-01"))
        .address(DatabaseValidationValidateParams.Address.ofVariant1(DatabaseValidationValidateParams.Address.Variant1.builder()
                .street1("123 Sample Street")
                .street2("Unit 4")
                .city("Sample City")
                .region("Sample State")
                .postalCode("10001")
                .country("US")
                .build()))
        .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_credit_bureau'],
    'consent' => true,
    'first_name' => 'John',
    'last_name' => 'Doe',
    'date_of_birth' => '1990-01-01',
    'address' => ['street_1' => '123 Sample Street', 'street_2' => 'Unit 4', 'city' => 'Sample City', 'region' => 'Sample State', 'postal_code' => '10001', 'country' => 'US'],
    '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_credit_bureau"],
  consent: true,
  first_name: "John",
  last_name: "Doe",
  date_of_birth: "1990-01-01",
  address: { street_1: "123 Sample Street", street_2: "Unit 4", city: "Sample City", region: "Sample State", postal_code: "10001", country: "US" },
  vendor_data: "user-1234"
)
puts result.to_h
```

```csharp .NET theme={null}
using System;
using System.Collections.Generic;
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_credit_bureau" },
    Consent = true,
    FirstName = "John",
    LastName = "Doe",
    DateOfBirth = "1990-01-01",
    Address = new Dictionary<string, object> { ["street_1"] = "123 Sample Street", ["street_2"] = "Unit 4", ["city"] = "Sample City", ["region"] = "Sample State", ["postal_code"] = "10001", ["country"] = "US" },
    VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
```

Cada crida satisfactòria retorna HTTP `200`. El camp **`outcome_code`** indica què ha passat realment, i distingeix, per exemple, una discrepància biomètrica real (`BIOMETRIC_NO_MATCH`) d'un selfie que no s'ha pogut llegir (`BIOMETRIC_IMAGE_UNUSABLE`). L'`status` que es mostra és l'estat predeterminat de la funcionalitat; les teves [accions de Partial Match / No Match](https://docs.didit.me/ca/core-technology/database-validation/database-validation-warnings.md) configurades poden sobreescriure'l.

**`MATCH`**: el registre ha confirmat la identitat i tots els camps verificats han coincidit.

```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_credit_bureau",
      "service_name": "Australia Credit Bureau",
      "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"
      },
      "validation": {
        "address": "full_match",
        "date_of_birth": "full_match",
        "full_name": "full_match"
      }
    }
  ]
}
```

**`PARTIAL_MATCH`**: un o més dels camps que compara aquest servei no han coincidit del tot. En aquest exemple, `full_name` no ha coincidit, mentre que `address` i `date_of_birth` sí.

```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_credit_bureau",
      "service_name": "Australia Credit Bureau",
      "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"
      },
      "validation": {
        "address": "full_match",
        "date_of_birth": "full_match",
        "full_name": "no_match"
      }
    }
  ]
}
```

**`NO_MATCH`**: el registre no ha trobat cap coincidència per a les dades enviades.

```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_credit_bureau",
      "service_name": "Australia Credit Bureau",
      "source_data": {
        "address": "NO_MATCH",
        "date_of_birth": "NO_MATCH",
        "full_name": "NO_MATCH"
      },
      "validation": {
        "address": "no_match",
        "date_of_birth": "no_match",
        "full_name": "no_match"
      }
    }
  ]
}
```

## Dades retornades

Els camps exactes que apareixen a `source_data` depenen del que retorni el registre. L'exemple generat per a `aus_credit_bureau` documenta actualment aquesta estructura normalitzada:

* `address`
* `address_match_score`
* `city`
* `date_of_birth`
* `first_name`
* `full_name`
* `last_name`
* `name_match_score`
* `postal_code`
* `state`
* `street`

## Preus i SLA

Les consultes a Australia Credit Bureau només es facturen quan Didit rep un resultat concloent de la font de validació.

* **Preu per crida:** \$1.17 USD.
* **Facturació:** per consulta satisfactòria. No se't cobra quan el registre no és accessible, quan falten camps obligatoris o quan la sol·licitud es rebutja abans d'arribar a la font.
* **Latència:** p95 típic \< 2 s.
* **Disponibilitat:** 99.9% per trimestre per part de Didit; la disponibilitat de la font de dades varia segons el país i el conjunt de dades.

## Continua llegint

* [Visió general de Validació en bases de dades a Austràlia](https://docs.didit.me/api-reference/database-validation/australia.md)
* [Visió general de Validació en bases de dades](https://docs.didit.me/ca/core-technology/database-validation/overview.md)
* [Codis de resultat](https://docs.didit.me/ca/core-technology/database-validation/database-validation-outcome-codes.md)


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