美国消费者验证API接口 (ZH)
实时验证美国地址和居民数据，对照权威居民和消费者数据源进行核查，仅对确凿结果收费。了解端点、参数、响应模式、定价及集成方式。.
在美国，新用户入驻意味着要确认他们身份的真实性。将输入数据验证到潜在客户生成数据库。文件或输入的信息仅能证明数据存在，但不能证明其真实性或属于当前用户。美国消费者验证通过将数据与权威的居民和消费者数据源进行核对，从而弥补了这一空白。本指南将解释此验证的作用、具体技术细节以及如何在几分钟内完成集成。
关键要点：
- 验证内容 — 美国消费者验证会根据权威的居民和消费者数据源验证地址和居民数据。
- 返回结果 — 标准化的
match_type以及字段级别的结果，您可以直接将其用于批准/审核/拒绝逻辑。 - 重要性 — 对照权威数据进行地址验证，确认申请人确实居住在他们声称的地址，这是核心的反欺诈和合规信号。
- 使用方法 — 向Didit的数据库验证端点发送一个
POST请求，或使用无代码工作流模块。每次确凿查询0.08美元，数秒内即可获得结果。
美国消费者验证的内容
Didit通过单个端点提供此服务，以便您可以根据权威的居民和消费者数据源验证提交的数据，并接收结构化、标准化的结果——而不是您需要自行解析的原始注册表转储。
确凿的响应会返回匹配的source_data和一个按字段划分的validation块，因此您的风险引擎会获得清晰、机器可读的结论。
重要性
对照权威数据进行地址验证，确认申请人确实居住在他们声称的地址，这是核心的反欺诈和合规信号。
对于美国的受监管企业——金融科技公司、加密平台、贷款机构、市场和游戏运营商——对照权威来源进行核查会产生可辩护、可审计的记录，证明身份是在源头确认的，而不仅仅是从表格或照片中获取的。
技术细节
Didit通过统一的数据库验证端点提供此服务。它是一个简单的POST请求——无需SDK。
端点
POST /v3/database-validation/请求参数
| 参数 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
issuing_state | string | 是 | ISO 3166-1 alpha-3 国家代码。使用USA。 |
services | string | 是 | 服务标识符。使用usa_states_consumer。 |
first_name | string | 是 | 名字。 |
last_name | string | 是 | 姓氏。 |
date_of_birth | string | 是 | 出生日期。 |
address | string | 否 | 地址（可选交叉核对）。 |
phone | string | 否 | 电话（可选交叉核对）。 |
email | string | 否 | 电子邮件（可选交叉核对）。 |
示例请求
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=USA" \
-F "services=usa_states_consumer" \
-F "first_name=John" \
-F "last_name=Doe" \
-F "date_of_birth=1990-01-01"示例响应（确凿匹配）
{
"request_id": "req_01H...",
"status": "Approved",
"issuing_state": "USA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "usa_states_consumer",
"service_name": "United States of America - United States Consumer",
"source_data": {
"address": "123 Sample Street",
"address_match_score": "1.000",
"city": "Sample City",
"date_of_birth": "1990-01-01",
"first_name": "John",
"full_name": "John Doe",
"last_name": "Doe",
"name_match_score": "1.000",
"postal_code": "10001",
"state": "Sample State",
"street": "sample_value",
"verifications": {
"address": true,
"date_of_birth": true,
"full_name": true
}
},
"validation": {
"address": "full_match",
"date_of_birth": "full_match",
"full_name": "full_match"
}
}
]
}性能与计费
- 延迟：通常只需几秒钟。
- 费用：每次确凿查询0.08美元。仅对确凿结果收费——源系统停机、缺失字段或源系统前拒绝不收费。
- 可靠性：在Didit基础设施上运行，季度正常运行时间目标为99.9%。
应用场景
- 金融科技和数字银行 — 在美国开设钱包或提供信用之前，确认真实的、可验证的账户持有人。
- 加密货币和Web3 — 通过权威来源的身份证明，满足VASP入驻要求。
- 贷款 — 通过源验证数据减少合成身份和第一方欺诈。
- 市场和零工平台 — 对比权威数据验证用户，而不仅仅是自报表格。
- iGaming — 为美国玩家满足身份和资格检查，并提供可审计的线索。
如何与Didit集成
您可以通过两种方式运行美国消费者验证：
- 无代码工作流。在Didit业务控制台中，打开工作流构建器，添加数据库验证模块，选择美国 → 美国消费者验证，然后激活它。匹配的用户将自动路由——无需工程开发。
- 直接API。使用
services=usa_states_consumer调用上述/v3/database-validation/端点。读取match_type和按字段划分的validation块，以驱动您的批准/审核/拒绝逻辑。
每个Didit账户每月包含500次免费验证，因此您可以在支付任何查询费用之前，端到端测试整个流程。
常见问题
美国消费者验证检查确认了什么？
它根据权威的居民和消费者数据源验证提交的数据，并返回标准化的匹配结果，因此您可以了解地址和居民数据是否存在于权威来源以及哪些字段匹配。
如果源系统暂时不可用会发生什么？
您无需付费。计费仅适用于确凿结果——源系统停机、缺失字段和源系统前拒绝都是免费的。
检查速度有多快？
数据库验证通常在几秒钟内返回，因此它适用于实时入驻流程。
我需要SDK吗？
不需要。该检查是对一个端点的单个HTTPS POST请求。您也可以将其连接到业务控制台中的无代码工作流。
准备好开始了吗？
立即验证您的第一个美国地址和居民数据。
- 阅读API参考： 美国消费者验证
- 查看所有数据库验证： 数据库验证定价与覆盖范围
- 开始构建： 创建免费的Didit账户——每月500次免费验证。