API de verificació de Cèdula de Costa Rica (CA)

Incorporar usuaris a Costa Rica implica confirmar que són qui diuen ser. Verifica la Cèdula costarricenca contra el registre civil del Tribunal Suprem d'Eleccions. Un document o un detall escrit només demostren que les dades existeixen — no que siguin autèntiques o que pertanyin a la persona que tens davant. La verificació de la Cèdula de Costa Rica tanca aquesta bretxa comprovant les dades amb el registre d'identitat oficial del govern. Aquesta guia explica què fa la comprovació, els detalls tècnics exactes i com integrar-la en minuts.

Punts clau:

• Què comprova — La verificació de la Cèdula de Costa Rica valida la identificació nacional contra el registre oficial del govern.
• Què obtens — un match_type normalitzat més resultats a nivell de camp que pots encaminar directament a la lògica d'aprovació / revisió / rebuig.
• Per què és important — Un document es pot falsificar; un registre no. Validar la identificació amb la font governamental autoritària confirma que el titular és real i està correctament identificat.
• Com utilitzar-lo — un POST a l'endpoint de validació de base de dades de Didit, o un mòdul de flux de treball sense codi. 0,20$ per consulta concloent, resultats en segons.

Què valida la verificació de la Cèdula de Costa Rica

Verifica la Cèdula costarricenca contra el registre civil del Tribunal Suprem d'Eleccions. Didit l'exposa a través d'un sol endpoint perquè puguis verificar les dades enviades amb el registre d'identitat oficial del govern i rebre un resultat estructurat i normalitzat — no un volcar de registre brut que hagis de processar tu mateix.

Una resposta concloent retorna les source_data coincidints i un bloc de validation per camp, perquè el teu motor de risc obtingui un veredicte clar i llegible per màquina.

Per què és important

Un document es pot falsificar; un registre no. Validar la identificació amb la font governamental autoritària confirma que el titular és real i està correctament identificat.

Per a empreses regulades a Costa Rica — fintechs, plataformes de criptomonedes, prestadors, mercats i operadors de jocs — comprovar una font autoritària produeix un registre defensable i auditable que la identitat es va confirmar a la font, no només es va capturar d'un formulari o una foto.

Detalls tècnics

Didit exposa aquest servei a través de l'endpoint unificat de validació de base de dades. És un únic POST — no es necessita SDK.

Endpoint

POST /v3/database-validation/

Paràmetres de la sol·licitud

Paràmetre	Tipus	Obligatori	Descripció
issuing_state	string	Sí	Codi de país alfa-3 ISO 3166-1. Utilitza CRI.
services	string	Sí	Identificador de servei. Utilitza cri_cedula.
personal_number	string	Sí	Número de persona.
first_name	string	No	Nom (comprovació opcional).
last_name	string	No	Cognom (comprovació opcional).

Exemple de sol·licitud

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"

Exemple de resposta (coincidència concloent)

{
  "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"
      }
    }
  ]
}

Rendiment i cobrament

• Latència: normalment uns quants segons.
• Cost: 0,20$ per consulta concloent. Se't cobra només per resultats confirmats — sense càrrec per temps d'inactivitat de la font, camps que falten o rebuigs pre-font.
• Fiabilitat: s'executa a la infraestructura de Didit amb un objectiu de temps d'activitat trimestral del 99,9%.

Casos d'ús

• Fintech i neobancs — confirma un titular de compte real i verificable abans d'obrir una cartera o concedir crèdit a Costa Rica.
• Crypto i Web3 — compleix els requisits d'incorporació de VASP amb una prova d'identitat de font autoritària.
• Préstecs — redueix el frau d'identitat sintètica i la primera part amb dades verificades a la font.
• Mercats i plataformes de treball temporal — verifica els usuaris amb dades autoritàries, no només amb un formulari auto-declarat.
• iGaming — compleix les comprovacions d'identitat i d'elegibilitat per als jugadors de Costa Rica amb un registre auditable.

Com integrar-se amb Didit

Pots executar la verificació de la Cèdula de Costa Rica de dues maneres:

1. Flux de treball sense codi. A la consola de negocis de Didit, obre el creador de fluxos de treball, afegeix el mòdul Validació de base de dades, selecciona Costa Rica → Verificació de la Cèdula de Costa Rica i activa'l. Els usuaris coincidents s'encaminen automàticament — no es requereix enginyeria.
2. API directa. Truca a l'endpoint /v3/database-validation/ mostrat anteriorment amb services=cri_cedula. Llegeix match_type i el bloc de validation per camp per impulsar la teva lògica d'aprovació / revisió / rebuig.

Cada compte de Didit inclou 500 verificacions gratuïtes al mes, perquè puguis provar tot el flux de principi a fi abans de pagar per una única consulta.

Preguntes freqüents

Què confirma la verificació de la Cèdula de Costa Rica?

Valida les dades enviades amb el registre d'identitat oficial del govern i retorna un resultat de coincidència normalitzat, perquè sàpigues si la identificació nacional existeix a la font autoritària i quins camps van coincidir.

Què passa si la font no està temporalment disponible?

No se't cobrarà. El cobrament s'aplica només a resultats confirmats — temps d'inactivitat de la font, camps que falten i rebuigs pre-font són gratuïts.

Com de ràpida és la comprovació?

La validació de la base de dades normalment retorna en uns quants segons, de manera que s'adapta a un flux d'incorporació en temps real.

Necessito un SDK?

No. La comprovació és un únic POST HTTPS a un endpoint. També pots connectar-lo a un flux de treball sense codi a la Consola de negocis.

A punt per començar?

Valida la teva primera identificació nacional de Costa Rica avui mateix.

• Llegeix la referència de l'API: Verificació de la Cèdula de Costa Rica
• Consulta totes les validacions de bases de dades: Preus i cobertura de la validació de bases de dades
• Comença a construir: Crea un compte gratuït de Didit — 500 verificacions al mes, gratuïtament.