Skip to content

ウェブサイト・アプリ向け年齢確認API

アプリケーション側で身分証明書や生年月日を保存することなく、訪問者が年齢要件を満たしているかを確認します。

訪問者が年齢要件を満たしているか確認

1つのセッションで両方を行えます。訪問者はWhatsAppで電話番号の管理を証明し、年齢に関する質問に一度答え、アプリケーションは、設定したしきい値に対して「満たす」か「満たさない」かの結果を受け取ります。

年齢確認の仕組み

ステップ1は、電話番号の認証です。flow=age を指定して POST /start-verification を呼び出し、返されたWhatsAppのディープリンクを、デスクトップではQRコード、モバイルではボタンとして表示します。訪問者は、自分のWhatsAppアカウントから入力済みのメッセージを1通送ります。番号の管理は、こちらから送ったコードではなく、送信という行為によって証明されます。

ステップ2は、しきい値の設定です。同じ呼び出しで、任意の min_age を指定できます。省略すると、アカウントに設定されたしきい値が適用され、変更していない限り18です。min_age は flow=age でのみ受け付けられ、正の整数でなければなりません。それ以外の値は400で返されます。

ステップ3は、年齢確認の完了です。電話番号の側が証明されるとすぐに、レスポンスには、ステータスが pending の age ブロックと age_verification_url が含まれます。訪問者には、同じワンタイムリンクがWhatsAppで送られ、お客様はそれを使って、訪問者がすでに使っているブラウザーで手続きを進めさせることができます。訪問者は年齢確認プロバイダーで回答し、token と、age=verified、denied、failed のいずれかが付加された callback_url に戻ります。

ステップ4は、結果の受信です。プロバイダーが回答すると、2つ目のwebhookである age_verification_result が発火し、GET /check-verification-status も同じ内容を返します。age ブロックには、status、verified、required(実際に確認されたしきい値)、verified_at、provider が含まれます。

ポーリングのループを書く前に知っておきたい落とし穴が1つあります。セッション自身の status は、電話番号が証明された時点で verified に達しますが、そのとき age.status はまだ pending です。年齢のステップのシグナルとして扱うのは age ブロックであり、セッションのステータスではありません。

電話番号認証と年齢確認の組み合わせ

2つのステップは、異なる問いに答えるものであり、フローは意図的にそれらを分けています。WhatsAppメッセージの送信が証明するのは、訪問者がその番号を管理していることだけです。年齢については何も示しません。電話番号は年齢の証明ではなく、このフローのどの部分も、それを年齢の証明として扱うことはありません。

電話番号のステップによって得られるのは、答えを置く場所です。年齢の結果だけでは、どこかの誰かがしきい値をクリアしたという、紐づけ先のない事実にすぎません。訪問者がたった今使ったと確認できる番号に結びつけることで、次回の訪問時にも識別できるものになります。

これは、再訪した訪問者への対応も低コストにします。合格の結果は、電話番号に対して1年間保持されるため、すでに同じしきい値をクリアしている人は、番号を再証明するだけで以前の答えを引き継ぎ、プロバイダーに戻されることはありません。新しい答えが必要な場合は、WhatsAppメッセージの末尾を #reset にすると、キャッシュをスキップできます。

身元データベースを作らずに年齢を確認する

年齢ゲートが問うのは、真偽値です。それに答えるために通常集められるデータの大半は、そうではありません。だからこそ、書類のアーカイブは割に合いません。「はい」を保存するために、パスポートや運転免許証を抱え込むことになるからです。

アプリケーションが必要とするものは、わずかです。結果(verified、denied、failed、またはまだ pending)。確認されたしきい値。いつ回答され、どのプロバイダーが回答したか。そして、その答えを目の前の訪問者に結びつける、セッション識別子と認証済みの電話番号です。以上が age ブロックのすべてであり、あとは電話番号認証のフローがすでに返すものです。

アプリケーションが必要としないのは、生年月日や身分証明書であり、APIはどちらも返さないため、うっかりログに残してしまうフィールドもありません。合格の答えは、答え、しきい値、日付として、電話番号に対して保持されます。プロバイダーの認証情報はサーバー側のシークレットに保管され、プロバイダーが判断に至るまでに確認した内容は、お客様には渡されません。

以上は、お客様自身の義務について述べたものではありません。何を確認しなければならないか、確認したことをどれだけの期間示せなければならないか、どの方法が許容されるかは、APIベンダーではなく、貴社の法務担当者や規制当局に確認すべき事柄です。

年齢確認と本人確認の違い

年齢確認が答えるのは、1つの問いです。この訪問者は、設定した年齢のしきい値を満たしているか。本人確認が答えるのは、別の問いです。この人は誰か。両者はセットで販売されることが多いのですが、扱うデータの量は大きく異なります。

flow=age は前者です。氏名も生年月日も、書類からの情報も返しません。KYCではなく、合格の結果は、他の場面で拠り所にできる本人確認の主張ではありません。顧客が誰であるかを把握する義務がある場合、その部分に使うツールではありません。

また、あらゆる電話番号ベースの確認の根底にある前提も引き継いでいます。その番号は、使っている人のものである、という前提です。メッセージを送って管理を証明する方法は、SMSを受信するよりも確かですが、大人の電話にアクセスできる未成年者というシナリオは、リモートの確認では完全にはふさげません。ID のデータベースにならない年齢確認についての記事(下にリンクがあります)では、アーキテクチャ、4つの状態、限界について、さらに詳しく説明しています。

アプリに年齢確認を組み込む

