API de Verificació de Direccions de Persones a Sud-àfrica (CA)

Incorporar usuaris a Sud-àfrica significa confirmar que són qui diuen ser. Retorna totes les direccions registrades a CIPC que posseeix un individu sud-africà. Un document o un detall introduït només prova que les dades existeixen, no que siguin genuïnes o pertanyin a la persona que teniu davant. La verificació de direccions de persones a Sud-àfrica tanca aquesta bretxa comprovant les dades amb el registre oficial d'empreses. Aquesta guia explica què fa la comprovació, els detalls tècnics exactes i com integrar-la en minuts.

Punts clau:

• Què comprova — La verificació de direccions de persones a Sud-àfrica valida el registre d'empreses amb el registre oficial d'empreses.
• Què obteniu a canvi — un match_type normalitzat més resultats a nivell de camp que podeu encaminar directament a la lògica d'aprovació / revisió / rebuig.
• Per què és important — La validació del registre confirma que un negoci existeix legalment — la base de qualsevol flux de Know-Your-Business (KYB).
• Com utilitzar-lo — una POST al punt final de validació de bases de dades de Didit, o un mòdul de flux de treball sense codi. 1,20 $ per consulta concloent, resultats en segons.

Què valida la verificació de direccions de persones a Sud-àfrica

Retorna totes les direccions registrades a CIPC que posseeix un individu sud-africà. Didit l'exposa a través d'un únic punt final perquè pugueu verificar les dades enviades amb el registre oficial d'empreses i rebre un resultat estructurat i normalitzat, no un bolcat de registre brut que hàgiu de analitzar vosaltres mateixos.

Una resposta concloent retorna les source_data coincidents 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

La validació del registre confirma que un negoci existeix legalment — la base de qualsevol flux de Know-Your-Business (KYB).

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

Detalls tècnics

Didit exposa aquest servei a través del punt final unificat de validació de bases de dades. És una única POST — no es requereix SDK.

Punt final

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_person_directorships.
national_id	string	Sí	Identificador 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_person_directorships" \
  -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_person_directorships",
      "service_name": "South Africa - Person Directorships Lookup",
      "source_data": {
        "directorships": "sample_value",
        "identification_number": "SAMPLE-ID-12345"
      },
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

Rendiment i facturació

• Latència: normalment un parell de segons.
• Cost: 1,20 $ per consulta concloent. Només se us factura pels resultats concloents — sense càrrec per temps d'inactivitat de la font, camps que falten o rebutjos 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 — confirmen un titular de compte real i verificable abans d'obrir una cartera o concedir crèdit a Sud-àfrica.
• Crypto i Web3 — compleixen els requisits d'incorporació de VASP amb proves d'identitat de font autoritzada.
• Préstecs — redueixen el frau d'identitat sintètica i de primera part amb dades verificades per la font.
• Mercats i plataformes de serveis independents — verifiquen els usuaris amb dades autoritzades, no només un formulari autoinformat.
• iGaming — satisfan les comprovacions d'identitat i elegibilitat per als jugadors de Sud-àfrica amb un rastre auditable.

Com integrar-se amb Didit

Podeu executar la verificació de direccions de persones a Sud-àfrica de dues maneres:

1. Flux de treball sense codi. A la consola de negocis de Didit, obriu el creador de fluxos de treball, afegiu el mòdul Validació de base de dades, seleccioneu Sud-àfrica → Verificació de direccions de persones a Sud-àfrica i activeu-lo. Els usuaris que coincideixen s'encaminen automàticament, sense necessitat d'enginyeria.
2. API directa. Truqueu al punt final /v3/database-validation/ que es mostra a dalt amb services=zaf_person_directorships. Llegiu match_type i el bloc de validation per camp per impulsar la vostra lògica d'aprovació / revisió / rebuig.

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

Preguntes freqüents

Què confirma la verificació de direccions de persones a Sud-àfrica?

Valida les dades enviades amb el registre oficial d'empreses i retorna un resultat de coincidència normalitzat, de manera que sabeu si el registre de l'empresa existeix a la font autoritzada i quins camps coincideixen.

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

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

Quina velocitat té la comprovació?

La validació de la base de dades normalment es retorna 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 punt final. També podeu connectar-lo a un flux de treball sense codi a la consola de negocis.

Llestos per començar?

Valideu el vostre primer registre d'empresa a Sud-àfrica avui mateix.

• Llegiu la referència de l'API: Verificació de direccions de persones a Sud-àfrica
• Consulteu totes les validacions de bases de dades: Preus i cobertura de la validació de bases de dades
• Comenceu a construir: Creeu un compte Didit gratuït — 500 verificacions al mes, gratis.