哥伦比亚公民证验证API (ZH)
实时验证哥伦比亚国民身份证与该国官方政府身份登记系统的信息，仅对确凿结果收费。了解端点、参数、响应模式、定价及集成方式。.
在哥伦比亚，新用户注册需要确认其身份的真实性。Didit通过哥伦比亚身份验证服务提供商，验证哥伦比亚公民证（Cédula de Ciudadanía）数据。文件或手动输入的详细信息仅能证明数据存在，而不能证明其真实性或属于面前的个人。哥伦比亚公民证验证通过与该国官方政府身份登记系统核对数据，弥补了这一空白。本指南将解释此验证的功能、具体技术细节以及如何在几分钟内完成集成。
主要内容：
- 验证内容 — 哥伦比亚公民证验证对照该国官方政府身份登记系统，验证国民身份证。
- 返回结果 — 标准化的
match_type以及字段级别的结果，可直接用于批准/审查/拒绝逻辑。 - 重要性 — 文件可能被伪造；登记记录则不能。对照权威政府来源验证ID，可确认持有者真实且身份正确。
- 使用方法 — 向Didit的数据库验证端点发送一个
POST请求，或使用无代码工作流模块。每次确凿查询收费0.20美元，几秒内出结果。
哥伦比亚公民证验证的内容
通过Didit的哥伦比亚身份验证提供商，验证哥伦比亚公民证数据。Didit通过一个统一端点提供此服务，以便您可以对照该国官方政府身份登记系统验证提交的数据，并接收结构化、标准化的结果——而不是需要自行解析的原始登记数据。
确凿的响应会返回匹配的source_data和一个按字段划分的validation块，以便您的风险引擎获得清晰、机器可读的判断。
重要性
文件可能被伪造；登记记录则不能。对照权威政府来源验证ID，可确认持有者真实且身份正确。
对于哥伦比亚的受监管企业——金融科技公司、加密平台、贷款机构、市场平台和游戏运营商——对照权威来源进行检查，可以生成可辩护、可审计的记录，证明身份已在源头确认，而不仅仅是从表格或照片中捕获。
技术细节
Didit通过统一的数据库验证端点提供此服务。这是一个简单的POST请求——无需SDK。
端点
POST /v3/database-validation/请求参数
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
issuing_state | 字符串 | 是 | ISO 3166-1 alpha-3 国家代码。使用COL。 |
services | 字符串 | 是 | 服务标识符。使用col_cedula。 |
personal_number | 字符串 | 是 | 个人号码。 |
first_name | 字符串 | 否 | 名（可选交叉检查）。 |
last_name | 字符串 | 否 | 姓（可选交叉检查）。 |
请求示例
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"
}
}
]
}性能与计费
- 延迟：通常几秒钟。
- 成本：每次确凿查询0.20美元。仅对确凿结果收费——源系统停机、字段缺失或预源拒绝不收费。
- 可靠性：运行在Didit基础设施上，季度正常运行时间目标为99.9%。
使用场景
- 金融科技与数字银行 — 在哥伦比亚开设钱包或提供信贷前，确认真实的、可验证的账户持有人。
- 加密与Web3 — 通过权威来源的身份证明，满足VASP的入职要求。
- 贷款 — 通过源头验证的数据，减少合成身份和第一方欺诈。
- 市场与零工平台 — 对照权威数据，而非仅仅是用户自报的表格，验证用户。
- iGaming — 为哥伦比亚玩家满足身份和资格检查，并提供可审计的跟踪记录。
如何与Didit集成
您可以通过两种方式运行哥伦比亚公民证验证：
- 无代码工作流。在Didit商业控制台中，打开工作流构建器，添加数据库验证模块，选择哥伦比亚 → 哥伦比亚公民证验证，然后激活。匹配的用户将自动路由——无需工程开发。
- 直接API。使用
services=col_cedula调用上述/v3/database-validation/端点。读取match_type和按字段划分的validation块，以驱动您的批准/审查/拒绝逻辑。
每个Didit账户每月包含500次免费验证，因此您可以在支付任何查询费用之前，完整测试整个流程。
常见问题
哥伦比亚公民证验证检查确认什么？
它对照该国官方政府身份登记系统验证提交的数据，并返回标准化的匹配结果，因此您可以了解国民身份证是否存在于权威来源以及哪些字段匹配。
如果源系统暂时不可用怎么办？
您不会被收费。计费仅适用于确凿结果——源系统停机、字段缺失和预源拒绝是免费的。
检查速度有多快？
数据库验证通常在几秒钟内返回，因此它适用于实时入职流程。
我需要SDK吗？
不需要。检查是向一个端点发送一个HTTPS POST请求。您也可以在商业控制台中将其连接到无代码工作流。
准备好开始了吗？
立即验证您的第一个哥伦比亚国民身份证。
- 阅读API参考： 哥伦比亚公民证验证
- 查看所有数据库验证： 数据库验证定价与覆盖范围
- 开始构建： 创建免费Didit账户——每月500次免费验证。