Vérification de la Cédula Costaricienne via API (FR)

Intégrer des utilisateurs au Costa Rica implique de confirmer qu'ils sont bien ceux qu'ils prétendent être. Vérifiez la Cédula costaricienne par rapport au registre civil du Tribunal Supremo de Elecciones. Un document ou un détail saisi ne prouve que les données existent — et non qu'elles soient authentiques ou appartiennent à la personne qui se tient devant vous. La vérification de la Cédula costaricienne comble cette lacune en vérifiant les données par rapport au registre officiel d'identité du gouvernement du pays. Ce guide explique ce que fait la vérification, les détails techniques exacts et comment l'intégrer en quelques minutes.

Points clés :

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

Ce que valide la vérification de la Cédula costaricienne

Vérifie la Cédula costaricienne par rapport au registre civil du Tribunal Supremo de Elecciones. Didit l'expose via un seul point de terminaison afin que vous puissiez vérifier les données soumises par rapport au registre officiel d'identité du gouvernement du pays et recevoir un résultat structuré et normalisé — et non un vidage de registre brut que vous devez analyser vous-même.

Une réponse concluante renvoie les source_data correspondants et un bloc 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 contrefait ; un enregistrement du registre ne peut pas l'être. La validation de la pièce d'identité par rapport à la source gouvernementale faisant autorité confirme que le titulaire est réel et correctement identifié.

Pour les entreprises réglementées au Costa Rica — fintechs, plateformes de crypto-monnaies, 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 confirmant que l'identité a été confirmée à la source, et non 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'un seul POST — aucun SDK requis.

Point d'accès

POST /v3/database-validation/

Paramètres de requête

Paramètre	Type	Obligatoire	Description
issuing_state	string	Oui	Code pays ISO 3166-1 alpha-3. Utilisez CRI.
services	string	Oui	Identifiant du service. Utilisez cri_cedula.
personal_number	string	Oui	Numéro personnel.
first_name	string	Non	Prénom (contre-vérification facultative).
last_name	string	Non	Nom de famille (contre-vérification 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=CRI" \ 
  -F "services=cri_cedula" \ 
  -F "personal_number=1111111"

Exemple de réponse (correspondance concluante)

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

Performances et facturation

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

Cas d'utilisation

• Fintech et néobanques — confirmez un titulaire de compte réel et vérifiable avant d'ouvrir un portefeuille ou d'accorder un crédit au Costa Rica.
• Crypto et Web3 — respectez les 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 la fraude de première partie avec des données vérifiées à la source.
• Marchés et plateformes de services à la demande — vérifiez les utilisateurs par rapport à des données faisant autorité, et non pas seulement à un formulaire auto-déclaré.
• iGaming — satisfaites aux exigences de vérification d'identité et d'éligibilité des joueurs costaricains avec un suivi auditable.

Comment s'intégrer à Didit

Vous pouvez exécuter la vérification de la Cédula costaricienne de deux manières :

1. Workflow sans code. Dans la console commerciale Didit, ouvrez le Workflow Builder, ajoutez le module Validation de base de données, sélectionnez Costa Rica → Vérification de la Cédula costaricienne et activez-le. Les utilisateurs correspondants sont routés automatiquement — aucune compétence en ingénierie n'est requise.
2. API directe. Appelez le point de terminaison /v3/database-validation/ indiqué ci-dessus avec services=cri_cedula. Lisez match_type et le bloc validation par champ pour piloter votre logique d'approbation / d'examen / de rejet.

Chaque compte Didit comprend 500 vérifications gratuites par mois, afin que vous puissiez tester l'ensemble du flux de bout en bout avant de payer pour une seule requête.

Foire aux questions

Que confirme la vérification de la Cédula costaricienne ?

Elle valide les données soumises par rapport au registre officiel d'identité du gouvernement du pays et renvoie un résultat de correspondance normalisé, afin que vous puissiez savoir si la pièce d'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 ne s'applique qu'aux résultats concluants — les temps d'arrêt de la source, les champs manquants et les rejets pré-source sont gratuits.

Quelle est la vitesse de la vérification ?

La validation de la base de données renvoie généralement en quelques secondes, ce qui convient à un flux d'intégration en temps réel.

Ai-je besoin d'un SDK ?

Non. La vérification est un seul POST HTTPS vers un point de terminaison. Vous pouvez également la connecter à un workflow sans code dans la console commerciale.

Prêt à commencer ?

Validez votre première pièce d'identité nationale costaricienne dès aujourd'hui.

• Consultez la documentation de l'API : Vérification de la Cédula costaricienne
• Consultez toutes les validations de base de données : Tarifs et couverture de la validation de base de données
• Commencez à développer : Créez un compte Didit gratuit — 500 vérifications par mois, gratuites.