API de Vérification de Cédula en Colombie (FR-1)

L'intégration d'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 information saisie prouve seulement que les données existent, mais 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 :

• Ce qu'elle vérifie — La Vérification de Cédula en Colombie valide l'identité nationale 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 une logique d'approbation / examen / rejet.
• Pourquoi c'est important — Un document peut être falsifié ; un enregistrement de registre non. La validation de l'identité par rapport à la source gouvernementale faisant autorité confirme que le titulaire est réel et correctement identifié.
• Comment l'utiliser — un POST unique vers le point d'accès 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

Didit vérifie les données de la Cédula de Ciudadanía colombienne via son fournisseur de vérification d'identité. Didit l'expose via un point d'accès 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 brut du registre que vous devriez analyser vous-même.

Une réponse concluante renvoie les source_data correspondantes et un bloc de validation par champ, de sorte 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 non. La validation de l'identité 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 crypto, prêteurs, marchés et opérateurs de jeux — la vérification par rapport à une source faisant autorité produit un enregistrement défendable et auditable selon lequel l'identité a été confirmée à la source, et non simplement saisie à partir d'un formulaire ou d'une photo.

Détails techniques

Didit expose ce service via le point d'accès unifié de validation de base de données. Il s'agit d'un POST unique — aucun SDK n'est requis.

Point d'accès

POST /v3/database-validation/

Paramètres de requête

Paramètre	Type	Requis	Description
issuing_state	chaîne de caractères	Oui	Code pays ISO 3166-1 alpha-3. Utilisez COL.
services	chaîne de caractères	Oui	Identifiant de service. Utilisez col_cedula.
personal_number	chaîne de caractères	Oui	Numéro personnel.
first_name	chaîne de caractères	Non	Prénom (vérification croisée facultative).
last_name	chaîne de caractères	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": "Colombie - Vérification de Cédula",
      "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 : typiquement quelques secondes.
• Coût : 0,20 $ par requête concluante. Vous n'êtes facturé que pour les résultats concluants — aucun frais pour les temps d'arrêt 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 du VASP avec une preuve d'identité provenant d'une source faisant autorité.
• Prêt — réduisez la fraude d'identité synthétique et de première partie avec des données vérifiées à la source.
• Marchés 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 — satisfaire les contrôles d'identité et d'éligibilité pour les joueurs colombiens avec une piste d'audit.

Comment s'intégrer à 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 d'entreprise Didit, ouvrez le Générateur de flux de travail, 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 n'est requise.
2. API directe. Appelez le point d'accès /v3/database-validation/ indiqué ci-dessus avec services=col_cedula. Lisez le match_type et le bloc de validation par champ pour piloter votre logique d'approbation / examen / rejet.

Chaque compte Didit inclut 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 le contrôle de Vérification de Cédula en Colombie ?

Il 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'identité nationale 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 — les temps d'arrêt de la source, les champs manquants et les rejets avant la source sont gratuits.

Quelle est la rapidité du contrôle ?

La validation de la base de données retourne généralement un résultat en quelques secondes, elle s'intègre donc dans un flux d'intégration en temps réel.

Ai-je besoin d'un SDK ?

Non. Le contrôle est un simple POST HTTPS vers un seul point d'accès. Vous pouvez également l'intégrer dans un flux de travail sans code depuis la Console d'entreprise.

Prêt à commencer ?

Validez votre première identité nationale colombienne dès aujourd'hui.

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