Checkify
JavaScript SDK — 生产就绪

构建检查 进入您自己的应用程序或网站。

每个站点一张 Checkify Pass。当用户开始验证时，您的页面会选择证明——人类、18 岁或 25 岁。放入嵌入片段并在服务器上验证结果。

快速入门 
<script src="https://checkify.me/sdk/v1/checkify.min.js"></script>
<div data-checkify-pass="chk_live_YOUR_PASS_ID" data-checkify-request="human"></div>

在业务仪表板中创建一个数字网站，复制您的通行证 ID，注册将运行嵌入的域，然后粘贴下面的代码片段。可选的 DNS、元标记或文件验证可提高保证性，但嵌入工作并不是必需的。

开发者快速入门 业务仪表板 WordPress 集成

需要帮助吗？登录后发送电子邮件至 support@checkify.me 或打开 Checkify Passes 选项卡，复制您的 Pass ID 和集成片段。

整合流程
站点→通行证→SDK→服务器验证
居住
开发者流程
创建数字网站 居住
复制通行证 ID 居住
添加SDK嵌入 居住
在您的后端验证 居住
1
创建站点
2
添加SDK
3
核实
嵌入
SDK直播
核实
API 直播
概述

每个站点一张通行证。您页面上的请求类型。

当您创建数字站点时，Checkify 会自动配置一个可重复使用的通行证 ID。您在该网站的任何地方（结帐、登录、注册）都保留相同的通行证 ID，并在需要每个证明的地方设置 data-checkify-request。没有执行表单启动器设置。

1

JavaScript 嵌入

自动安装小部件或 bindForm 用于登录、注册、结账和联系表单。 SDK 处理按钮、隐藏的 checkify_token 字段和提交状态。

现已上市
2

服务器验证

使用您的站点 API 密钥和隐藏字段中的 request_id 调用 POST /v1/qr/results/verify。切勿仅信任浏览器 - 在注册、结帐或密码重置之前进行验证。

现已上市
3

WordPress 和 WooCommerce

安装 Checkify 插件，粘贴您的 Pass ID，然后在您保护的页面上选择人员或年龄检查。与自定义站点相同的一次性模型。

现已上市
一次通过模型

Checkify 通行证如今的运作方式

站点、通行证和证明请求是单独的层。这使得 WordPress 插件、WooCommerce 和自定义网站变得简单：复制一个 ID，在多个地方使用它。

1

1. 创建站点

注册您的企业、添加数字网站并列出允许的域（例如 example.com 和 www.example.com）。每个站点都会获得一张 Checkify Pass。

2

2. 复制一份通行证 ID

在业务仪表板中的 Checkify Passes 或 Developer 下找到您的 Pass ID。在您的网站、插件或后端集成中使用相同的 ID — 当您切换证明类型时，它不会改变。

3

3. 在代码中选择请求类型

在每次嵌入或 bindForm 调用时将 data-checkify-request 设置为人类、age_over_18 或 age_over_25。人工检查通常是免费的；年龄检查获得批准后会消耗积分。

请求类型

data-checkify-request 典型用途
人类 验证码替换、机器人减少、无摩擦人工检查
age_over_18 18 岁以上结帐、受限内容、年龄限制注册
age_over_25 挑战25，年龄门槛更高
有什么可用

集成选项

JavaScript 嵌入和服务器验证端点已投入生产。使用业务仪表板创建站点、复制通行证 ID 并颁发站点 API 密钥。

移动应用程序移交和 npm 打包已列入路线图。如今，网站集成所需的一切都可以通过 CDN 脚本和 REST 验证 API 来实现。

今日上市

JS
JavaScript 网络 SDK
适用于网站、表单、结账和自定义流程的 CDN 脚本。每个嵌入的通行证 ID + 请求类型。
现已上市
API
服务器验证API
POST /v1/qr/results/verify 授权：持有者 YOUR_SITE_API_KEY。开发人员指南中的文档和代码示例。
现已上市
App
移动应用程序集成
通过 QR 或深层链接从本机应用程序启动 Checkify。指南和 SDK 打包即将推出。
即将推出

