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 （旧嵌入仍可能提交轮询令牌）。请参阅服务器验证指南. 请参阅 API参考事件和返回URL处理。

请求类型

请求类型	典型用途
`human`	减少机器人/垃圾邮件
`age_over_18`	18+内容或结账
`age_over_21`	21+产品（美国酒精等）
`age_over_25`	更高的年龄阈值

域名绑定