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"
}
}
]
}
Validació en bases de dades
Verificació del NRC de Zàmbia (registre fiscal): API
Validació del NRC de Zàmbia (registre fiscal) amb bases de dades oficials, via Didit. Des de $0.20 per crida, sense contractes ni mínims.
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 que un número de la targeta nacional de registre de Zàmbia (NRC) pertany al contribuent indicat al registre de l’Autoritat de Recaptació d’Ingressos de Zàmbia. El registre només conté el nom complet del contribuent, de manera que el nom és l’únic camp que es compara. Didit exposa aquest servei a través de
POST /v3/database-validation/ perquè puguis verificar les dades enviades amb la font oficial i rebre resultats de coincidència normalitzats.
Cobertura
- Cobertura: —
- País: Zàmbia
- ID del servei:
zmb_national_id - Àmbit de dades: Identitat
- Categoria: TaxRegistry
Entrades
| Camp | Obligatori | Exemple |
|---|---|---|
national_id | Sí | 123456/78/9 |
first_name | Sí | John |
last_name | Sí | Doe |
vendor_data | No | user-1234 |
- Entrades obligatòries:
national_id,first_name,last_name - Entrades opcionals:
vendor_data - Consentiment: No cal
- Disponibilitat: Disponible en un flux de treball
- Cobertura: —
- Preu: $0.20 per consulta satisfactòria
Paràmetres del cos
string
predeterminat:"ZMB"
requerit
Codi de país ISO 3166-1 alfa-3 per a aquest servei de bases de dades.Exemple:
ZMBstring
predeterminat:"zmb_national_id"
requerit
Matriu que conté aquest ID de servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades exacta.Exemple:
zmb_national_idstring
predeterminat:"123456/78/9"
requerit
Número d’identitat nacional per a aquest servei.Exemple:
123456/78/9string
predeterminat:"John"
requerit
Nom de pila a validar.Exemple:
Johnstring
predeterminat:"Doe"
requerit
Cognom a validar.Exemple:
Doestring
predeterminat:"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 al mateix usuari final i reduir el soroll de la detecció de duplicats.Exemple:
user-1234Regles d’entrada i notes de validació
national_idha d’utilitzar lletres majúscules.national_idha de coincidir amb\d{6}/?\d{2}/?\d.
Com fer la crida
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));
Cada crida satisfactòria retorna HTTP 200. El camp outcome_code indica què ha passat realment, per exemple distingint una discrepància biomètrica real (BIOMETRIC_NO_MATCH) d’una selfie que no s’ha pogut llegir (BIOMETRIC_IMAGE_UNUSABLE). L’status que es mostra és l’estat per defecte de la funcionalitat; les teves accions de coincidència parcial / sense coincidència configurades el poden substituir.MATCH: El registre ha confirmat la identitat i tots els camps verificats han coincidit.{
"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: S’ha trobat el número d’identificació, però un o més camps personals (normalment el nom o la data de naixement) no han coincidit completament.{
"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: El registre no ha retornat cap coincidència per a les dades enviades.{
"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: El número de document enviat no correspon a cap entrada del registre.{
"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"
}
}
]
}
Dades retornades
Els camps exactes que apareixen asource_data depenen del que retorni el registre. L’exemple generat per a zmb_national_id documenta actualment aquesta forma normalitzada:
first_namefull_nameidentification_numberlast_nameregistration_status
Preus i SLA
Les consultes del NRC de Zàmbia (registre tributari) només es facturen quan Didit rep un resultat concloent de la font de validació.- Preu per crida: $0.20 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 posterior varia segons el país i el conjunt de dades.
Continua llegint
Darrera modificació el 7 de novembre del 2026