電話番号認証の警告とリスクコード

​

概要

​

自動却下の条件

• VERIFICATION_CODE_ATTEMPTS_EXCEEDED：ユーザーがOTPの試行回数上限に達しました。デフォルトでは、誤ったコードの送信が2回（phone_max_check_attempts）、またはOTPの送信が2回を超えた場合（phone_max_retries）で、いずれもワークフローノードごとに調整できます。スタンドアロンの電話番号APIでは、コードを3回まで試行できます。
• PHONE_NUMBER_IN_BLOCKLIST：番号がLists APIで管理するブロックリストに含まれているか、ブロックリストに登録されたセッションと一致しています。

​

設定可能なリスク

​

ブロックされた送信

​

認証試行回数の上限

• コード入力の試行回数：デフォルトでは誤った入力が2回（phone_max_check_attempts）に達すると、ステップはVERIFICATION_CODE_ATTEMPTS_EXCEEDEDとともにDeclinedとして確定します。スタンドアロンの電話番号APIでは、認証1件あたり3回までコードを入力できます。
• 送信回数：デフォルトでは合計2回（phone_max_retries）で、初回送信と1回の再送信です。それ以上の送信リクエストがあるとステップが確定し、VERIFICATION_CODE_ATTEMPTS_EXCEEDEDが発生します。
• OTPの有効期間：保留中のOTPは初回送信から5分間有効です。再試行しても有効期間は延長されません。

​

生成される警告

​

セッション間の一致

​

例

{
  "warnings": [
    {
      "feature": "PHONE",
      "risk": "HIGH_RISK_PHONE_NUMBER",
      "additional_data": { "blocked_reason": "suspicious" },
      "log_type": "error",
      "short_description": "High risk phone number",
      "long_description": "The system detected that the phone number is a high risk phone number, which is not allowed.",
      "node_id": "feature_phone_1"
    },
    {
      "feature": "PHONE",
      "risk": "VOIP_NUMBER_DETECTED",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "VoIP number detected",
      "long_description": "The system detected that the phone number is a VoIP number, which is not allowed.",
      "node_id": "feature_phone_1"
    }
  ]
}

​

警告の種類

​

関連ページ

• 電話番号検証の概要：機能の動作、料金、対応チャネル。
• 電話番号検証レポート：lifecycle[]とmatches[]を含むレスポンスの完全な構造。
• データモデル：電話番号検証：フィールドごとの正規スキーマ。
• Management API：Lists：PHONE_NUMBER_IN_BLOCKLISTで使用される電話番号のブロックリストを管理します。