curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZMB" \
-F "services=zmb_national_id" \
-F "vendor_data=user-1234" \
-F "national_id=123456/78/9" \
-F "first_name=John" \
-F "last_name=Doe"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="ZMB",
services=["zmb_national_id"],
first_name="John",
last_name="Doe",
national_id="123456/78/9",
vendor_data="user-1234",
)
print(result)
import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "ZMB",
services: ["zmb_national_id"],
first_name: "John",
last_name: "Doe",
national_id: "123456/78/9",
vendor_data: "user-1234",
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "ZMB",
Services: didit.Some([]string{"zmb_national_id"}),
FirstName: didit.String("John"),
LastName: didit.String("Doe"),
NationalID: didit.String("123456/78/9"),
VendorData: didit.String("user-1234"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
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("ZMB")
.services(List.of("zmb_national_id"))
.firstName("John")
.lastName("Doe")
.nationalId("123456/78/9")
.vendorData("user-1234")
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'ZMB',
'services' => ['zmb_national_id'],
'first_name' => 'John',
'last_name' => 'Doe',
'national_id' => '123456/78/9',
'vendor_data' => 'user-1234',
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "ZMB",
services: ["zmb_national_id"],
first_name: "John",
last_name: "Doe",
national_id: "123456/78/9",
vendor_data: "user-1234"
)
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 = "ZMB",
Services = new string[] { "zmb_national_id" },
FirstName = "John",
LastName = "Doe",
NationalId = "123456/78/9",
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZMB",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"first_name": "John",
"full_name": "John Doe",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"registration_status": "sample_value"
},
"validation": {
"full_name": "full_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "ZMB",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_MATCH",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"first_name": "John",
"full_name": "John Doe",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"registration_status": "sample_value"
},
"validation": {
"full_name": "no_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZMB",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"full_name": "NO_MATCH",
"identification_number": "NO_MATCH"
},
"validation": {
"full_name": "no_match",
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZMB",
"match_type": "no_match",
"validations": [
{
"outcome_code": "DOCUMENT_NOT_FOUND",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"full_name": "NO_MATCH",
"identification_number": "NO_MATCH"
},
"validation": {
"full_name": "no_match",
"identification_number": "no_match"
}
}
]
}
Validazione su database
Verifica NRC Zambia (registro fiscale): API Didit
Verifica NRC Zambia (registro fiscale) via Didit: validazione su database autorevole. Da $0.20 a chiamata, senza contratti né minimi.
POST
/
v3
/
database-validation
/
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZMB" \
-F "services=zmb_national_id" \
-F "vendor_data=user-1234" \
-F "national_id=123456/78/9" \
-F "first_name=John" \
-F "last_name=Doe"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="ZMB",
services=["zmb_national_id"],
first_name="John",
last_name="Doe",
national_id="123456/78/9",
vendor_data="user-1234",
)
print(result)
import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "ZMB",
services: ["zmb_national_id"],
first_name: "John",
last_name: "Doe",
national_id: "123456/78/9",
vendor_data: "user-1234",
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "ZMB",
Services: didit.Some([]string{"zmb_national_id"}),
FirstName: didit.String("John"),
LastName: didit.String("Doe"),
NationalID: didit.String("123456/78/9"),
VendorData: didit.String("user-1234"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
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("ZMB")
.services(List.of("zmb_national_id"))
.firstName("John")
.lastName("Doe")
.nationalId("123456/78/9")
.vendorData("user-1234")
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'ZMB',
'services' => ['zmb_national_id'],
'first_name' => 'John',
'last_name' => 'Doe',
'national_id' => '123456/78/9',
'vendor_data' => 'user-1234',
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "ZMB",
services: ["zmb_national_id"],
first_name: "John",
last_name: "Doe",
national_id: "123456/78/9",
vendor_data: "user-1234"
)
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 = "ZMB",
Services = new string[] { "zmb_national_id" },
FirstName = "John",
LastName = "Doe",
NationalId = "123456/78/9",
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZMB",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"first_name": "John",
"full_name": "John Doe",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"registration_status": "sample_value"
},
"validation": {
"full_name": "full_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "ZMB",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_MATCH",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"first_name": "John",
"full_name": "John Doe",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"registration_status": "sample_value"
},
"validation": {
"full_name": "no_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZMB",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"full_name": "NO_MATCH",
"identification_number": "NO_MATCH"
},
"validation": {
"full_name": "no_match",
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZMB",
"match_type": "no_match",
"validations": [
{
"outcome_code": "DOCUMENT_NOT_FOUND",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"full_name": "NO_MATCH",
"identification_number": "NO_MATCH"
},
"validation": {
"full_name": "no_match",
"identification_number": "no_match"
}
}
]
}
Verifica che un numero di Zambian National Registration Card (NRC) appartenga al contribuente indicato nel registro della Zambia Revenue Authority. Il registro contiene solo il nome completo del contribuente, quindi il nome è l’unico campo confrontato. Didit espone questo servizio tramite
POST /v3/database-validation/ per permetterti di verificare i dati inviati rispetto alla fonte autorevole e ricevere risultati di corrispondenza normalizzati.
Copertura
- Copertura: —
- Paese: Zambia
- ID servizio:
zmb_national_id - Dominio dei dati: Identità
- Categoria: TaxRegistry
Input
| Campo | Obbligatorio | Esempio |
|---|---|---|
national_id | Sì | 123456/78/9 |
first_name | Sì | John |
last_name | Sì | Doe |
vendor_data | No | user-1234 |
- Input obbligatori:
national_id,first_name,last_name - Input facoltativi:
vendor_data - Consenso: Non richiesto
- Disponibilità nel workflow: Disponibile nel workflow
- Copertura: —
- Prezzo: $0.20 per query riuscita
Parametri del body
string
predefinito:"ZMB"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio:
ZMBstring
predefinito:"zmb_national_id"
obbligatorio
Array che contiene questo ID servizio. Fissare il servizio mantiene la richiesta limitata a questo specifico database.Esempio:
zmb_national_idstring
predefinito:"123456/78/9"
obbligatorio
Numero di identità nazionale per questo servizio.Esempio:
123456/78/9string
predefinito:"John"
obbligatorio
Nome proprio da validare.Esempio:
Johnstring
predefinito:"Doe"
obbligatorio
Cognome da validare.Esempio:
Doestring
predefinito:"user-1234"
Il tuo riferimento utente stabile per questa persona, ad esempio il tuo ID utente interno. Didit lo usa per collegare i controlli indipendenti allo stesso utente finale e ridurre il rumore del rilevamento dei duplicati.Esempio:
user-1234Regole di input e note di validazione
national_iddeve usare lettere maiuscole.national_iddeve corrispondere a\d{6}/?\d{2}/?\d.
Come effettuare la chiamata
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZMB" \
-F "services=zmb_national_id" \
-F "vendor_data=user-1234" \
-F "national_id=123456/78/9" \
-F "first_name=John" \
-F "last_name=Doe"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="ZMB",
services=["zmb_national_id"],
first_name="John",
last_name="Doe",
national_id="123456/78/9",
vendor_data="user-1234",
)
print(result)
import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "ZMB",
services: ["zmb_national_id"],
first_name: "John",
last_name: "Doe",
national_id: "123456/78/9",
vendor_data: "user-1234",
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "ZMB",
Services: didit.Some([]string{"zmb_national_id"}),
FirstName: didit.String("John"),
LastName: didit.String("Doe"),
NationalID: didit.String("123456/78/9"),
VendorData: didit.String("user-1234"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
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("ZMB")
.services(List.of("zmb_national_id"))
.firstName("John")
.lastName("Doe")
.nationalId("123456/78/9")
.vendorData("user-1234")
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'ZMB',
'services' => ['zmb_national_id'],
'first_name' => 'John',
'last_name' => 'Doe',
'national_id' => '123456/78/9',
'vendor_data' => 'user-1234',
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "ZMB",
services: ["zmb_national_id"],
first_name: "John",
last_name: "Doe",
national_id: "123456/78/9",
vendor_data: "user-1234"
)
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 = "ZMB",
Services = new string[] { "zmb_national_id" },
FirstName = "John",
LastName = "Doe",
NationalId = "123456/78/9",
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
Ogni chiamata riuscita restituisce HTTP 200. Il campo outcome_code indica cosa è effettivamente accaduto, distinguendo ad esempio una vera mancata corrispondenza biometrica (BIOMETRIC_NO_MATCH) da un selfie che non può essere letto (BIOMETRIC_IMAGE_UNUSABLE). Lo status mostrato è lo stato predefinito della funzionalità; le tue azioni configurate per Partial Match / No Match possono sostituirlo.MATCH: il registro ha confermato l’identità e ogni campo verificato corrispondeva.{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZMB",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"first_name": "John",
"full_name": "John Doe",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"registration_status": "sample_value"
},
"validation": {
"full_name": "full_match",
"identification_number": "full_match"
}
}
]
}
PARTIAL_MATCH: il numero di identificazione è stato trovato, ma uno o più campi personali (di solito nome o data di nascita) non corrispondono completamente.{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "ZMB",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_MATCH",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"first_name": "John",
"full_name": "John Doe",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"registration_status": "sample_value"
},
"validation": {
"full_name": "no_match",
"identification_number": "full_match"
}
}
]
}
NO_MATCH: il registro non ha restituito alcuna corrispondenza per i dati inviati.{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZMB",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"full_name": "NO_MATCH",
"identification_number": "NO_MATCH"
},
"validation": {
"full_name": "no_match",
"identification_number": "no_match"
}
}
]
}
DOCUMENT_NOT_FOUND: il numero del documento inviato non corrisponde ad alcun record del registro.{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZMB",
"match_type": "no_match",
"validations": [
{
"outcome_code": "DOCUMENT_NOT_FOUND",
"service_id": "zmb_national_id",
"service_name": "Zambia NRC (tax register)",
"source_data": {
"full_name": "NO_MATCH",
"identification_number": "NO_MATCH"
},
"validation": {
"full_name": "no_match",
"identification_number": "no_match"
}
}
]
}
Dati restituiti
I campi esatti esposti insource_data dipendono da ciò che restituisce il registro. L’esempio generato per zmb_national_id documenta attualmente questa struttura normalizzata:
first_namefull_nameidentification_numberlast_nameregistration_status
Prezzi e SLA
Le query del registro NRC dello Zambia (registro fiscale) vengono fatturate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.- Prezzo per chiamata: $0.20 USD.
- Fatturazione: per query riuscita. Non ti viene addebitato nulla quando il registro non è raggiungibile, quando mancano campi obbligatori o quando la richiesta viene respinta prima di raggiungere la fonte.
- Latenza: p95 tipico < 2 s.
- Disponibilità: 99.9% per trimestre lato Didit; la disponibilità della fonte a valle varia in base al paese e al dataset.
Continua a leggere
Ultima modifica il 7 novembre 2026