何时使用
- 您是已通过 KYB 审核的企业账户，Qscore 等级为 A 或 B（分数 ≥ 650），且评估时间在最近 90 天内——无论来自自有报告还是第三方购买的报告。
- 您希望向客户、供应商或合作伙伴证明信用资质，提供一个他们可以自行验证的链接，而不是发送 PDF 文件。
- 您希望该证明在不再属实时自动失效。
徽章仅面向企业提供。个人账户在其生成的每份 Qscore 报告上已带有公开验证码（请参阅 Qscore 指南）。
工作原理
- 激活会创建一个带有加密签名公开验证码的徽章。重复激活是安全的：第二次调用返回已有的徽章（
idempotency_hit: true）。 - 每次公开访问都会实时重新评估资格：仅当徽章处于激活状态且主体当下仍然符合条件时，页面和徽章才会显示等级。
- 撤销权在您手中：
DELETE会永久停用该徽章（该验证码将永远显示”已撤销”）。之后您可以激活一个新徽章——使用新的验证码。
第 1 步 — 激活徽章
需要账户会话（已通过 KYB 的企业账户）。无需请求体，也无需幂等键：激活按主体天然幂等。201 Created — 徽章已激活：
POST 会返回 200 OK 和同一个徽章，并带 "idempotency_hit": true——重试永远不会产生重复。账户在激活徽章时会收到品牌邮件（撤销时也会收到）。
第 2 步 — 查询状态和资格
200 OK：
eligibility 块始终是实时的——在做任何操作之前，用它来判断您是否可以激活（或继续展示）徽章：
已撤销的徽章会继续出现在响应中，带有
status: "revoked" 和 revoked_at，并不含 verify_code/verify_url/badge_url。
第 3 步 — 发布
直接分享verify_url，或将徽章嵌入您的网站。徽章是无需凭据即可访问的普通 SVG：
- 徽章尺寸为 180×64，深色背景，在徽章有效期间显示等级字母（A 或 B）。
- 如果徽章不再有效，同一 URL 会渲染为灰色的”NO VIGENTE”徽章——它永远不会显示过期等级，也不会在您的页面上出现视觉错误。
Cache-Control: public, max-age=300：浏览器最多可缓存该图像 5 分钟。徽章上的标签为西班牙语（“VERIFICADO” / “NO VIGENTE”）。- 徽章 URL 仅对无效或被篡改的验证码返回
404（空响应）。
第 4 步 — 撤销（可选）
您可以随时停用徽章。撤销对该验证码是永久性的：公开页面将永远显示”徽章已撤销”，徽章也会变灰。之后您可以使用新验证码激活一个新徽章。200 OK：
验证者看到的内容（公开，无需凭据）
任何持有链接的人都可以验证徽章——机器使用 JSON，浏览器使用品牌 HTML 页面（Accept: text/html）：
200 OK：
200 OK：
200 OK：
404：
429 too_many_attempts）。
徽章状态
错误
完整目录请参阅错误页面。
Webhook 和费用
徽章不发送 webhook，也不收取任何费用——它是基于您自己已验证数据的自助功能，与自有信用报告一样。状态变更通过品牌邮件通知账户（激活和撤销）。常见问题
徽章收费吗？
徽章收费吗？
不收费。激活、展示和撤销徽章都是免费的。背后的 Qscore 评估遵循正常规则（您的自有报告每 30 天免费一次）。
哪种报告能让我符合条件？
哪种报告能让我符合条件？
任何一种：您自己的自有报告，或第三方购买的关于您公司的报告。徽章始终读取存档的最新分数，无论其来源如何。
如果我发布徽章后分数下降怎么办？
如果我发布徽章后分数下降怎么办？
徽章和页面会在下一次访问时自动变为灰色 /
not_current——实时评估，最多 5 分钟缓存。当新的评估让您回到 A/B 级时，徽章会再次显示等级，无需您做任何操作（只要您没有撤销它）。我可以撤销后重新激活吗？
我可以撤销后重新激活吗？
可以。撤销对已撤销的验证码是永久性的（它将永远显示”已撤销”），但您可以随时激活新徽章，获得新的验证码和新的 URL。
个人账户可以获得徽章吗？
个人账户可以获得徽章吗？
不可以——徽章仅面向企业。个人报告在每份报告上印有自己的公开验证码（请参阅 Qscore 指南）。
验证者能看到我的数字分数吗？
验证者能看到我的数字分数吗？
永远看不到。公开页面和 JSON 只显示等级（A 或 B）、公司名称、证件和所在国家，以及评估日期——且仅在徽章有效期间。