哥斯达黎加身份证验证API (ZH)

在哥斯达黎加注册用户时，需要确认其身份。验证哥斯达黎加身份证，与最高选举法院的公民登记处进行核对。仅凭文件或手动输入的信息，只能证明数据存在，而无法确定其真实性以及是否属于您面前的人。哥斯达黎加身份证验证通过将数据与国家官方政府身份登记处进行核对，从而弥补了这一差距。本指南将介绍验证内容、确切的技术细节以及如何在几分钟内完成集成。

主要收获：

• 验证内容 — 哥斯达黎加身份证验证会将国民身份证与国家官方政府身份登记处进行核对。
• 返回结果 — 规范化的match_type，以及您可以直接导入批准/审查/拒绝逻辑的字段级结果。
• 重要意义 — 文件可能会被伪造；登记记录无法被伪造。将身份证与权威政府来源进行核对，可以确认持证人的真实身份和正确身份信息。
• 使用方法 — 向Didit的数据库验证端点发送一个POST请求，或者使用无需编码的工作流模块。每次确凿查询费用为0.20美元，结果将在几秒钟内返回。

哥斯达黎加身份证验证验证内容

验证哥斯达黎加身份证，与最高选举法院的公民登记处进行核对。Didit通过单个端点公开此服务，以便您可以将提交的数据与国家官方政府身份登记处进行核对，并接收结构化、规范化的结果，而无需自行解析原始登记记录。

确凿的响应将返回匹配的source_data和每个字段的validation块，以便您的风险引擎获得清晰、机器可读的判断。

重要意义

文件可能会被伪造；登记记录无法被伪造。将身份证与权威政府来源进行核对，可以确认持证人的真实身份和正确身份信息。

对于哥斯达黎加的受监管企业（例如金融科技公司、加密平台、贷款机构、市场和游戏运营商），与权威来源进行核对可以生成可防御、可审计的记录，证明身份已在来源处确认，而不仅仅是从表格或照片中获取。

技术细节

Didit通过统一的数据库验证端点公开此服务。只需一个POST请求，无需SDK。

端点

POST /v3/database-validation/

请求参数

参数	类型	必需	描述
issuing_state	string	是	ISO 3166-1 alpha-3国家代码。使用CRI。
services	string	是	服务标识符。使用cri_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=CRI" \
  -F "services=cri_cedula" \
  -F "personal_number=1111111"

示例响应（确凿匹配）

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

性能和计费

• 延迟：通常几秒钟。
• 费用：每次确凿查询0.20美元。仅对确凿结果计费，源端停机、缺少字段或源端前置拒绝不收费。
• 可靠性：在Didit的基础设施上运行，季度正常运行时间目标为99.9%。

使用场景

• 金融科技和新银行 — 在哥斯达黎加开设钱包或提供信贷前，确认真实的、可验证的账户持有人。
• 加密和Web3 — 通过权威来源的身份证明来满足VASP入职要求。
• 贷款 — 通过源验证的数据减少合成身份和第一方欺诈。
• 市场和零工平台 — 验证用户身份，而不仅仅是自我报告的表格。
• iGaming — 满足哥斯达黎加玩家的身份和资格检查，并提供可审计的记录。

如何与Didit集成

可以通过两种方式运行哥斯达黎加身份证验证：

1. 无需编码的工作流。在Didit Business Console中，打开Workflow Builder，添加Database Validation模块，选择Costa Rica → Costa Rica Cédula Verification，然后激活它。匹配的用户将自动路由 — 无需工程。
2. 直接API。使用上面显示的/v3/database-validation/端点，并将services=cri_cedula。读取match_type和每个字段的validation块，以驱动您的批准/审查/拒绝逻辑。

每个Didit帐户每月包含500次免费验证，因此您可以在付费查询之前测试整个流程。

常见问题解答

哥斯达黎加身份证验证检查确认了什么？

它将提交的数据与国家官方政府身份登记处进行核对，并返回规范化的匹配结果，以便您可以了解国民身份证是否存在于权威来源，以及哪些字段匹配。

如果源暂时不可用怎么办？

您无需付费。仅对确凿结果计费 — 源端停机、缺少字段和源端前置拒绝免费。

检查速度有多快？

数据库验证通常在几秒钟内返回，因此适合实时注册流程。

我需要SDK吗？

不需要。检查是向一个端点发送的单个HTTPS POST请求。您也可以将其连接到Business Console中的无需编码的工作流。

准备好开始了吗？

立即验证您的第一个哥斯达黎加国民身份证。

• 阅读API参考： 哥斯达黎加身份证验证
• 查看所有数据库验证： 数据库验证定价和覆盖范围
• 开始构建： 创建一个免费的Didit帐户 — 免费每月500次验证。