旧版启动器 ID 已弃用。对所有新集成使用通行证 ID + 请求类型。

它是如何运作的

端到端集成

从网站设置到后端验证用户的四个步骤。 Pass ID 保持不变；每个用例仅请求类型和服务器验证声明发生变化。

步骤1

创建网站并复制您的 Pass ID

登录到业务仪表板，打开站点，然后使用您允许的域创建数字站点。 Checkify 自动创建一张通行证。打开 Checkify Passes 复制 Pass ID (chk_live_…) 或获取现成的代码片段。

一张通行证，多种用途

登录（人）、结帐（age_over_18）和仅限员工的页面（人）上的通行证 ID 相同 - 每次嵌入仅更改 data-checkify-request。

现已推出：仪表板中的站点 + Checkify Passes
创建站点并复制 Checkify Pass ID

步骤2

将嵌入添加到您的页面

从 checkify.me 加载 SDK 并安装 Pass 小部件，或使用 Checkify.bindForm 作为表单。替换 YOUR_PASS_ID 并设置该页面或操作的请求类型。

最小嵌入
<script src="https://checkify.me/sdk/v1/checkify.min.js"></script>
<div data-checkify-pass="chk_live_YOUR_PASS_ID" data-checkify-request="human"></div>
现已推出：JavaScript 嵌入 + bindForm

表单绑定示例

<script src="https://checkify.me/sdk/v1/checkify.min.js"></script>

<div
  data-checkify-pass="chk_live_YOUR_PASS_ID"
  data-checkify-request="age_over_18"
  data-checkify-text="Verify with Checkify"
></div>

请参阅 嵌入 API 参考 用于configure()、事件和返回URL 处理。

步骤3

用户完成验证

当用户点击“验证”时，Checkify 将打开证明流程（在浏览器中或通过移动设备上的 Checkify 应用程序）。成功后，SDK 会将 request_id 写入隐藏的 checkify_token 字段，以便后端可以验证它。

✓ 该网站上每种证明类型的通行证 ID 相同。
✓ 人类、18 岁和 25 岁是在 HTML 或 bindForm 选项中选择的，而不是在“通行证”设置中选择的。
✓ 域必须与站点的允许域列表相匹配。
现已推出：通行证启动+应用程序切换

启动选项

内嵌按钮
在您的页面上嵌入小部件或 bindForm。
二维码/魔术链接
通过仪表板的物理位置和面对面流程。
移动切换
用户在 Checkify 应用程序中完成证明并返回到您的网站。

步骤4

在您的服务器上验证

从表单 POST 中读取 request_id，然后使用您的站点 API 密钥调用验证端点。在允许受保护的操作之前检查已批准的声明（human_verified、age_over_18 等）。

验证请求（服务器）
POST https://checkify.me/v1/qr/results/verify
Authorization: Bearer YOUR_SITE_API_KEY

{
  "request_id": "uuid-from-checkify_token-field",
  "required_claims": ["human_verified"],
  "consume": true
}
现已上市：POST /v1/qr/results/verify

验证成功后

前端
仅在服务器确认验证后才启用提交、继续结账或显示成功。
后端
使用 required_claims 和 consume: true 进行一次性操作，例如注册或密码重置。
您的政策
允许结帐、解锁内容、创建帐户或根据已批准的声明批准员工操作。

网站生产就绪

创建一个站点，复制一个 Pass ID，嵌入 SDK，并使用站点 API 密钥进行验证。 WordPress 和 WooCommerce 使用相同的模型。

立即使用

JavaScript 嵌入、bindForm、服务器验证 API、站点 API 密钥、WordPress 插件、业务仪表板。

路线图

npm 包、webhooks、签名的 webhook 交付、本机移动 SDK 指南。

开始整合

在业务仪表板中创建您的网站，复制您的 Pass ID，然后按照开发人员快速入门进行操作。 WordPress 网站可以使用具有相同 Pass ID 的插件。

开发者快速入门 业务仪表板 WordPress 集成