快速开始
集成 / SDK
用户验证
企业验证
交易监控
更新日志curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_company_directors" \
-F "vendor_data=user-1234" \
-F "company_registration_number=11222333000181"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_company_directors",
"service_name": "Brazil - Company Partners and Directors (QSA)",
"source_data": {
"directors": [
{
"document_number": "***.456.789-**",
"entity_type": "person",
"name": "MARIA EXEMPLO DA SILVA",
"role": "SOCIO-ADMINISTRADOR",
"start_date": "2010-03-15"
},
{
"document_number": "11444777000161",
"entity_type": "company",
"name": "HOLDING EXEMPLO S A",
"role": "SOCIO",
"start_date": "2018-06-01"
}
],
"registration_number": "11222333000181"
},
"validation": {}
}
]
}
🇧🇷 巴西
巴西企业股东与董事（QSA）API
通过 Didit 查询巴西权威数据库，获取企业股东与董事（QSA）信息。按次计费，起价 $0.20，无合同，无最低消费。
POST
/
v3
/
database-validation
/
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_company_directors" \
-F "vendor_data=user-1234" \
-F "company_registration_number=11222333000181"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_company_directors",
"service_name": "Brazil - Company Partners and Directors (QSA)",
"source_data": {
"directors": [
{
"document_number": "***.456.789-**",
"entity_type": "person",
"name": "MARIA EXEMPLO DA SILVA",
"role": "SOCIO-ADMINISTRADOR",
"start_date": "2010-03-15"
},
{
"document_number": "11444777000161",
"entity_type": "company",
"name": "HOLDING EXEMPLO S A",
"role": "SOCIO",
"start_date": "2018-06-01"
}
],
"registration_number": "11222333000181"
},
"validation": {}
}
]
}
返回巴西企业在 Receita Federal 登记信息中当前的合伙人与董事（QSA）及其职务和任职开始日期。个人的 CPF 按 Receita Federal 公布的方式显示为掩码。Didit 通过
POST /v3/database-validation/ 提供此服务，以便您将提交的数据与权威数据源进行核对，并获得标准化的匹配结果。
覆盖范围
- 覆盖范围： ~ 100%
- 国家： 巴西
- 服务 ID：
bra_company_directors - 数据域： 政府
- 类别： 公司登记
输入
| 字段 | 必填 | 示例 |
|---|---|---|
company_registration_number | 是 | 11222333000181 |
vendor_data | 否 | user-1234 |
- 必填输入：
company_registration_number - 可选输入：
vendor_data - 同意： 无需
- 工作流可用性： 可在工作流中使用，但需进行字段映射
- 覆盖范围： ~ 100%
- 价格： 每次成功查询 $0.20
company_registration_number 不会印在任何身份证件上，因此没有任何步骤能单独生成它。请从问卷答案、Document AI 提取字段，或您在创建会话时发送的值中收集该字段，并将其映射到数据库核验步骤上。在完成映射之前，工作流编辑器会将此服务显示为禁用状态，并指出缺少的输入。运行时若缺少输入，该检查会在发起任何查询之前跳过，因此对于无法查询的数据库，您不会被计费。
请求体参数
string
默认值:"BRA"
必填
该数据库服务所用的 ISO 3166-1 alpha-3 国家代码。示例：
BRAstring
默认值:"bra_company_directors"
必填
包含此服务 ID 的数组。固定该服务可确保请求仅限于此特定数据库。示例：
bra_company_directorsstring
默认值:"11222333000181"
必填
此数据库服务所需的
company_registration_number 值。示例：11222333000181string
默认值:"user-1234"
您为该用户提供的稳定用户引用，例如您内部的用户 ID。Didit 用它将独立检查关联到同一终端用户，并减少重复检测的干扰。示例：
user-1234输入规则与校验说明
company_registration_number必须匹配[0-9A-Za-z]{2}\.?[0-9A-Za-z]{3}\.?[0-9A-Za-z]{3}/?[0-9A-Za-z]{4}-?\d{2}。
调用方法
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_company_directors" \
-F "vendor_data=user-1234" \
-F "company_registration_number=11222333000181"
每次成功调用都会返回 HTTP 200。outcome_code 字段说明实际发生的情况，例如区分真正的生物识别不匹配（BIOMETRIC_NO_MATCH）与无法读取的自拍照（BIOMETRIC_IMAGE_UNUSABLE）。所示的 status 是默认功能状态；您配置的 部分匹配/无匹配操作 可以覆盖它。MATCH：注册数据源已确认身份，且所有检查字段均匹配。{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_company_directors",
"service_name": "Brazil - Company Partners and Directors (QSA)",
"source_data": {
"directors": [
{
"document_number": "***.456.789-**",
"entity_type": "person",
"name": "MARIA EXEMPLO DA SILVA",
"role": "SOCIO-ADMINISTRADOR",
"start_date": "2010-03-15"
},
{
"document_number": "11444777000161",
"entity_type": "company",
"name": "HOLDING EXEMPLO S A",
"role": "SOCIO",
"start_date": "2018-06-01"
}
],
"registration_number": "11222333000181"
},
"validation": {}
}
]
}
返回数据
source_data 中实际返回的字段取决于注册数据源返回的内容。bra_company_directors 的生成示例目前记录了以下标准化结构：
directorsregistration_number
定价与 SLA
巴西 - 企业合伙人与董事（QSA）查询仅在 Didit 从验证数据源收到明确结果时才计费。- 单次调用价格： $0.20 USD。
- 计费方式： 按每次成功查询计费。若注册数据源无法访问、缺少必填字段，或请求在到达数据源之前即被拒绝，则不收费。
- 延迟： 典型 p95 小于 2 秒。
- 可用性： Didit 方面每季度 99.9%；下游数据源的可用性因国家和数据集而异。
继续阅读
最后修改于 2026年11月7日