Consulta registre mercantil Sud-àfrica: API

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"
      }
    }
  ]
}

Consulta una empresa sud-africana pel seu número de registre al registre mercantil de la CIPC. Didit ofereix 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: Sud-àfrica
ID del servei: zaf_company_registry
Domini de dades: Govern
Categoria: CompanyRegister

Entrades

Camp	Obligatori	Exemple
`company_registration_number`	Sí	`REG-123456`
`company_name`	No	`Sample Company LLC`
`vendor_data`	No	`user-1234`

Camps obligatoris: company_registration_number
Camps opcionals: company_name, vendor_data
Consentiment: No requerit
Disponibilitat al flux de treball: Disponible al flux de treball amb mapeig de camps
Cobertura: —
Preu: $0.75 per consulta satisfactòria

Dins d’un flux de treball, company_registration_number no apareix imprès en cap document d’identitat, així que cap pas no el produeix per si sol. Recull-lo d’una resposta d’un Qüestionari, d’un camp extret per Document AI o d’un valor que envies en crear la sessió, i mapeja’l al pas de Validació en bases de dades. Mentre no estigui mapejat, l’editor del flux de treball mostra aquest servei desactivat i indica quin camp falta; en execució, un camp que falta fa que la comprovació s’ometi abans de fer cap consulta, així que mai no et cobren una base de dades que no s’ha pogut consultar.

Paràmetres del cos

string

predeterminat:"ZAF"

requerit

Codi de país ISO 3166-1 alpha-3 per a aquest servei de base de dades.Exemple: ZAF

string

predeterminat:"zaf_company_registry"

requerit

Matriu que conté l’ID d’aquest servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades exacta.Exemple: zaf_company_registry

string

predeterminat:"REG-123456"

requerit

Valor de company_registration_number que requereix aquest servei de base de dades.Exemple: REG-123456

string

Valor de company_name que requereix aquest servei de base de dades.Exemple: Sample Company LLC

string

predeterminat:"user-1234"

La teva referència estable d’usuari per a aquesta persona, com ara el teu ID intern d’usuari. Didit l’utilitza per enllaçar les comprovacions independents amb el mateix usuari final i reduir el soroll de detecció de duplicats.Exemple: user-1234

Regles d’entrada i notes de validació

Envia els camps indicats més amunt exactament tal com s’han capturat de l’usuari o del document.
Didit valida els camps obligatoris abans de cridar la base de dades. Les sol·licituds rebutjades abans de la consulta a la font no es facturen.

Com fer la crida

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"

Cada crida satisfactòria retorna HTTP 200. El camp outcome_code t’indica què ha passat realment, i distingeix, per exemple, una discrepància biomètrica real (BIOMETRIC_NO_MATCH) d’una selfie que no s’ha pogut llegir (BIOMETRIC_IMAGE_UNUSABLE). L’status mostrat és l’estat predeterminat de la funcionalitat; les accions de Coincidència parcial / Sense coincidència que hagis configurat poden substituir-lo.

MATCH — El registre ha confirmat la identitat i tots els camps comprovats coincideixen.

{
  "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 — El registre no ha retornat cap coincidència per a les dades enviades.

{
  "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"
      }
    }
  ]
}

Dades retornades

Els camps exactes que apareixen a source_data depenen del que retorni el registre. L’exemple generat per a zaf_company_registry documenta actualment aquesta forma normalitzada:

Varia segons la resposta del registre.

Preus i SLA

Les consultes al registre mercantil de Sud-àfrica només es facturen quan Didit rep un resultat concloent de la font de validació.

Preu per crida: $0.75 USD.
Facturació: per consulta satisfactòria. No et cobren quan el registre és inaccessible, 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 externa varia segons el país i el conjunt de dades.

Continua llegint

Darrera modificació el 7 de novembre del 2026

​Cobertura

​Entrades

​Paràmetres del cos

​Regles d’entrada i notes de validació

​Com fer la crida

​Dades retornades

​Preus i SLA

​Continua llegint

Cobertura

Entrades

Paràmetres del cos

Regles d’entrada i notes de validació

Com fer la crida

Dades retornades

Preus i SLA

Continua llegint