危地马拉DPI验证API接口 (ZH)
实时验证危地马拉国民身份证件是否与该国官方政府身份登记机构匹配，仅根据确凿结果计费。包括端点、参数、响应模式、定价和集成。.
在危地马拉进行用户入驻意味着要确认他们是否如其所声称。此服务可根据危地马拉国家人口登记处（RENAP）的民事登记信息验证危地马拉DPI。仅凭文件或输入的详细信息只能证明数据存在，而不能证明其真实性或属于面前之人。危地马拉DPI验证通过将数据与该国官方政府身份登记机构进行比对来弥补这一差距。本指南将解释此项检查的功能、具体技术细节以及如何在几分钟内完成集成。
主要内容：
- 检查内容 — 危地马拉DPI验证将国民身份证件与该国官方政府身份登记机构进行比对。
- 返回结果 — 标准化的
match_type以及字段级结果，您可以直接将其导入批准/审核/拒绝逻辑。 - 重要性 — 文件可能被伪造，而登记记录则不能。根据权威政府来源验证ID可确认持有者真实且身份正确。
- 使用方法 — 向Didit的数据库验证端点发送一个
POST请求，或使用无代码工作流模块。每次确凿查询收费0.20美元，几秒内即可获得结果。
危地马拉DPI验证内容
根据RENAP民事登记信息验证危地马拉DPI。Didit通过单一端点提供此服务，因此您可以将提交的数据与该国官方政府身份登记机构进行验证，并接收结构化、标准化的结果，而不是您需要自行解析的原始登记数据。
确凿响应会返回匹配的source_data和一个字段级validation块，因此您的风险引擎可以获得清晰、机器可读的判断。
重要性
文件可能被伪造，而登记记录则不能。根据权威政府来源验证ID可确认持有者真实且身份正确。
对于危地马拉受监管的企业——金融科技、加密平台、贷款机构、市场和游戏运营商——对照权威来源进行检查，可生成可辩护、可审计的记录，证明身份已在源头确认，而不仅仅是从表格或照片中获取。
技术细节
Didit通过统一的数据库验证端点提供此服务。它是一个单一的POST请求——无需SDK。
端点
POST /v3/database-validation/请求参数
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
issuing_state | string | 是 | ISO 3166-1 alpha-3 国家代码。使用GTM。 |
services | string | 是 | 服务标识符。使用gtm_dpi。 |
document_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=GTM" \
-F "services=gtm_dpi" \
-F "document_number=1111111"响应示例（确凿匹配）
{
"request_id": "req_01H...",
"status": "Approved",
"issuing_state": "GTM",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "gtm_dpi",
"service_name": "Guatemala - DPI 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集成
您可以通过两种方式运行危地马拉DPI验证：
- 无代码工作流。在Didit业务控制台中，打开工作流构建器，添加数据库验证模块，选择危地马拉 → 危地马拉DPI验证，然后激活。匹配的用户将自动路由——无需工程开发。
- 直接API。使用
services=gtm_dpi调用上述/v3/database-validation/端点。读取match_type和字段级validation块以驱动您的批准/审核/拒绝逻辑。
每个Didit账户每月包含500次免费验证，因此您可以在支付任何查询费用之前，完整测试整个流程。
常见问题
危地马拉DPI验证检查确认了什么？
它根据该国官方政府身份登记机构验证提交的数据，并返回一个标准化的匹配结果，因此您可以了解国民身份证件是否存在于权威来源以及哪些字段匹配。
如果源系统暂时不可用会怎样？
您无需付费。计费仅适用于确凿结果——源系统停机、字段缺失和预源拒绝是免费的。
检查速度有多快？
数据库验证通常在几秒钟内返回，因此它适用于实时入驻流程。
我需要SDK吗？
不需要。该检查是对一个端点发送的单一HTTPS POST请求。您也可以在业务控制台中将其连接到无代码工作流。
准备好开始了吗？
立即验证您的第一个危地马拉国民身份证件。
- 阅读API参考： 危地马拉DPI验证
- 查看所有数据库验证： 数据库验证定价与覆盖范围
- 开始构建： 创建免费Didit账户 — 每月500次免费验证。