コロンビアの身分証明書検証API (JA-1)
コロンビアの国民IDを、国の公式政府身元登録機関に対してリアルタイムで検証します。費用は確定的な結果に対してのみ請求されます。エンドポイント、パラメータ、応答スキーマ、料金、および統合について説明します。.

コロンビアでユーザーをオンボーディングする際には、彼らが主張する人物であることを確認する必要があります。Diditのコロンビア本人確認プロバイダーを通じて、コロンビアのセドゥラ・デ・シウダダニア(Cédula de Ciudadanía)データを検証します。書類や入力された情報は、データが存在することを証明するだけであり、それが本物であることや、目の前の人物のものであることを証明するものではありません。コロンビアのセドゥラ検証は、国の公式政府身元登録機関に対してデータを照合することで、そのギャップを埋めます。このガイドでは、このチェックが何をするのか、正確な技術的詳細、そして数分で統合する方法を説明します。
主なポイント:
- 検証内容 — コロンビアのセドゥラ検証は、国の公式政府身元登録機関に対して国民IDを検証します。
- 取得できる情報 — 正規化された
match_typeと、承認/レビュー/拒否のロジックに直接ルーティングできるフィールドレベルの結果が得られます。 - なぜ重要なのか — 書類は偽造される可能性がありますが、登録記録は偽造できません。信頼できる政府情報源に対してIDを検証することで、所有者が実在し、正しく識別されていることを確認できます。
- 使用方法 — Diditのデータベース検証エンドポイントへの1回の
POST、またはノーコードワークフローモジュールを使用します。確定的なクエリ1回あたり0.20ドルで、数秒で結果が得られます。
コロンビアのセドゥラ検証が検証する内容
Diditのコロンビア本人確認プロバイダーを通じて、コロンビアのセドゥラ・デ・シウダダニアのデータを検証します。Diditはこれを単一のエンドポイントを通じて公開しており、提出されたデータを国の公式政府身元登録機関に対して検証し、構造化された正規化された結果を受け取ることができます。自分で解析する必要のある生の登録データダンプではありません。
確定的な応答は、一致したsource_dataとフィールドごとのvalidationブロックを返し、リスクエンジンが明確で機械が読み取り可能な判断を得られるようにします。
なぜ重要なのか
書類は偽造される可能性がありますが、登録記録は偽造できません。信頼できる政府情報源に対してIDを検証することで、所有者が実在し、正しく識別されていることを確認できます。
コロンビアの規制対象ビジネス(フィンテック、暗号プラットフォーム、貸金業者、マーケットプレイス、ゲーム事業者など)にとって、信頼できる情報源と照合することで、身元がフォームや写真から単に取得されただけでなく、情報源で確認されたという弁護可能で監査可能な記録が作成されます。
技術的な詳細
Diditはこのサービスを統合されたデータベース検証エンドポイントを通じて公開しています。これは単一のPOSTであり、SDKは必要ありません。
エンドポイント
POST /v3/database-validation/
リクエストパラメータ
| パラメータ | タイプ | 必須 | 説明 |
|---|---|---|---|
issuing_state | string | はい | ISO 3166-1 alpha-3 国コード。COLを使用してください。 |
services | string | はい | サービス識別子。col_cedulaを使用してください。 |
personal_number | string | はい | 個人番号。 |
first_name | string | いいえ | 名(オプションのクロスチェック)。 |
last_name | string | いいえ | 姓(オプションのクロスチェック)。 |
リクエスト例
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"
応答例(確定的な一致)
{
"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"
}
}
]
}
パフォーマンスと料金
- レイテンシ:通常数秒。
- 費用:確定的なクエリ1回あたり0.20ドル。確定的な結果に対してのみ請求されます。ソースのダウンタイム、不足しているフィールド、ソース前の拒否には料金はかかりません。
- 信頼性:Diditのインフラストラクチャで稼働し、四半期ごとの稼働時間目標は99.9%です。
ユースケース
- フィンテック&ネオバンク — コロンビアでウォレットを開設したり、信用を供与したりする前に、実在し、検証可能な口座名義人であることを確認します。
- クリプト&Web3 — 信頼できる情報源による本人確認でVASPのオンボーディング要件を満たします。
- 貸付 — ソースで検証されたデータにより、合成ID詐欺や第一者詐欺を減らします。
- マーケットプレイス&ギグプラットフォーム — 自己申告のフォームだけでなく、信頼できるデータに対してユーザーを検証します。
- iGaming — コロンビアのプレイヤーに対する本人確認と資格確認を、監査可能な記録とともに満たします。
Diditとの統合方法
コロンビアのセドゥラ検証は2つの方法で実行できます。
- ノーコードワークフロー。 Diditビジネスコンソールでワークフロービルダーを開き、データベース検証モジュールを追加し、コロンビア → コロンビアのセドゥラ検証を選択してアクティブ化します。一致するユーザーは自動的にルーティングされます。エンジニアリングは不要です。
- 直接API。 上記の
/v3/database-validation/エンドポイントをservices=col_cedulaで呼び出します。match_typeとフィールドごとのvalidationブロックを読み取り、承認/レビュー/拒否のロジックを駆動します。
すべてのDiditアカウントには、毎月500回の無料検証が含まれているため、1回のクエリに対して料金を支払う前に、完全なフローをエンドツーエンドでテストできます。
よくある質問
コロンビアのセドゥラ検証チェックは何を確認しますか?
提出されたデータを国の公式政府身元登録機関に対して検証し、正規化された一致結果を返します。これにより、国民IDが信頼できる情報源に存在するかどうか、およびどのフィールドが一致したかを知ることができます。
ソースが一時的に利用できない場合はどうなりますか?
料金は請求されません。料金は確定的な結果にのみ適用されます。ソースのダウンタイム、不足しているフィールド、ソース前の拒否は無料です。
チェックはどのくらい速いですか?
データベース検証は通常数秒で返されるため、リアルタイムのオンボーディングフローに適合します。
SDKは必要ですか?
いいえ。チェックは、単一のエンドポイントへの1回のHTTPS POSTです。ビジネスコンソールのノーコードワークフローに接続することもできます。
今すぐ始めましょう!
今日、最初のコロンビアの国民IDを検証しましょう。
- APIリファレンスを読む: コロンビアのセドゥラ検証
- すべてのデータベース検証を見る: データベース検証の料金とカバー範囲
- 構築を開始する: 無料のDiditアカウントを作成 — 毎月500回の検証が無料です。