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

# Panamá - Verificación de cédula con Gesichtsabgleich

> Panamá - Cédula mit Gesichtsabgleich (SIB Plus, erhöhte Stufe): autoritative Datenbankabfrage in Panama über Didit. Pay-per-call ab $1.50, ohne Verträge.

Überprüft die panamaische Cédula per biometrischem Gesichtsabgleich über SIB Plus der höheren Stufe. Es handelt sich um dieselbe Datenquelle wie bei der Standardstufe SIB, jedoch mit strengeren biometrischen Schwellenwerten und umfangreicheren Match-Metadaten. Didit stellt diesen Dienst über `POST /v3/database-validation/` bereit, damit Sie die übermittelten Daten mit der maßgeblichen Quelle abgleichen und normalisierte Trefferergebnisse erhalten können.

## Abdeckung

* **Abdeckung:** —
* **Land:** Panama
* **Service-ID:** `pan_cedula_sib_plus`
* **Datenbereich:** Identität
* **Kategorie:** NationalIDRegistry

## Eingaben

| Feld | Pflicht | Beispiel |
| - | -: | - |
| `personal_number` | Ja | `8-123-456` |
| `selfie` | Ja | `@./selfie.jpg` |
| `vendor_data` | Nein | `user-1234` |

* **Pflichteingaben:** `personal_number`, `selfie`
* **Optionale Eingaben:** `vendor_data`
* **Einwilligung:** Nicht erforderlich
* **Verfügbarkeit im Workflow:** Im Workflow verfügbar
* **Abdeckung:** —
* **Preis:** \$1.50 pro erfolgreicher Abfrage

## Body-Parameter

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

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

Beispiel: `PAN`

**services** `string` *required* (default: pan\_cedula\_sib\_plus)

Array, das diese Service-ID enthält. Durch das Festlegen des Dienstes bleibt die Anfrage auf genau diese Datenbank beschränkt.

Beispiel: `pan_cedula_sib_plus`

**personal\_number** `string` *required* (default: 8-123-456)

Länderspezifische persönliche Identitätsnummer.

Beispiel: `8-123-456`

**selfie** `file` *required*

Selfie-Bilddatei, die für die biometrische Datenbankvalidierung hochgeladen wird. Unterstützte Formate: JPEG, PNG oder WebP.

Beispiel: `@./selfie.jpg`

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

Ihre stabile Benutzerreferenz für diese Person, etwa Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen demselben Endbenutzer zuzuordnen und die Zahl falscher Dublettenmeldungen zu verringern.

Beispiel: `user-1234`

## Eingaberegeln und Validierungshinweise

* Panamaische Cédula (mindestens 5 Zeichen)
* `personal_number` muss 5 bis 20 Zeichen lang sein.
* `personal_number` muss Großbuchstaben verwenden.
* `personal_number` muss dem Muster `(?:\d{1,2}(?:-?(?:AV|PI))?|PE|E|N)[\d-]*` entsprechen.

