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

# Südafrika DHA-Fingerprint-Abgleich API: ID-Abgleich

> DHA-Fingerprint-Abgleich für Südafrika über Didit: maßgebliche Datenbankprüfung. Pro Aufruf ab $1.28, ohne Vertrag, ohne Mindestabnahme.

Prüft die übermittelten Fingerabdruckbilder gegen das Fingerabdruckregister des Department of Home Affairs. Didit stellt diesen Dienst über `POST /v3/database-validation/` bereit, damit Sie die übermittelten Daten mit der maßgeblichen Quelle abgleichen und normalisierte Ergebnisse erhalten.

## Abdeckung

* **Abdeckung:** —
* **Land:** Südafrika
* **Dienst-ID:** `zaf_dha_fingerprint_match`
* **Datenbereich:** Biometrie
* **Kategorie:** Behörde

## Eingaben

| Feld | Erforderlich | Beispiel |
| - | -: | - |
| `national_id` | Ja | `SAMPLE-NID-12345` |
| `right_thumb` | Ja | `RIGHT_THUMB_TEMPLATE` |
| `left_thumb` | Ja | `LEFT_THUMB_TEMPLATE` |
| `vendor_data` | Nein | `user-1234` |

* **Erforderliche Eingaben:** `national_id`, `right_thumb`, `left_thumb`
* **Optionale Eingaben:** `vendor_data`
* **Einwilligung:** Erforderlich
* **Verfügbarkeit im Workflow:** Nur über die eigenständige API
* **Abdeckung:** —
* **Preis:** \$1.28 pro erfolgreicher Abfrage

Dieser Dienst fordert `right_thumb` und `left_thumb` an. Diese Werte werden von keinem Workflow-Schritt erzeugt. Deshalb ist der Dienst nur über die eigenständige API verfügbar, bei der Sie die Werte direkt übergeben.

## Body-Parameter

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

ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.

Beispiel: `ZAF`

**services** `string` *required* (default: zaf\_dha\_fingerprint\_match)

Array mit dieser Dienst-ID. Wenn Sie den Dienst festlegen, bleibt die Anfrage auf genau diese Datenbank beschränkt.

Beispiel: `zaf_dha_fingerprint_match`

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

Ausdrückliche Einwilligung des Endbenutzers für diesen Dienst.

Beispiel: `true`

**national\_id** `string` *required* (default: SAMPLE-NID-12345)

Nationale Identitätsnummer für diesen Dienst.

Beispiel: `SAMPLE-NID-12345`

**right\_thumb** `string` *required* (default: RIGHT\_THUMB\_TEMPLATE)

Vom Datenbankdienst erforderter Wert für `right_thumb`.

Beispiel: `RIGHT_THUMB_TEMPLATE`

**left\_thumb** `string` *required* (default: LEFT\_THUMB\_TEMPLATE)

Vom Datenbankdienst erforderter Wert für `left_thumb`.

Beispiel: `LEFT_THUMB_TEMPLATE`

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

Ihre stabile Benutzerreferenz für diese Person, zum Beispiel Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen demselben Endbenutzer zuzuordnen und unnötige Duplikatmeldungen zu verringern.

Beispiel: `user-1234`

## Eingaberegeln und Validierungshinweise

* Senden Sie die oben aufgeführten Felder genau so, wie sie vom Benutzer oder aus dem Dokument erfasst wurden.
* Didit prüft Pflichtfelder, bevor die Datenbank aufgerufen wird. Anfragen, die vor der Quellenabfrage abgelehnt werden, werden nicht berechnet.

## So rufen Sie den Dienst auf

```bash cURL theme={null}
curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_dha_fingerprint_match" \
  -F "vendor_data=user-1234" \
  -F "consent=true" \
  -F "national_id=SAMPLE-NID-12345" \
  -F "right_thumb=RIGHT_THUMB_TEMPLATE" \
  -F "left_thumb=LEFT_THUMB_TEMPLATE"
```

Jeder erfolgreiche Aufruf gibt HTTP `200` zurück. Das Feld **`outcome_code`** zeigt, was tatsächlich passiert ist. So lässt sich zum Beispiel eine echte biometrische Nichtübereinstimmung (`BIOMETRIC_NO_MATCH`) von einem Selfie unterscheiden, das nicht gelesen werden konnte (`BIOMETRIC_IMAGE_UNUSABLE`). Der angezeigte `status` ist der Standardstatus der Funktion. Ihre konfigurierten [Aktionen für Teilübereinstimmung / Keine Übereinstimmung](https://docs.didit.me/de/core-technology/database-validation/database-validation-warnings.md) können ihn überschreiben.

**`MATCH`**: Das Register hat die Identität bestätigt, und alle geprüften Felder stimmen überein.

```json 200 OK — MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_dha_fingerprint_match",
      "service_name": "South Africa - DHA Fingerprint Match",
      "source_data": {
        "identification_number": "SAMPLE-ID-12345"
      },
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}
```

**`NO_MATCH`**: Das Register hat für die übermittelten Daten keine Übereinstimmung zurückgegeben.

```json 200 OK — NO_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_dha_fingerprint_match",
      "service_name": "South Africa - DHA Fingerprint Match",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}
```

## Zurückgegebene Daten

Welche genauen Felder in `source_data` erscheinen, hängt davon ab, was das Register zurückgibt. Das generierte Beispiel für `zaf_dha_fingerprint_match` dokumentiert derzeit folgende normalisierte Struktur:

* `identification_number`

## Preise & SLAs

Abfragen von DHA Fingerprint Match in Südafrika werden nur berechnet, wenn Didit ein eindeutiges Ergebnis von der Validierungsquelle erhält.

* **Preis pro Aufruf:** \$1.28 USD.
* **Abrechnung:** pro erfolgreicher Abfrage. Ihnen wird nichts berechnet, wenn das Register nicht erreichbar ist, wenn Pflichtfelder fehlen oder wenn die Anfrage abgelehnt wird, bevor sie die Quelle erreicht.
* **Latenz:** typischerweise p95 \< 2 s.
* **Verfügbarkeit:** 99.9% pro Quartal auf der Seite von Didit. Die Verfügbarkeit der nachgelagerten Quellen variiert je nach Land und Datensatz.

## Weiterlesen

* [Übersicht zur Datenbankvalidierung für Südafrika](https://docs.didit.me/api-reference/database-validation/south-africa.md)
* [Übersicht zur Datenbankvalidierung](https://docs.didit.me/de/core-technology/database-validation/overview.md)
* [Ergebniscodes](https://docs.didit.me/de/core-technology/database-validation/database-validation-outcome-codes.md)


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