API de verificació d'identificació nacional de Sud-àfrica (DHA) (CA)

L'incorporació d'usuaris a Sud-àfrica implica confirmar que són qui diuen ser. Es verifiquen les dades d'entrada amb el registre del Departament d'Afers Interiors (DHA) de Sud-àfrica. Un document o un detall introduït només demostra que les dades existeixen, no que siguin genuïnes o que pertanyin a la persona que teniu al davant. La verificació d'identificació nacional de Sud-àfrica (DHA) tanca aquesta bretxa comprovant les dades amb el DHA. Aquesta guia explica què fa la comprovació, els detalls tècnics exactes i com integrar-la en minuts.

Punts clau:

• Què comprova — La verificació d'identificació nacional de Sud-àfrica (DHA) valida la identificació nacional amb el DHA.
• Què s'obté — un match_type normalitzat, a més de resultats a nivell de camp que es poden dirigir directament a la lògica d'aprovació / revisió / rebuig.
• Per què és important — Un document es pot falsificar; un registre no. La validació de la identificació amb la font governamental autoritzada confirma que el titular és real i està correctament identificat.
• Com utilitzar-lo — una POST a l'endpoint de validació de bases de dades de Didit, o un mòdul de flux de treball sense codi. 1,10 $ per consulta concloent, resultats en segons.

Què valida la verificació d'identificació nacional de Sud-àfrica (DHA)

Verifica les dades d'entrada amb el registre del Departament d'Afers Interiors (DHA) de Sud-àfrica. Didit ho exposa a través d'un únic endpoint perquè pugueu verificar les dades enviades amb el registre d'identitat oficial del govern del país i rebre un resultat estructurat i normalitzat, no un abocament de registre en brut que hagueu d'analitzar vosaltres mateixos.

Una resposta concloent retorna les source_data coincident i un bloc de validation per camp, de manera que el vostre motor de risc obté un veredicte clar i llegible per màquina.

Per què és important

Un document es pot falsificar; un registre no. La validació de la identificació amb la font governamental autoritzada confirma que el titular és real i està correctament identificat.

Per a les empreses regulades a Sud-àfrica — fintechs, plataformes de criptomonedes, prestadors, mercats i operadors de jocs — la comprovació amb una font autoritzada produeix un registre defensable i auditable que la identitat es va confirmar a la font, no només es va capturar d'un formulari o una foto.

Detalls tècnics

Didit exposa aquest servei a través de l'endpoint unificat de validació de bases de dades. És un únic POST — no es requereix SDK.

Endpoint

POST /v3/database-validation/

Paràmetres de la sol·licitud

Paràmetre	Tipus	Obligatori	Descripció
issuing_state	string	Sí	Codi de país ISO 3166-1 alpha-3. Utilitzeu ZAF.
services	string	Sí	Identificador del servei. Utilitzeu zaf_africa_national_id.
first_name	string	Sí	Nom.
last_name	string	Sí	Cognom.
date_of_birth	string	Sí	Data de naixement.
national_id	string	Sí	Identificació nacional.

Exemple de sol·licitud

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_africa_national_id" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "national_id=1111111"

Exemple de resposta (coincidència concloent)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_africa_national_id",
      "service_name": "South Africa National ID (DHA)",
      "source_data": {
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "marital_status": "sample_value"
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Rendiment i facturació

• Latència: normalment un parell de segons.
• Cost: 1,10 $ per consulta concloent. Se us facturarà només pels resultats concloents — sense càrrec per temps d'inactivitat de la font, camps que falten o rebuigs previs a la font.
• Fiabilitat: funciona a la infraestructura de Didit amb un objectiu de temps d'activitat trimestral del 99,9%.

Casos d'ús

• Fintech i neobancs — confirmeu un titular de compte real i verificable abans d'obrir una cartera o concedir crèdit a Sud-àfrica.
• Criptomonedes i Web3 — compliu els requisits d'incorporació de VASP amb una prova d'identitat de font autoritzada.
• Préstecs — reduïu el frau d'identitat sintètica i de primera part amb dades verificades per la font.
• Mercats i plataformes de serveis a demanda — verifiqueu els usuaris amb dades autoritzades, no només amb un formulari auto-declarat.
• iGaming — compliu les comprovacions d'identitat i elegibilitat per als jugadors de Sud-àfrica amb un registre auditable.

Com integrar-se amb Didit

Podeu executar la verificació d'identificació nacional de Sud-àfrica (DHA) de dues maneres:

1. Flux de treball sense codi. A la Consola d'Empreses de Didit, obriu el Creador de Fluxos de Treball, afegiu el mòdul Validació de Bases de Dades, seleccioneu Sud-àfrica → Verificació d'Identificació Nacional de Sud-àfrica (DHA) i activeu-lo. Els usuaris coincidents es dirigeixen automàticament — no es requereix enginyeria.
2. API directa. Truqueu a l'endpoint /v3/database-validation/ que es mostra a dalt amb services=zaf_africa_national_id. Llegiu match_type i el bloc de validation per camp per dirigir la vostra lògica d'aprovació / revisió / rebuig.

Cada compte de Didit inclou 500 verificacions gratuïtes al mes, de manera que podeu provar el flux complet de principi a fi abans de pagar per una sola consulta.

Preguntes freqüents

Què confirma la comprovació de la verificació d'identificació nacional de Sud-àfrica (DHA)?

Valida les dades enviades amb el DHA i retorna un resultat de coincidència normalitzat, de manera que sabreu si la identificació nacional existeix a la font autoritzada i quins camps van coincidir.

Què passa si la font no està disponible temporalment?

No se us cobrarà. La facturació només s'aplica als resultats concloents — el temps d'inactivitat de la font, els camps que falten i els rebuigs previs a la font són gratuïts.

Quina rapidesa té la comprovació?

La validació de bases de dades sol retornar-se en un parell de segons, de manera que s'adapta a un flux d'incorporació en temps real.

Necessito un SDK?

No. La comprovació és un únic POST HTTPS a un endpoint. També podeu connectar-lo a un flux de treball sense codi a la Consola d'Empreses.

Preparat per començar?

Valideu la vostra primera identificació nacional de Sud-àfrica avui mateix.

• Llegiu la referència de l'API: Verificació d'identificació nacional de Sud-àfrica (DHA)
• Vegeu totes les validacions de bases de dades: Preus i cobertura de la validació de bases de dades
• Comenceu a construir: Creeu un compte gratuït de Didit — 500 verificacions al mes, gratuïtes.