合规与 LGPD
CPFHub.io 的运营遵守 LGPD（巴西《通用数据保护法》，Lei Geral de Proteção de Dados，第 13.709/2018 号法律）以及行业通行的良好实践。
本文档不构成法律意见
本文信息仅供一般参考。如需评估您具体场景下的合规情况，请咨询法律专业人士。
API 返回的数据
API 返回的数据来自 CPFHub.io 验证数据库，由私营数据供应商授权的数据和官方公开来源组成（见隐私政策第 4 节）。API 不提供任何敏感数据（收入、地址、犯罪记录、健康数据）。
| 字段 | 类型 | 来源 |
|---|---|---|
name | 全名 | 验证数据库 |
nameUpper | 大写姓名 | 由姓名派生 |
gender | 性别（M / F） | 验证数据库。来源未提供时，根据名字推断 |
birthDate | 出生日期 | 验证数据库 |
day、month、year | 日期组成部分 | 由日期派生 |
实时查询（POST /cpf/realtime）返回自己的一组字段，在调用时从 Receita Federal（巴西联邦税务局）获取：
| 字段 | 类型 | 来源 |
|---|---|---|
name | 全名 | Receita Federal，按需查询 |
birthDate | 出生日期（由您提供，经 Receita Federal 确认） | Receita Federal，按需查询 |
deathYear | 死亡年份（integer 或 null）。始终存在。没有死亡记录或收到的值无效时为 null。不包含日和月 | Receita Federal，按需查询 |
situation | CPF 的登记状态 | Receita Federal，按需查询 |
emissionDate、emissionTime | 查询凭证的出具日期和时间 | Receita Federal，按需查询 |
controlCode | 查询凭证的控制码 | Receita Federal，按需查询 |
validationUrl | Receita Federal 网站上的核验链接（二维码指向的地址） | Receita Federal，按需查询 |
validationHtmlUrl | CPFHub.io 保存的查询凭证（HTML，含二维码） | 由 CPFHub.io 生成 |
使用的法律依据
客户最常使用的 LGPD 法律依据如下：
第 7 条第 II 款：履行法定或监管义务：受监管的企业（金融机构、保险公司、金融科技公司）可以使用 API 履行客户身份识别和反洗钱（AML）义务。
第 7 条第 IX 款：正当利益：出于反欺诈、平台安全和注册真实性目的进行身份验证，前提是手段适度，并对数据主体保持透明。
第 7 条第 V 款：履行合同：为履行数据主体作为一方的合同，核验合同相对方的数据。
CPFHub.io 的承诺
- 我们不出售任何个人数据名单、数据库或登记信息
- 验证数据库不用于营销或获客
- 我们不返回敏感数据、财务数据或位置数据
- 我们不会向任何客户透露其他客户查询过哪些 CPF
客户（您）的责任
使用 API 时，在您的应用场景中，您是数据的控制者。具体来说，这意味着：
- 每次查询都有正当目的和法律依据
- 在您的隐私政策中告知数据主体，其登记数据可能会通过身份验证和反欺诈服务商进行核验
- 将 API 密钥保存在服务器端，不要暴露在前端
- 仅在实现目的所需的期限内保留查询结果
- 处理数据主体针对您所存储数据提出的请求（访问、更正、删除）
如有疑问，请先咨询
使用条款中列出了用途示例、集成商和合作伙伴的规则，以及我们如何处理超出约定范围的情况。如果不确定您的场景是否适用，请在开始前联系我们。
遵守 ECA Digital（第 15.211/2025 号法律）
第 15.211/2025 号法律（ECA Digital，巴西数字环境未成年人保护法）规定，提供不适合未成年人的内容或服务的数字平台须履行年龄验证义务。在此流程中使用 CPFHub.io 时，法律合规由您的平台负责，我们提供数据和辅助证明材料。具体包括：
- 将 CPF 查询与确认用户本人为 CPF 持有人的手段结合使用。
- 必要时取得法定监护人的同意（LGPD 第 14 条）。
- 记录所采取的措施，以便履行问责义务。
CPFHub.io 提供验证数据。是否允许用户访问，由您的平台决定。
传输中的数据安全
- 所有通信均使用 TLS 1.2 或更高版本
- 请始终使用
https://。通过明文 HTTP 发送的请求会被重定向（301）到 HTTPS，而许多客户端会把被重定向的POST变成GET，导致实时查询和批量查询失败 - 请在
x-api-key请求头中发送 API 密钥。不要把密钥放在 URL 中，否则可能出现在代理和服务器日志里
数据保留
CPFHub.io 仅保留以下数据：
| 数据 | 期限 | 目的 |
|---|---|---|
| 技术和访问记录 | 最长 12 个月 | 安全、故障诊断和合规审计（LGPD 及 Marco Civil，即巴西《互联网民事框架法》） |
| 每次查询的记录（被查询的 CPF、结果、日期和发起查询的账户） | 账户有效期间 | 控制台历史记录、积分计费、审计和反欺诈 |
| 实时查询凭证（HTML 页面） | 最长 5 年 | 证明已向 Receita Federal 发起查询 |
| 计费数据 | 按税法要求 | 法定义务 |
| 账户数据（邮箱、姓名） | 账户存续期间 | 提供服务 |
被查询的 CPF 会与您的账户一起记录，未查到的 CPF 也是如此。请将实时查询凭证的链接（validationHtmlUrl）视为个人数据，不要对外暴露。
数据主体的权利
CPF 持有人可以直接向 CPFHub.io 行使 LGPD 第 18 条和第 19 条规定的权利，例如确认数据处理、访问、更正、了解数据来源（按来源类别）以及提出异议。为保护数据主体，CPFHub.io 可能会在答复前要求确认身份。
数据主体请求请发送至：dpo@cpfhub.io
DPO 联系方式
如有关于 LGPD 的合规问题、审计或请求：
数据保护官（DPO）： Bernardo Rocha
邮箱： dpo@cpfhub.io
答复时限： 15 天内
更新于 2026 年 10 月 9 日