API de verificación de contactabilidad en Sudáfrica (ES)

Incorporar usuarios en Sudáfrica implica confirmar que son quienes dicen ser. Esto devuelve números de teléfono, correos electrónicos y direcciones conocidos asociados a un individuo sudafricano. Un documento o un detalle introducido solo prueba que los datos existen, no que sean genuinos o que pertenezcan a la persona que tienes delante. La Verificación de Contactabilidad de Sudáfrica cierra esa brecha al cotejar los datos con la información del operador de red móvil. 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 Contactabilidad de Sudáfrica valida la titularidad de números de teléfono contra los datos del operador de red móvil.
• Qué obtienes — un match_type normalizado más resultados a nivel de campo que puedes dirigir directamente a la lógica de aprobación / revisión / rechazo.
• Por qué es importante — Confirmar que un número de teléfono pertenece a la persona declarada bloquea el secuestro de cuentas y el fraude basado en SIM antes de que comience.
• Cómo usarlo — una solicitud POST al endpoint de validación de base de datos de Didit, o un módulo de flujo de trabajo sin código. $0.35 por consulta concluyente, resultados en segundos.

Qué valida la Verificación de Contactabilidad de Sudáfrica

Devuelve números de teléfono, correos electrónicos y direcciones conocidos asociados a un individuo sudafricano. Didit lo expone a través de un único endpoint para que puedas verificar los datos enviados contra los datos del operador de red móvil y recibir un resultado estructurado y normalizado, no un volcado de registro en bruto que tengas que analizar tú mismo.

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

Por qué es importante

Confirmar que un número de teléfono pertenece a la persona declarada bloquea el secuestro de cuentas y el fraude basado en SIM antes de que comience.

Para empresas reguladas en Sudáfrica (fintechs, plataformas de criptomonedas, prestamistas, mercados y operadores de juegos), la verificación contra 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 un único POST, sin necesidad de SDK.

Endpoint

POST /v3/database-validation/

Parámetros de solicitud

Parámetro	Tipo	Requerido	Descripción
issuing_state	string	Sí	Código de país ISO 3166-1 alfa-3. Usar ZAF.
services	string	Sí	Identificador de servicio. Usar zaf_contactability.
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_contactability" \
  -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_contactability",
      "service_name": "South Africa - Contactability Lookup",
      "source_data": {
        "contact_email": "alex.sample@example.com",
        "contact_phone_numbers": "+15550101000",
        "date_of_birth": "1990-01-01",
        "deceased": "sample_value",
        "first_name": "John",
        "gender": "M",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "phone_history_count": "+15550101000"
      },
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

Rendimiento y facturación

• Latencia: típicamente un par de segundos.
• Costo: $0.35 por consulta concluyente. Solo se te factura por resultados concluyentes; no hay cargo por tiempo de inactividad de la fuente, campos faltantes o rechazos previos a la fuente.
• Fiabilidad: funciona 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úralo y almacénalo antes de llamar al endpoint.

Casos de uso

• Fintech y neobancos — confirma un titular de cuenta real y verificable antes de abrir una billetera o conceder crédito en Sudáfrica.
• Cripto y Web3 — cumple con los requisitos de incorporación de VASP con pruebas de identidad de fuente autorizada.
• Préstamos — reduce el fraude de identidad sintética y de primera parte con datos verificados en la fuente.
• Mercados y plataformas de servicios bajo demanda — verifica usuarios contra datos autorizados, no solo un formulario autodeclarado.
• iGaming — cumple con los controles de identidad y elegibilidad para jugadores de Sudáfrica con un registro auditable.

Cómo integrarse con Didit

Puedes ejecutar la Verificación de Contactabilidad de Sudáfrica de dos maneras:

1. Flujo de trabajo sin código. En la Consola de Negocios de Didit, abre el Creador de Flujos de Trabajo, añade el módulo Validación de Base de Datos, selecciona Sudáfrica → Verificación de Contactabilidad de Sudáfrica y actívalo. Los usuarios coincidentes se dirigen automáticamente, sin necesidad de ingeniería.
2. API directa. Llama al endpoint /v3/database-validation/ mostrado arriba con services=zaf_contactability. Lee match_type y el bloque validation por campo para impulsar tu lógica de aprobación / revisión / rechazo.

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

Preguntas frecuentes

¿Qué confirma la Verificación de Contactabilidad de Sudáfrica?

Valida los datos enviados contra los datos del operador de red móvil y devuelve un resultado de coincidencia normalizado, para que sepas si la titularidad del número de teléfono existe en la fuente autorizada y qué campos coincidieron.

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

No se te cobra. La facturación se aplica solo a 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 se devuelve en un par de segundos, por lo que se ajusta a un flujo de incorporación en tiempo real.

¿Necesito un SDK?

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

¿Listo para empezar?

Valida hoy mismo la titularidad de tu primer número de teléfono sudafricano.

• Lee la referencia de la API: Verificación de Contactabilidad de Sudáfrica
• Consulta todas las validaciones de bases de datos: Precios y cobertura de validación de bases de datos
• Empieza a construir: Crea una cuenta gratuita de Didit — 500 verificaciones al mes, gratis.