Checkify

JavaScript SDK v1.0.4

5 分钟快速入门

使用一个通行证 ID 和一种请求类型将 Checkify 添加到您的网站。无需手动启动器设置。

1。创建一个网站并复制您的 Pass ID

在 Checkify 应用程序或业务仪表板中,创建一个数字网站并注册您的嵌入将运行的域。 Checkify 自动为每个站点配置一个 Pass(例如, chk_live_...).

对于沙箱测试,请使用测试 Pass(来自测试环境站点的 chk_test_...) )。

2. 添加嵌入片段

将其粘贴到您的页面中。替换 YOUR_PASS_ID 并选择请求类型。

<script src="https://checkify.me/sdk/v1/checkify.min.js"></script>
<div
  data-checkify-pass="YOUR_PASS_ID"
  data-checkify-request="human"
  data-checkify-text="Verify with Checkify"
></div>

3.绑定表单(可选)

对于登录、注册、结账或联系表单,让 SDK 处理按钮、隐藏令牌字段和提交状态。

<form id="signup-form">
  <input type="email" name="email" required>
  <input type="hidden" id="checkify_token" name="checkify_token">
  <div id="checkify-button"></div>
  <button id="submit" type="button">Create account</button>
</form>

<script src="https://checkify.me/sdk/v1/checkify.min.js"></script>
<script>
  Checkify.bindForm('#signup-form', {
    passId: 'YOUR_PASS_ID',
    requestType: 'human',
    buttonTarget: '#checkify-button',
    submitButton: '#submit',
    hiddenInput: '#checkify_token'
  });
</script>

4.在您的后端进行验证

浏览器仅收到令牌。在允许受保护的操作之前始终验证服务器端。

使用您的站点 API 密钥并调用 POST /v1/qr/results/verify 使用隐藏字段中的 request_id (旧嵌入仍可能提交轮询令牌)。 请参阅 服务器验证指南. 有关浏览器事件和返回 URL,请参阅 嵌入 API 引用事件和返回URL处理。

请求类型

请求类型 服务器声明(必需声明) 典型用途
human人工验证减少机器人/垃圾邮件
age_over_13年龄超过13岁13岁以上内容或COPPA式门禁
age_over_16年龄超过16岁16岁以上内容或地区年龄限制
age_over_18年龄超过18岁18+内容或结账
age_over_21年龄超过21岁21+产品(美国酒精等)
age_over_25年龄超过25岁更高的年龄阈值

在您的嵌入代码中使用这些请求类型(data-checkify-request 或 Checkify.bindForm)。在您的服务器上,使用 required_claims 中匹配的声明进行验证。

域名绑定 嵌入仅从您在Checkify网站上注册的域名开始。可选的 DNS/元/文件验证可提高业务保证,但嵌入在注册域上运行不需要。