Sudafrica - API di ricerca amministratori aziendali

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_company_directors" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=REG-123456"

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_company_directors",
      "service_name": "South Africa - Company Directors Lookup",
      "source_data": {},
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_company_directors",
      "service_name": "South Africa - Company Directors Lookup",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}

POST

database-validation

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_company_directors" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=REG-123456"

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_company_directors",
      "service_name": "South Africa - Company Directors Lookup",
      "source_data": {},
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_company_directors",
      "service_name": "South Africa - Company Directors Lookup",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}

Restituisce i direttori attuali di una società sudafricana dal registro commerciale CIPC. 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: Sudafrica
ID del servizio: zaf_company_directors
Dominio dei dati: Governo
Categoria: CompanyRegister

Input

Campo	Obbligatorio	Esempio
`company_registration_number`	Sì	`REG-123456`
`vendor_data`	No	`user-1234`

Input obbligatori: company_registration_number
Input facoltativi: vendor_data
Consenso: non richiesto
Disponibilità nel workflow: disponibile nel workflow con mappatura dei campi
Copertura: —
Prezzo: $0.75 per query riuscita

In un workflow, company_registration_number non è stampato su un documento d’identità, quindi nessun passaggio lo produce da solo. Raccoglilo da una risposta di un Questionario, da un campo estratto da Document AI oppure da un valore che invii al momento della creazione della sessione, e mappalo nel passaggio Validazione su database. Finché non è mappato, l’editor del workflow mostra questo servizio disabilitato e indica l’input mancante. In fase di esecuzione, un input mancante fa sì che il controllo venga saltato prima di qualsiasi query, quindi non ti viene mai addebitata una base dati che non sarebbe stato possibile interrogare.

Parametri del body

string

predefinito:"ZAF"

obbligatorio

Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: ZAF

string

predefinito:"zaf_company_directors"

obbligatorio

Array che contiene questo ID del servizio. Vincolare il servizio mantiene la richiesta limitata a questo database specifico.Esempio: zaf_company_directors

string

predefinito:"REG-123456"

obbligatorio

Valore di company_registration_number richiesto da questo servizio di database.Esempio: REG-123456

string

predefinito:"user-1234"

Il tuo riferimento utente stabile per questa persona, come il tuo ID utente interno. Didit lo usa per collegare i controlli autonomi allo stesso utente finale e ridurre il rumore dovuto ai duplicati.Esempio: user-1234

Regole sugli input e note di validazione

Invia i campi elencati sopra esattamente come sono stati acquisiti dall’utente o dal documento.
Didit valida i campi obbligatori prima di interrogare il database. Le richieste rifiutate prima della ricerca nella fonte non vengono addebitate.

Come effettuare la chiamata

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_company_directors" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=REG-123456"

Ogni chiamata riuscita restituisce HTTP 200. Il campo outcome_code indica cosa è effettivamente accaduto, distinguendo ad esempio una reale mancata corrispondenza biometrica (BIOMETRIC_NO_MATCH) da un selfie che non è stato possibile leggere (BIOMETRIC_IMAGE_UNUSABLE). Lo status mostrato è lo stato predefinito della funzionalità; le azioni configurate per Partial Match / No Match possono sostituirlo.

MATCH: il registro ha confermato l’identità e tutti i campi verificati corrispondono.

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_company_directors",
      "service_name": "South Africa - Company Directors Lookup",
      "source_data": {},
      "validation": {
        "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": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_company_directors",
      "service_name": "South Africa - Company Directors Lookup",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}

Dati restituiti

I campi esatti esposti in source_data dipendono da ciò che restituisce il registro. L’esempio generato per zaf_company_directors documenta attualmente questa struttura normalizzata:

Varia in base alla risposta del registro.

Prezzi e SLA

Sudafrica - Ricerca dei direttori di società: le query vengono addebitate solo quando Didit riceve un risultato definitivo dalla fonte di validazione.

Prezzo per chiamata: $0.75 USD.
Fatturazione: per query riuscita. Non ti viene addebitato nulla quando il registro non è raggiungibile, quando mancano i campi obbligatori o quando la richiesta viene rifiutata prima di raggiungere la fonte.
Latenza: p95 tipico < 2 s.
Disponibilità: 99.9% per trimestre da parte di Didit; la disponibilità delle fonti a valle varia in base al paese e al dataset.

Continua a leggere

Ultima modifica il 7 novembre 2026

​Copertura

​Input

​Parametri del body

​Regole sugli input e note di validazione

​Come effettuare la chiamata

​Dati restituiti

​Prezzi e SLA

​Continua a leggere

Copertura

Input

Parametri del body

Regole sugli input e note di validazione

Come effettuare la chiamata

Dati restituiti

Prezzi e SLA

Continua a leggere