Registro delle imprese Sudafrica - API di ricerca

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_registry" \
  -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_registry",
      "service_name": "South Africa - Company Registry 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_registry",
      "service_name": "South Africa - Company Registry 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_registry" \
  -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_registry",
      "service_name": "South Africa - Company Registry 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_registry",
      "service_name": "South Africa - Company Registry Lookup",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}

Cerca un’azienda sudafricana tramite numero di registrazione nel registro commerciale della CIPC. Didit espone questo servizio tramite POST /v3/database-validation/ così da poter verificare i dati inviati rispetto alla fonte autorevole e ricevere risultati di corrispondenza normalizzati.

Copertura

Copertura: —
Paese: Sudafrica
ID del servizio: zaf_company_registry
Dominio dei dati: Governativo
Categoria: CompanyRegister

Input

Campo	Obbligatorio	Esempio
`company_registration_number`	Sì	`REG-123456`
`company_name`	No	`Sample Company LLC`
`vendor_data`	No	`user-1234`

Input obbligatori: company_registration_number
Input facoltativi: company_name, 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 a un questionario, da un campo estratto da Document AI oppure da un valore che invii alla creazione della sessione, e mappalo sul 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 verifica su un database che non è stato possibile interrogare.

Parametri del corpo

string

predefinito:"ZAF"

obbligatorio

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

string

predefinito:"zaf_company_registry"

obbligatorio

Array che contiene l’ID di questo servizio. Specificare il servizio mantiene la richiesta limitata a questo database esatto.Esempio: zaf_company_registry

string

predefinito:"REG-123456"

obbligatorio

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

string

Valore di company_name richiesto da questo servizio di database.Esempio: Sample Company LLC

string

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 dovuto ai duplicati.Esempio: user-1234

Regole per gli input e note di validazione

Invia i campi indicati sopra esattamente come raccolti dall’utente o dal documento.
Didit convalida i campi obbligatori prima di chiamare il database. Le richieste rifiutate prima della consultazione della 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_registry" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=REG-123456"

Ogni chiamata riuscita restituisce HTTP 200. Il campo outcome_code indica cosa è effettivamente successo, distinguendo, ad esempio, una vera 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 tue azioni Partial Match / No Match configurate possono sostituirlo.

MATCH: il registro ha confermato l’identità e ogni campo verificato corrisponde.

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_company_registry",
      "service_name": "South Africa - Company Registry 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_registry",
      "service_name": "South Africa - Company Registry 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_registry documenta attualmente questa struttura normalizzata:

Varia in base alla risposta del registro.

Prezzi e SLA

Le query di ricerca nel registro delle imprese sudafricano vengono fatturate solo quando Didit riceve un risultato conclusivo 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 campi obbligatori o quando la richiesta viene rifiutata prima di raggiungere la fonte.
Latenza: p95 tipico < 2 s.
Disponibilità: 99.9% per trimestre lato Didit; la disponibilità delle fonti a valle varia per paese e dataset.

Continua a leggere

Ultima modifica il 7 novembre 2026

​Copertura

​Input

​Parametri del corpo

​Regole per gli input e note di validazione

​Come effettuare la chiamata

​Dati restituiti

​Prezzi e SLA

​Continua a leggere

Copertura

Input

Parametri del corpo

Regole per gli input e note di validazione

Come effettuare la chiamata

Dati restituiti

Prezzi e SLA

Continua a leggere