API de Verificación de Cédula Venezolana (ES-1)

Incorporar usuarios en Venezuela implica confirmar que son quienes dicen ser. Verifica la Cédula venezolana contra el registro civil del SAIME. Un documento o un detalle escrito solo prueba que los datos existen, no que sean genuinos o que pertenezcan a la persona frente a usted. La Verificación de Cédula Venezolana cierra esa brecha al cotejar los datos con el registro de identidad oficial del gobierno del país. 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 Cédula Venezolana valida la identidad nacional contra el registro oficial de identidad del gobierno del país.
• 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 — Un documento puede ser falsificado; un registro no. Validar la identificación contra la fuente gubernamental autorizada confirma que el titular es real y está correctamente identificado.
• 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.20 por consulta concluyente, resultados en segundos.

Qué valida la Verificación de Cédula Venezolana

Verifica la Cédula venezolana contra el registro civil del SAIME. Didit lo expone a través de un único endpoint para que pueda verificar los datos enviados contra el registro de identidad oficial del gobierno del país 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 de validation por campo, para que su motor de riesgo obtenga un veredicto claro y legible por máquina.

Por qué es importante

Un documento puede ser falsificado; un registro no. Validar la identificación contra la fuente gubernamental autorizada confirma que el titular es real y está correctamente identificado.

Para empresas reguladas en Venezuela — 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 una única solicitud 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 alfa-3. Use VEN.
services	string	Sí	Identificador de servicio. Use ven_cedula.
document_number	string	Sí	Número de documento.
first_name	string	No	Nombre (verificación cruzada opcional).
last_name	string	No	Apellido (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=VEN" \
  -F "services=ven_cedula" \
  -F "document_number=1111111"

Ejemplo de respuesta (coincidencia concluyente)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "VEN",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "ven_cedula",
      "service_name": "Venezuela - Cédula verification",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "document_type": "sample_value",
        "first_name": "John",
        "full_name": "John Doe",
        "gender": "M",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Rendimiento y facturación

• Latencia: típicamente un par de segundos.
• Costo: $0.20 por consulta concluyente. Solo se le factura 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%.

Casos de uso

• Fintech y neobancos — confirme un titular de cuenta real y verificable antes de abrir una billetera o extender crédito en Venezuela.
• Cripto y Web3 — cumpla con los requisitos de incorporación de VASP con una prueba 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 autoinformado.
• iGaming — satisfaga las comprobaciones de identidad y elegibilidad para jugadores de Venezuela con un rastro auditable.

Cómo integrarse con Didit

Puede ejecutar la Verificación de Cédula Venezolana de dos maneras:

1. Flujo de trabajo sin código. En la Consola de Negocios de Didit, abra el Constructor de Flujos de Trabajo, agregue el módulo de Validación de Base de Datos, seleccione Venezuela → Verificación de Cédula Venezolana y actívelo. Los usuarios coincidentes se dirigen automáticamente, no se requiere ingeniería.
2. API directa. Llame al endpoint /v3/database-validation/ mostrado arriba con services=ven_cedula. Lea match_type y el bloque de validation por campo para dirigir su lógica de aprobación / revisión / rechazo.

Cada cuenta de Didit incluye 500 verificaciones gratuitas al 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 Cédula Venezolana?

Valida los datos enviados contra el registro de identidad oficial del gobierno del país y devuelve un resultado de coincidencia normalizado, para que sepa si la identificación nacional 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 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 se devuelve en un par de segundos, por lo que encaja en 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 conectarla a un flujo de trabajo sin código en la Consola de Negocios.

¿Listo para empezar?

Valide su primera cédula de identidad venezolana hoy.

• Lea la referencia de la API: Verificación de Cédula Venezolana
• Vea todas las validaciones de base de datos: Precios y cobertura de validación de base de datos
• Empiece a construir: Cree una cuenta gratuita de Didit — 500 verificaciones al mes, gratis.