API de Verificació de Cédula a Colòmbia (CA)

Incorporar usuaris a Colòmbia significa confirmar que són qui diuen ser. Didit verifica les dades de la Cédula de Ciudadanía colombiana a través del seu proveïdor de verificació d'identitat a Colòmbia. Un document o una dada introduïda només demostra que la dada existeix, no que sigui genuïna o que pertanyi a la persona que teniu al davant. La Verificació de Cédula de Colòmbia tanca aquesta bretxa comprovant les dades amb el registre d'identitat oficial del govern del país. 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 Cédula de Colòmbia valida la identificació nacional amb el registre d'identitat oficial del govern del país.
• Què s'obté — un match_type normalitzat més resultats a nivell de camp que podeu dirigir directament a la lògica d'aprovació / revisió / rebuig.
• Per què és important — Un document pot ser falsificat; un registre no. Validar la identificació amb la font governamental autoritzada confirma que el titular és real i està correctament identificat.
• Com utilitzar-lo — un POST a l'endpoint de validació de bases 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 Cédula de Colòmbia

Verifica les dades de la Cédula de Ciudadanía colombiana a través del proveïdor de verificació d'identitat de Didit a Colòmbia. Didit l'exposa a través d'un únic endpoint perquè pugueu verificar les dades enviades amb el registre d'identitat oficial del govern del país i rebre un resultat estructurat i normalitzat, no un abocament de registre en brut que hàgiu d'analitzar vosaltres mateixos.

Una resposta concloent retorna les source_data coincidents i un bloc de validation per camp, de manera que el vostre motor de risc obté un veredicte clar i llegible per màquina.

Per què és important

Un document pot ser falsificat; un registre no. Validar la identificació amb la font governamental autoritzada confirma que el titular és real i està correctament identificat.

Per a les empreses regulades a Colòmbia — fintechs, plataformes de criptomonedes, prestadors, mercats i operadors de jocs — la comprovació amb una font autoritzada 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 bases de dades. És un únic POST — no cal SDK.

Endpoint

POST /v3/database-validation/

Paràmetres de la sol·licitud

Paràmetre	Tipus	Requerit	Descripció
issuing_state	string	Sí	Codi de país ISO 3166-1 alpha-3. Utilitzeu COL.
services	string	Sí	Identificador del servei. Utilitzeu col_cedula.
personal_number	string	Sí	Número personal.
first_name	string	No	Nom (comprovació creuada opcional).
last_name	string	No	Cognom (comprovació creuada 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=COL" \
  -F "services=col_cedula" \
  -F "personal_number=1111111"

Exemple de resposta (coincidència concloent)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "COL",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "col_cedula",
      "service_name": "Colombia - Cédula verification",
      "source_data": {
        "document_type": "sample_value",
        "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 facturació

• Latència: normalment un parell de segons.
• Cost: 0,20 $ per consulta concloent. Se us facturarà només pels resultats concloents — sense càrrec per temps d'inactivitat de la font, camps que falten o rebuigs previs a la font.
• Fiabilitat: funciona amb la infraestructura de Didit amb un objectiu de temps d'activitat trimestral del 99,9%.

Casos d'ús

• Fintech i neobancs — confirmeu un titular de compte real i verificable abans d'obrir una cartera o concedir crèdit a Colòmbia.
• Crypto i Web3 — compliu els requisits d'incorporació de VASP amb proves d'identitat de font autoritzada.
• Préstecs — reduïu el frau d'identitat sintètica i de primera part amb dades verificades per la font.
• Mercats i plataformes de serveis — verifiqueu els usuaris amb dades autoritzades, no només un formulari autoreportat.
• iGaming — compliu les comprovacions d'identitat i elegibilitat per als jugadors de Colòmbia amb un registre auditable.

Com integrar amb Didit

Podeu executar la Verificació de Cédula de Colòmbia de dues maneres:

1. Flux de treball sense codi. A la consola de negocis de Didit, obriu el Creador de fluxos de treball, afegiu el mòdul Validació de base de dades, seleccioneu Colòmbia → Verificació de Cédula de Colòmbia i activeu-lo. Els usuaris coincidents s'encaminen automàticament — no cal enginyeria.
2. API directa. Truqueu a l'endpoint /v3/database-validation/ mostrat anteriorment amb services=col_cedula. Llegiu match_type i el bloc de validation per camp per impulsar la vostra lògica d'aprovació / revisió / rebuig.

Cada compte de Didit inclou 500 verificacions gratuïtes al mes, de manera que podeu provar tot el flux de principi a fi abans de pagar per una sola consulta.

Preguntes freqüents

Què confirma la comprovació de Verificació de Cédula de Colòmbia?

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

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

No se us cobrarà. La facturació només s'aplica als resultats concloents — el temps d'inactivitat de la font, els camps que falten i els rebuigs previs a la font són gratuïts.

Quina rapidesa té la comprovació?

La validació de la base de dades normalment es retorna en un parell de 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é podeu connectar-la a un flux de treball sense codi a la consola de negocis.

Llestos per començar?

Valideu avui mateix la vostra primera identificació nacional de Colòmbia.

• Llegiu la referència de l'API: Verificació de Cédula de Colòmbia
• Vegeu totes les validacions de bases de dades: Preus i cobertura de la validació de bases de dades
• Comenceu a construir: Creeu un compte Didit gratuït — 500 verificacions al mes, gratuïtes.