API de Verificación de Cédula de Costa Rica (ES)

Incorporar usuarios en Costa Rica implica confirmar que son quienes dicen ser. Verifica la Cédula costarricense contra el registro civil del Tribunal Supremo de Elecciones. Un documento o un detalle escrito solo prueban que los datos existen, no que sean genuinos o pertenezcan a la persona que tienes delante. La Verificación de Cédula de Costa Rica cierra esa brecha verificando los datos con el registro oficial de identidad 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é comprueba: la Verificación de Cédula de Costa Rica valida la identificación nacional contra el registro oficial de identidad del gobierno del país.
• Qué obtienes a cambio: un match_type normalizado más resultados a nivel de campo que puedes enrutar directamente a la lógica de aprobar / revisar / rechazar.
• Por qué es importante: un documento puede ser falsificado; un registro oficial no. Validar la identificación con la fuente gubernamental autorizada confirma que el titular es real y está correctamente identificado.
• Cómo usarlo: un 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 de Costa Rica

Verifica la Cédula costarricense contra el registro civil del Tribunal Supremo de Elecciones. Didit lo expone a través de un único endpoint para que puedas verificar los datos enviados con el registro oficial de identidad del gobierno del país y recibir un resultado estructurado y normalizado, no un volcado de registro sin procesar 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

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

Para las empresas reguladas en Costa Rica (fintechs, plataformas de criptomonedas, prestamistas, mercados y operadores de juegos), la verificación con una fuente autorizada produce un registro defendible y auditable que confirma que la identidad se confirmó en la fuente, no solo se capturó 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	Obligatorio	Descripción
issuing_state	string	Sí	Código de país alfa-3 ISO 3166-1. Utilice CRI.
services	string	Sí	Identificador de servicio. Utilice cri_cedula.
personal_number	string	Sí	Número de identificación.
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=CRI" \
  -F "services=cri_cedula" \
  -F "personal_number=1111111"

Ejemplo de respuesta (coincidencia concluyente)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "CRI",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "cri_cedula",
      "service_name": "Costa Rica - Cédula verification",
      "source_data": {
        "first_name": "John",
        "full_name": "John Doe",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Rendimiento y facturación

• Latencia: normalmente un par de segundos.
• Costo: $0.20 por consulta concluyente. Solo se factura por los resultados concluyentes; no se cobra por la inactividad de la fuente, los campos faltantes o los 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 Costa Rica.
• 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 trabajo independiente: verifique a los usuarios con datos autorizados, no solo con un formulario autoinformado.
• iGaming: cumpla con las comprobaciones de identidad y elegibilidad para jugadores de Costa Rica con un registro auditable.

Cómo integrarse con Didit

Puede ejecutar la Verificación de Cédula de Costa Rica 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 Validación de Base de Datos, seleccione Costa Rica → Verificación de Cédula de Costa Rica y actívelo. Los usuarios coincidentes se enrutan automáticamente: no se requiere ingeniería.
2. API directa. Llame al endpoint /v3/database-validation/ mostrado anteriormente con services=cri_cedula. Lea match_type y el bloque de validation por campo para impulsar su lógica de aprobar / revisar / rechazar.

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

Preguntas frecuentes

¿Qué confirma la Verificación de Cédula de Costa Rica?

Valida los datos enviados con el registro oficial de identidad 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 está temporalmente no disponible?

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 normalmente 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 puede conectarlo a un flujo de trabajo sin código en la Consola de Negocios.

¿Listo para empezar?

Valide su primera identificación nacional de Costa Rica hoy mismo.

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