API de Vérification de Cédula en Colombie : Guide Complet

L'intégration de nouveaux utilisateurs en Colombie implique de confirmer leur identité. Didit vérifie les données de la Cédula de Ciudadanía colombienne via son fournisseur de vérification d'identité. Un document ou une saisie manuelle prouve seulement que les données existent, pas qu'elles sont authentiques ou qu'elles appartiennent à la personne concernée. La vérification de Cédula en Colombie comble cette lacune en comparant les données avec le registre d'identité officiel du gouvernement. Ce guide explique le fonctionnement de cette vérification, les détails techniques exacts et comment l'intégrer en quelques minutes.

Points clés à retenir :

• Ce qu'elle vérifie — La vérification de Cédula en Colombie valide l'identifiant national par rapport au registre d'identité officiel du gouvernement du pays.
• Ce que vous obtenez — un match_type normalisé ainsi que des résultats par champ que vous pouvez directement intégrer dans votre logique d'approbation / révision / rejet.
• Pourquoi c'est important — Un document peut être falsifié ; un enregistrement de registre ne le peut pas. La validation de l'identifiant par rapport à la source gouvernementale faisant autorité confirme que le titulaire est réel et correctement identifié.
• Comment l'utiliser — une seule requête POST vers le point de terminaison de validation de base de données de Didit, ou un module de flux de travail sans code. 0,20 $ par requête concluante, résultats en quelques secondes.

Ce que la vérification de Cédula en Colombie valide

Elle vérifie les données de la Cédula de Ciudadanía colombienne par l'intermédiaire du fournisseur de vérification d'identité de Didit en Colombie. Didit l'expose via un point de terminaison unique afin que vous puissiez vérifier les données soumises par rapport au registre d'identité officiel du gouvernement du pays et recevoir un résultat structuré et normalisé — et non un simple extrait de registre brut que vous devriez analyser vous-même.

Une réponse concluante renvoie le source_data correspondant et un bloc de validation par champ, afin que votre moteur de risque obtienne un verdict clair et lisible par machine.

Pourquoi c'est important

Un document peut être falsifié ; un enregistrement de registre ne le peut pas. La validation de l'identifiant par rapport à la source gouvernementale faisant autorité confirme que le titulaire est réel et correctement identifié.

Pour les entreprises réglementées en Colombie — fintechs, plateformes de crypto-monnaies, prêteurs, places de marché et opérateurs de jeux — la vérification par rapport à une source faisant autorité produit un enregistrement défendable et vérifiable que l'identité a été confirmée à la source, et non pas simplement capturée à partir d'un formulaire ou d'une photo.

Détails techniques

Didit expose ce service via le point de terminaison unifié de validation de base de données. Il s'agit d'une simple requête POST — aucun SDK n'est requis.

Point de terminaison

POST /v3/database-validation/

Paramètres de requête

Paramètre	Type	Requis	Description
issuing_state	string	Oui	Code pays ISO 3166-1 alpha-3. Utilisez COL.
services	string	Oui	Identifiant du service. Utilisez col_cedula.
personal_number	string	Oui	Numéro personnel.
first_name	string	Non	Prénom (vérification croisée facultative).
last_name	string	Non	Nom de famille (vérification croisée facultative).

Exemple de requête

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 réponse (correspondance concluante)

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

Performance et facturation

• Latence : généralement quelques secondes.
• Coût : 0,20 $ par requête concluante. Vous n'êtes facturé que sur les résultats concluants — aucun frais pour l'indisponibilité de la source, les champs manquants ou les rejets avant la source.
• Fiabilité : fonctionne sur l'infrastructure de Didit avec un objectif de disponibilité trimestriel de 99,9 %.

Cas d'utilisation

• Fintech et néobanques — confirmez qu'un titulaire de compte est réel et vérifiable avant d'ouvrir un portefeuille ou d'accorder un crédit en Colombie.
• Crypto et Web3 — répondez aux exigences d'intégration VASP avec une preuve d'identité provenant d'une source faisant autorité.
• Prêts — réduisez la fraude d'identité synthétique et de première partie avec des données vérifiées à la source.
• Places de marché et plateformes de services — vérifiez les utilisateurs par rapport à des données faisant autorité, et non pas seulement à un formulaire auto-déclaré.
• iGaming — satisfaites les vérifications d'identité et d'éligibilité pour les joueurs colombiens avec une piste d'audit.

Comment intégrer avec Didit

Vous pouvez effectuer la vérification de Cédula en Colombie de deux manières :

1. Flux de travail sans code. Dans la console Didit Business, ouvrez le Workflow Builder, ajoutez le module Validation de base de données, sélectionnez Colombie → Vérification de Cédula en Colombie et activez-le. Les utilisateurs correspondants sont acheminés automatiquement — aucune ingénierie requise.
2. API directe. Appelez le point de terminaison /v3/database-validation/ indiqué ci-dessus avec services=col_cedula. Lisez match_type et le bloc validation par champ pour piloter votre logique d'approbation / révision / rejet.

Chaque compte Didit comprend 500 vérifications gratuites par mois, vous pouvez donc tester le flux complet de bout en bout avant de payer pour une seule requête.

Questions fréquemment posées

Que confirme la vérification de Cédula en Colombie ?

Elle valide les données soumises par rapport au registre d'identité officiel du gouvernement du pays et renvoie un résultat de correspondance normalisé, afin que vous sachiez si l'identifiant national existe à la source faisant autorité et quels champs correspondent.

Que se passe-t-il si la source est temporairement indisponible ?

Vous n'êtes pas facturé. La facturation s'applique uniquement aux résultats concluants — l'indisponibilité de la source, les champs manquants et les rejets avant la source sont gratuits.

Quelle est la rapidité de la vérification ?

La validation de base de données est généralement renvoyée en quelques secondes, de sorte qu'elle s'intègre dans un flux d'intégration en temps réel.

Ai-je besoin d'un SDK ?

Non. La vérification est une simple requête HTTPS POST vers un seul point de terminaison. Vous pouvez également l'intégrer dans un flux de travail sans code dans la console Business.

Prêt à commencer ?

Validez votre premier identifiant national colombien dès aujourd'hui.

• Lisez la référence de l'API : Vérification de Cédula en Colombie
• Voir toutes les validations de base de données : Tarifs et couverture de la validation de base de données
• Commencez à construire : Créez un compte Didit gratuit — 500 vérifications par mois, gratuites.