## So rufen Sie es 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=PAN" \
  -F "services=pan_cedula_sib_plus" \
  -F "vendor_data=user-1234" \
  -F "personal_number=8-123-456" \
  -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="PAN",
    services=["pan_cedula_sib_plus"],
    personal_number="8-123-456",
    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: "PAN",
  services: ["pan_cedula_sib_plus"],
  personal_number: "8-123-456",
  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:   "PAN",
	Services:       didit.Some([]string{"pan_cedula_sib_plus"}),
	PersonalNumber: didit.String("8-123-456"),
	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("PAN")
        .services(List.of("pan_cedula_sib_plus"))
        .personalNumber("8-123-456")
        .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' => 'PAN',
    'services' => ['pan_cedula_sib_plus'],
    'personal_number' => '8-123-456',
    '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: "PAN",
  services: ["pan_cedula_sib_plus"],
  personal_number: "8-123-456",
  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 = "PAN",
    Services = new string[] { "pan_cedula_sib_plus" },
    PersonalNumber = "8-123-456",
    VendorData = "user-1234",
    Selfie = FileUpload.FromPath("selfie.jpg"),
});
Console.WriteLine(JsonSerializer.Serialize(result));
```

Jeder erfolgreiche Aufruf liefert HTTP `200`. Das Feld **`outcome_code`** zeigt an, was tatsächlich passiert ist. Es unterscheidet zum Beispiel eine echte biometrische Nichtübereinstimmung (`BIOMETRIC_NO_MATCH`) von einem Selfie, das nicht gelesen werden konnte (`BIOMETRIC_IMAGE_UNUSABLE`). Der angezeigte `status` ist der Standardstatus der Funktion. Ihre konfigurierten [Aktionen für Partial Match / No Match](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": "PAN",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "pan_cedula_sib_plus",
      "service_name": "Panama - Cédula with biometric face-match (SIB Plus, elevated tier)",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "expiration_date": "1990-01-01",
        "full_name": "John Doe",
        "gender": "M",
        "identification_number": "SAMPLE-ID-12345",
        "issue_date": "1990-01-01",
        "last_name": "Doe",
        "place_of_birth": "sample_value",
        "signature": "sample_value"
      },
      "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": "PAN",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "pan_cedula_sib_plus",
      "service_name": "Panama - Cédula with biometric face-match (SIB Plus, elevated tier)",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}
```

**`BIOMETRIC_NO_MATCH`**: Der Übereinstimmungswert des Gesichtsabgleichs lag unter dem Akzeptanzschwellenwert: Das Selfie zeigt nicht dieselbe Person wie das Registerfoto.

```json 200 OK — BIOMETRIC_NO_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "PAN",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "BIOMETRIC_NO_MATCH",
      "service_id": "pan_cedula_sib_plus",
      "service_name": "Panama - Cédula with biometric face-match (SIB Plus, elevated tier)",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}
```

**`BIOMETRIC_IMAGE_UNUSABLE`**: Das Selfie konnte nicht verarbeitet werden (leer, kein Gesicht, geringe Qualität oder das Register konnte es nicht lesen). Fordern Sie den Benutzer auf, das Selfie neu aufzunehmen.

```json 200 OK — BIOMETRIC_IMAGE_UNUSABLE theme={null}
{
  "request_id": "req_01H…",
  "status": "In Review",
  "issuing_state": "PAN",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "BIOMETRIC_IMAGE_UNUSABLE",
      "service_id": "pan_cedula_sib_plus",
      "service_name": "Panama - Cédula with biometric face-match (SIB Plus, elevated tier)",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}
```

**`DECEASED`**: Die Identität stimmt überein, das Register kennzeichnet die Person jedoch als verstorben.

```json 200 OK — DECEASED theme={null}
{
  "request_id": "req_01H…",
  "status": "In Review",
  "issuing_state": "PAN",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "DECEASED",
      "service_id": "pan_cedula_sib_plus",
      "service_name": "Panama - Cédula with biometric face-match (SIB Plus, elevated tier)",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "expiration_date": "1990-01-01",
        "full_name": "John Doe",
        "gender": "M",
        "identification_number": "SAMPLE-ID-12345",
        "issue_date": "1990-01-01",
        "last_name": "Doe",
        "place_of_birth": "sample_value",
        "signature": "sample_value"
      },
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}
```

## Zurückgegebene Daten

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

* `date_of_birth`
* `expiration_date`
* `full_name`
* `gender`
* `identification_number`
* `issue_date`
* `last_name`
* `place_of_birth`
* `signature`

## Preise und SLAs

Panama, Cédula mit biometrischem Gesichtsabgleich (SIB Plus, höhere Stufe): Abfragen werden nur berechnet, wenn Didit ein eindeutiges Ergebnis von der Validierungsquelle erhält.

* **Preis pro Abfrage:** \$1.50 USD.
* **Abrechnung:** pro erfolgreicher Abfrage. Ihnen werden keine Kosten 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 Seiten von Didit. Die Verfügbarkeit der nachgelagerten Quelle variiert je nach Land und Datensatz.

## Weiterlesen

* [Übersicht über die Datenbankvalidierung für Panama](https://docs.didit.me/api-reference/database-validation/panama.md)
* [Übersicht über die 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.