Phone-Verifのすべての連携で使われる2つのREST呼び出しを、パラメータを1つ変えて使うだけです。x-api-key ヘッダーでAPIキーによる認証を行い、flow=age でセッションを開き、ステータスのエンドポイントまたはwebhookから age ブロックを読み取ります。

  1. 訪問者
  2. WhatsAppによる電話番号認証
  3. プロバイダーでの年齢確認
  4. 年齢の結果
  5. お客様のアプリケーション

2つのステップは、異なる問いに答えるものであり、最後まで別々に扱われます。WhatsAppメッセージの送信が証明するのは、訪問者がその番号を管理していることだけで、年齢の証拠として扱われることはありません。年齢の結果を生み出すのは、年齢確認のステップです。

curl -X POST "https://api.phone-verif.com/start-verification?flow=age&min_age=18" \
  -H "x-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"session_id": "checkout-4821", "callback_url": "https://your-app.example/age-checked"}'

flow=age でセッションを開きます。min_age を省略すると、アカウントに設定されたしきい値が適用され、変更していない限り18です。

{
  "status": "verified",
  "age": { "status": "pending", "verified": false, "required": 18 },
  "age_verification_url": "https://t.phone-verif.com/av/AbCd1234"
}

電話番号が証明されると、年齢確認のステップが未完了のままでも、セッションは verified に達します。年齢の答えは、セッションのステータスではなく age.status を読んでください。また、訪問者がすでに使っているブラウザーで確認を完了できるよう、age_verification_url へ誘導します。

{
  "event": "age_verification_result",
  "session_id": "checkout-4821",
  "validation_token": "...",
  "age": {
    "status": "verified",
    "verified": true,
    "required": 18,
    "verified_at": "2026-09-01T22:00:00.000Z",
    "provider": "ageverif"
  }
}

プロバイダーが回答すると、2つ目のwebhookが結果を運び、ステータスのエンドポイントも同じブロックを返します。

flow=age には、アカウントに年齢確認プロバイダーが設定されている必要があります。未設定のままリクエストすると、APIはコード age_not_configured とともに503を返すため、設定の不備と障害を区別できます。

年齢確認のFAQ

ユーザーが18歳以上であることを確認できますか?
はい。flow=age でセッションを開き、min_age を省略してください。フローは、アカウントに設定されたしきい値に対して確認を行い、設定で変更していない限り18です。
別の最低年齢を使えますか?
はい。開始の呼び出しで、必要なしきい値を min_age として渡します。正の整数でなければならず、flow=age でのみ受け付けられ、それ以外は400で拒否されます。各セッションは、開いたときのしきい値を保持し、そのしきい値は age ブロックの required として返されるため、後から読む人も、実際に何が確認されたかが分かります。
ユーザーの生年月日を保存する必要がありますか?
いいえ。保存しようとしてもできません。APIが生年月日を返さないからです。返されるのは、しきい値を満たしたかどうか、しきい値がいくつだったか、いつ回答されたか、どのプロバイダーが回答したかです。
身分証明書を保存する必要がありますか?
いいえ。プロバイダーは、答えを出すために書類を確認する必要があるかもしれませんが、アプリケーションが受け取るのは答えだけです。書類からの情報はAPIから一切返されないため、保存するものはありません。
年齢確認で、本人の身元を証明できますか?
いいえ。flow=age が答えるのは、証明済みの電話番号を持つ人がしきい値を満たしているかどうかです。本人確認でもKYCでもなく、氏名も生年月日も書類も扱いません。
年齢確認に失敗するとどうなりますか?
denied と failed は異なる結果であり、1つにまとめてはいけません。denied はプロバイダーによる判断で、再実行しても答えは変わりません。failed はプロバイダーに接続できなかったことを意味し、何も判断されていないため、再試行は妥当です。拒否やプロバイダーの障害は課金されません。完了した年齢確認は、電話番号認証に加えて、2つ目の単位として課金されます。
電話番号認証と年齢確認を組み合わせられますか?
それこそが flow=age です。1つのセッションで、WhatsAppによる電話番号の証明を行ってから年齢確認のステップを実行し、両方の結果が同じセッションに届きます。2つの連携を実行したり、2つの識別子を突き合わせたりする必要はありません。
再訪した訪問者に、新たに確認を強制できますか?
はい。合格の結果は、同じ電話番号と同じしきい値に対して1年間再利用されます。WhatsAppの認証メッセージの末尾を #reset にすると、キャッシュされた答えをスキップし、訪問者を完全な確認に戻します。

Related

年齢確認のユースケース

アダルトコンテンツ

自己申告のチェックボックスが、もはや確認として扱われない領域です。年齢の結果が、何かを配信する前にアクセスを制御し、訪問者に書類のアップロードを求めることもありません。

オンラインギャンブル

未成年のプレイヤーを排除しなければならない、賭博やカジノのアカウントです。確認は登録時に行え、自社のルールで求められる場合は、重要な操作の前にも再度行えます。

酒類など年齢制限のある商品

酒類、タバコ、電子タバコ、刃物、溶剤、花火などです。確認はチェックアウトの前に置かれ、閲覧のセッションではなく、注文に対して行われます。

ゲーム

年齢区分のあるタイトル、チャット機能、一定の年齢未満では制限される課金要素です。しきい値はリクエストのパラメータなので、機能ごとに異なる値を指定できます。

マーケットプレイス

法律または自社のポリシーで制限される出品物です。セッションを開くときの min_age を変えることで、購入者と出品者に異なるしきい値を適用できます。

ソーシャル・コミュニティプラットフォーム

アカウント、ダイレクトメッセージ、ライブ機能に対する最低年齢のルールです。結果は証明済みの電話番号に紐づくため、セッションが終わった後も有効です。

Build your 年齢確認 flow today

Start integrating in minutes with clear documentation, SDKs, and global message delivery.