API de Verificación de Recuperación de Fotos DHA de Sudáfrica (ES)

Incorporar usuarios en Sudáfrica significa confirmar que son quienes dicen ser. Recupera la fotografía registrada del Departamento de Asuntos Internos para un número de identificación sudafricano. Un documento o un detalle escrito solo prueba que los datos existen, no que sean genuinos o que pertenezcan a la persona que tiene delante. La Verificación de Recuperación de Fotos DHA de Sudáfrica cierra esa brecha al verificar los datos con fuentes de datos gubernamentales autorizadas. Esta guía explica qué hace la verificación, los detalles técnicos exactos y cómo integrarla en minutos.

Puntos clave:

• Qué verifica — La Verificación de Recuperación de Fotos DHA de Sudáfrica valida los registros gubernamentales con fuentes de datos gubernamentales autorizadas.
• Qué obtiene a cambio — un match_type normalizado más resultados a nivel de campo que puede dirigir directamente a la lógica de aprobación/revisión/rechazo.
• Por qué es importante — Los registros gubernamentales son la fuente autorizada más sólida para confirmar que una persona existe con la identidad declarada.
• Cómo usarlo — una solicitud POST al endpoint de validación de bases de datos de Didit, o un módulo de flujo de trabajo sin código. $1.10 por consulta concluyente, resultados en segundos.

Qué valida la Verificación de Recuperación de Fotos DHA de Sudáfrica

Recupera la fotografía registrada del Departamento de Asuntos Internos para un número de identificación sudafricano. Didit lo expone a través de un único endpoint para que pueda verificar los datos enviados con fuentes de datos gubernamentales autorizadas y recibir un resultado estructurado y normalizado, no un volcado de registro en bruto que tenga que analizar usted mismo.

Una respuesta concluyente devuelve los source_data coincidentes y un bloque de validation por campo, para que su motor de riesgo obtenga un veredicto claro y legible por máquina.

Por qué es importante

Los registros gubernamentales son la fuente autorizada más sólida para confirmar que una persona existe con la identidad declarada.

Para las empresas reguladas en Sudáfrica (fintechs, plataformas de criptomonedas, prestamistas, mercados y operadores de juegos), la verificación con una fuente autorizada produce un registro defendible y auditable de que la identidad fue confirmada en la fuente, no simplemente capturada de un formulario o una foto.

Detalles técnicos

Didit expone este servicio a través del endpoint unificado de validación de bases de datos. Es una única solicitud POST, no se requiere SDK.

Endpoint

POST /v3/database-validation/

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción
issuing_state	string	Sí	Código de país ISO 3166-1 alfa-3. Use ZAF.
services	string	Sí	Identificador de servicio. Use zaf_dha_photo.
national_id	string	Sí	Identificación nacional.

Ejemplo de solicitud

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_dha_photo" \
  -F "national_id=1111111"

Ejemplo de respuesta (coincidencia concluyente)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_dha_photo",
      "service_name": "South Africa - DHA Photo Retrieval",
      "source_data": {
        "birth_place_country_code": "sample_value",
        "deceased": "sample_value",
        "first_name": "John",
        "id_blocked": false,
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "marital_status": "sample_value",
        "on_hanis_biometric_register": "sample_value",
        "on_national_population_register": "sample_value",
        "photo_base64": "sample_value",
        "smart_card_issued": "sample_value",
        "transaction_number": "SAMPLE-12345"
      },
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

Rendimiento y facturación

• Latencia: típicamente un par de segundos.
• Costo: $1.10 por consulta concluyente. Se le factura solo por resultados concluyentes; no hay cargo por tiempo de inactividad de la fuente, campos faltantes o rechazos previos a la fuente.
• Fiabilidad: se ejecuta en la infraestructura de Didit con un objetivo de tiempo de actividad trimestral del 99.9%.
• Consentimiento: este servicio requiere el consentimiento documentado del usuario final. Captúrelo y almacénelo antes de llamar al endpoint.

Casos de uso

• Fintech y neobancos — confirme un titular de cuenta real y verificable antes de abrir una billetera o extender crédito en Sudáfrica.
• Cripto y Web3 — cumpla con los requisitos de incorporación de VASP con pruebas de identidad de fuente autorizada.
• Préstamos — reduzca el fraude de identidad sintética y de primera parte con datos verificados por la fuente.
• Mercados y plataformas de trabajos temporales — verifique a los usuarios con datos autorizados, no solo con un formulario autoinformado.
• iGaming — satisfaga los controles de identidad y elegibilidad para los jugadores de Sudáfrica con un rastro auditable.

Cómo integrarse con Didit

Puede ejecutar la Verificación de Recuperación de Fotos DHA de Sudáfrica de dos maneras:

1. Flujo de trabajo sin código. En la Consola de Negocios de Didit, abra el Creador de Flujos de Trabajo, agregue el módulo Validación de Base de Datos, seleccione Sudáfrica → Verificación de Recuperación de Fotos DHA de Sudáfrica y actívelo. Los usuarios coincidentes se dirigen automáticamente, no se requiere ingeniería.
2. API directa. Llame al endpoint /v3/database-validation/ que se muestra arriba con services=zaf_dha_photo. Lea match_type y el bloque de validation por campo para impulsar su lógica de aprobación/revisión/rechazo.

Cada cuenta de Didit incluye 500 verificaciones gratuitas por mes, para que pueda probar el flujo completo de principio a fin antes de pagar por una sola consulta.

Preguntas frecuentes

¿Qué confirma la Verificación de Recuperación de Fotos DHA de Sudáfrica?

Valida los datos enviados con fuentes de datos gubernamentales autorizadas y devuelve un resultado de coincidencia normalizado, para que sepa si los registros gubernamentales existen en la fuente autorizada y qué campos coincidieron.

¿Qué sucede si la fuente no está disponible temporalmente?

No se le cobra. La facturación solo se aplica a los resultados concluyentes; el tiempo de inactividad de la fuente, los campos faltantes y los rechazos previos a la fuente son gratuitos.

¿Qué tan rápida es la verificación?

La validación de la base de datos generalmente devuelve en un par de segundos, por lo que se adapta a un flujo de incorporación en tiempo real.

¿Necesito un SDK?

No. La verificación es una única solicitud HTTPS POST a un endpoint. También puede conectarlo a un flujo de trabajo sin código en la Consola de Negocios.

¿Listo para empezar?

Valide sus primeros registros gubernamentales de Sudáfrica hoy mismo.

• Lea la referencia de la API: Verificación de Recuperación de Fotos DHA de Sudáfrica
• Vea todas las validaciones de bases de datos: Precios y cobertura de validación de bases de datos
• Empiece a construir: Cree una cuenta gratuita de Didit — 500 verificaciones al mes, gratis.