Checkify — 開発者クイックスタート

1。サイトを作成し、パス ID をコピーします

Checkify アプリまたはビジネスダッシュボードで、デジタルサイトを作成し、埋め込みが実行されるドメインを登録します。 Checkify は、サイトごとに 1 つのパスを自動プロビジョニングします (たとえば、 chk_live_...).

サンドボックステストの場合は、テスト環境サイトからのテストパス ( 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 の処理については、サーバー検証ガイド. イベントと戻り URL の処理については、 API リファレンスを参照してください。

リクエストタイプ

リクエストタイプ	一般的な用途
`human`	ボット/スパムの削減
`age_over_18`	18 歳以上のコンテンツまたはチェックアウト
`age_over_21`	21 歳以上の製品 (米国のアルコールなど)
`age_over_25`	年齢のしきい値を高くする

ドメインバインド

埋め込みは、Checkify サイトに登録されているドメインからのみ開始されます。オプションの DNS/メタ/ファイル検証によりビジネスの保証が強化されますが、登録済みドメインでの埋め込みの動作には必須ではありません。