証拠を求めてください
申請では、例えば18歳以上であることや本人確認など、何らかの手続きに必要な証明を求められます。
開発者向けチェック
サイトに接続し、 Checkify Pass ID、確認したいものを選択し、Checkify をログイン、チェックアウト、コメント、問い合わせフォーム、または独自のカスタム フローにドロップします。
統合モデル
アプリケーションで証明を求められます。Checkifyがカスタマージャーニーを実行します。結果を受け取り、次に何をするかを決定します。
申請では、例えば18歳以上であることや本人確認など、何らかの手続きに必要な証明を求められます。
Checkifyは、十分な証明が存在するか、顧客が追加の確認を完了する必要があるかを判断します。
サーバーは結果を確認し、保護された操作を許可、ブロック、または続行します。
リアルAPI
顧客が Pass セッションを完了すると、バックエンドはサイト API キーを使用して request_id を検証します。サイト API キーをブラウザー コードに含めないでください。
リクエスト
POST /v1/qr/results/verify
Authorization: Bearer YOUR_SITE_API_KEY
Content-Type: application/json
{
"request_id": "56a57761-ff5b-42f0-9c97-6c13e223e017",
"required_claims": ["age_over_18"],
"consume": true
}
応答
{
"success": true,
"status": "completed",
"approved_claims": {
"age_over_18": true
}
}
ブラウザまたはプラグインは request_id (多くの場合 checkify_token) を保存します。あなたのサーバーが権限を持っています。アクションを許可する前に、approved_claims を確認してください。
リクエストできる内容
検証インフラを再構築することなく、各旅程ごとにリクエストの種類や必要なクレームを変更できます。
13歳以上、16歳以上、18歳以上、25歳以上など、年齢制限を指定してください。
age_over_18フォーム入力、ログイン、不正利用防止対策において、実際に人が対応していることを確認する。
human_verifiedリスクに応じて適切な保証レベル(基本保証から高保証まで)をリクエストしてください。
basic → highAssurance保証レベルと具体的な証拠オプションは、旅程、デバイス、および設定されたポリシーによって異なります。クレーム名については、サーバー検証ガイドを参照してください。
統合方法
ご使用のスタックに合ったパスから始めてください。すべての本番環境パスは同じ証明モデルを使用します。
一般的なCMSおよびチェックアウトゲートとして、WordPress、WooCommerce、およびJoomla / J2Commerce。
WordPress ガイド →カスタムウェブサイト向けのCDN埋め込みとbindForm機能。Passセッションを開始し、トークンをフォームに書き込みます。
ドキュメントを埋め込む →POST /v1/qr/results/verify とサイト API キー (csk_) を使用して結果を確認します。
サーバー検証 →PassとQRハンドオフを使用した会場間およびデバイス間の移動。
身体スタッフガイド →Shopify と Wix は待機リスト/近日公開予定であり、ここではライブ本番環境への統合としてリストされていません。
資格
Checkify は 2 種類の認証情報を使用します。誤った認証情報を誤った場所で使用することが、最もよくある統合ミスです。
Browser embed, WordPress, Joomla — frontend only
Backend verify API — server only, never in JavaScript
結果の提供
標準的なウェブサイトおよびチェックアウトフローでは、保護されたアクションが送信された際に、サーバー上でrequest_idを確認してください。カスタムフロントエンドでは、オプションでステータスポーリングが利用可能です。
あなたのページまたはプラグインは、あなたのサイトに紐づいたCheckify Passリクエストを開始します。
顧客はCheckifyアプリで確認または承認します。
検証エンドポイントを呼び出し、承認済みクレームを確認し、許可またはブロックします。
標準的な連携においては、汎用的な検証用Webhookは不要です。パートナーからの送信用Webhook(例:GoHighLevel)は、ビジネスダッシュボードで別途設定します。
文書化
実装の詳細については、これらのガイドを使用してください。このページでは引き続き統合モデルに焦点を当てます。
最初の保護されたアクション用にパスを埋め込み、フォームをバインドします。
クイックスタートを開く→パブリック統合で使用されるエンドポイント (検証とステータスを含む)。
API ドキュメントを開く →data-checkify 属性、bindForm オプション、およびリクエスト タイプ。
埋め込みドキュメントを開く →サイト API キー、required_claims、consump および signed_result。
サーバーガイドを開く→まず、年齢、人間、アイデンティティといった1つのジャーニーにCheckifyを追加し、製品のニーズの拡大に合わせて拡張してください。