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"
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)
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);
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)
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
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());
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
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));
{
"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"
}
}
]
}
{
"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"
}
}
]
}
{
"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"
}
}
]
}
{
"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"
}
}
]
}
{
"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"
}
}
]
}
🇵🇦 Panama
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.
POST
/
v3
/
database-validation
/
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"
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)
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);
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)
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
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());
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
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));
{
"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"
}
}
]
}
{
"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"
}
}
]
}
{
"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"
}
}
]
}
{
"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"
}
}
]
}
{
"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"
}
}
]
}
Ü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
string
Standard:"PAN"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel:
PANstring
Standard:"pan_cedula_sib_plus"
erforderlich
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_plusstring
Standard:"8-123-456"
erforderlich
Länderspezifische persönliche Identitätsnummer.Beispiel:
8-123-456file
erforderlich
Selfie-Bilddatei, die für die biometrische Datenbankvalidierung hochgeladen wird. Unterstützte Formate: JPEG, PNG oder WebP.Beispiel:
@./selfie.jpgstring
Standard:"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-1234Eingaberegeln und Validierungshinweise
- Panamaische Cédula (mindestens 5 Zeichen)
personal_numbermuss 5 bis 20 Zeichen lang sein.personal_numbermuss Großbuchstaben verwenden.personal_numbermuss dem Muster(?:\d{1,2}(?:-?(?:AV|PI))?|PE|E|N)[\d-]*entsprechen.
So rufen Sie es auf
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"
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)
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);
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)
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
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());
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
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 können ihn überschreiben.MATCH: Das Register hat die Identität bestätigt, und alle geprüften Felder stimmen überein.{
"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.{
"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.{
"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.{
"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.{
"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 insource_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_birthexpiration_datefull_namegenderidentification_numberissue_datelast_nameplace_of_birthsignature
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
Zuletzt geändert am 7. November 2026