API de Verificación de Titular de Cuenta Bancaria en Sudáfrica (ES-1)

Incorporar usuarios en Sudáfrica significa confirmar que son quienes dicen ser. Confirma que una cuenta bancaria sudafricana pertenece al titular nombrado a través del servicio interbancario de Verificación de Titular de Cuenta. 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 Titular de Cuenta Bancaria en Sudáfrica cierra esa brecha al verificar los datos contra la red nacional de banca/titularidad de cuentas. 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 Titular de Cuenta Bancaria en Sudáfrica valida la cuenta bancaria contra la red nacional de banca/titularidad de cuentas.
• Qué se obtiene — 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 — Confirmar la identidad del titular de la cuenta previene el fraude de pagos y apoya la incorporación de pagos y nóminas.
• Cómo usarlo — un POST al endpoint de validación de base de datos de Didit. $0.40 por consulta concluyente, resultados en segundos.

Qué valida la Verificación de Titular de Cuenta Bancaria en Sudáfrica

Confirma que una cuenta bancaria sudafricana pertenece al titular nombrado a través del servicio interbancario de Verificación de Titular de Cuenta. Didit lo expone a través de un único endpoint para que pueda verificar los datos enviados contra la red nacional de banca/titularidad de cuentas y recibir un resultado estructurado y normalizado, no un volcado de registro en bruto que tenga que analizar usted mismo.

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

Por qué es importante

Confirmar la identidad del titular de la cuenta previene el fraude de pagos y apoya la incorporación de pagos y nóminas.

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 base de datos. Es un único POST — no se requiere 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 alpha-3. Usar ZAF.
services	string	Sí	Identificador de servicio. Usar zaf_bank_account_holder.
national_id	string	Sí	Número de identificación nacional.
bank_account_number	string	Sí	Número de cuenta bancaria.
bank_name	string	Sí	Nombre del banco.
account_type	string	No	Tipo de cuenta (verificación cruzada opcional).
first_name	string	No	Primer nombre (verificación cruzada opcional).
last_name	string	No	Apellido (verificación cruzada opcional).
initials	string	No	Iniciales (verificación cruzada opcional).
email	string	No	Correo electrónico (verificación cruzada opcional).
phone_number	string	No	Número de teléfono (verificación cruzada opcional).

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_bank_account_holder" \
  -F "national_id=1111111" \
  -F "bank_account_number=11111111" \
  -F "bank_name=John Doe"

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_bank_account_holder",
      "service_name": "South Africa - Bank Account Holder Verification",
      "source_data": {
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

Rendimiento y facturación

• Latencia: típicamente un par de segundos.
• Costo: $0.40 por consulta concluyente. Se le factura solo por resultados concluyentes — sin 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. Capture y almacene 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 en la fuente.
• Mercados y plataformas de servicios — verifique usuarios contra datos autorizados, no solo un formulario auto-reportado.
• iGaming — satisfaga las verificaciones de identidad y elegibilidad para jugadores de Sudáfrica con un registro auditable.

Cómo integrar con Didit

Puede ejecutar la Verificación de Titular de Cuenta Bancaria en Sudáfrica de dos maneras:

1. Solo API directa. Este servicio se ejecuta a través de la API en lugar del constructor de flujo de trabajo sin código.
2. API directa. Llame al endpoint /v3/database-validation/ mostrado anteriormente con services=zaf_bank_account_holder. Lea match_type y el bloque validation por campo para impulsar su lógica de aprobación/revisión/rechazo.

Cada cuenta 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 titular de cuenta bancaria en Sudáfrica?

Valida los datos enviados contra la red nacional de banca/titularidad de cuentas y devuelve un resultado de coincidencia normalizado, para que sepa si la cuenta bancaria existe en la fuente autorizada y qué campos coincidieron.

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

No se le 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ápido es el cheque?

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.

¿Listo para empezar?

Valide su primera cuenta bancaria en Sudáfrica hoy.

• Lea la referencia de la API: Verificación de Titular de Cuenta Bancaria en 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.