加入期間 [開発者プレビュー]

「加入者利用期間」により、ネットワーク加入者がモバイル通信事業者の顧客として所定の最低期間利用していることを確認し、関連するネットワーク加入者識別子に対する信頼度を確立することができます。

本ソリューションは、オンライン上でユーザーの身元確認を行う必要のある企業やサービスプロバイダー――特に金融サービス、フィンテック、Eコマース、通信業界の事業者――を対象としており、不正行為の削減や意思決定の信頼性向上を目指す企業向けに設計されています。

「加入期間」がメリットをもたらす最も一般的なユースケースとしては、次のようなものがあります：

  • 本人確認と新規登録プロセスの強化： 企業は、オンボーディングやKYC（本人確認）の過程において、「加入者利用期間」を活用することで、ユーザーのモバイルIDの信頼性を評価することができます。電話番号の利用期間が長いほど、ユーザーの身元が本物であるという確信が高まり、書類確認や加入者照合といった他の確認手段を補完する役割を果たします。これにより、オンボーディング時の不正を削減し、デジタルIDの検証に対する信頼性を高めることができます。
  • 認証の信頼性を高める： このAPIは、電話番号の利用期間に基づく信頼度要素を追加することで、「番号認証」やSMSによるワンタイムパスワード（OTP）などの携帯電話認証機能をサポートしています。電話番号が長期間使用されている場合、リスクスコアリングモデルにおいて優先的に扱われたり、より高い重み付けがされたりしますが、最近有効化された電話番号については、強化認証が要求される場合があります。
  • 不正検知とリスクスコアリングの強化： 不正防止システムは、利用期間のデータを活用して、合成IDや高リスクな活動の兆候となる可能性のある、新規に有効化された電話番号や短期間しか使用されていない電話番号を特定することができます。これにより、取引やAccountの変更、その他の機密性の高い業務に影響が及ぶ前に、潜在的な不正を早期に検知することが可能になります。
  • 金融サービスのリスク評価のサポート： 銀行や金融機関は、融資や決済の業務プロセスに電話番号の保有期間確認機能を組み込むことができます。ユーザーがその電話番号をどのくらいの期間使用し続けているかを評価することで、信頼性や安定性を示すさらなる指標を得ることができ、なりすまし詐欺や虚偽のApplicationsの発生リスクを低減するのに役立ちます。

前提条件

Identity Insights を使用するには、アカウントが正しく設定されていることを確認する必要があります。 はじめに のガイドを参照されたい：

  • アカウントの作成
  • Identity Insights API で使用する Vonage アプリケーションの作成、
  • 利用可能なさまざまな環境と、それらを使用するためのアカウントの設定方法、
  • また、Dashboard Getting Started UIを使用して、コードを書かずにAPIを使用する方法も紹介します。

このガイドでは、cURL を使用して「Subscriber Tenure Insight」をプログラムから操作する方法について説明します。

Identity Insights API は、複数の地域のエンドポイントから利用できる。本ガイドの例では EU エンドポイントを使用していますが、全リストは以下を参照してください。 技術詳細.

APIを呼び出す

Identity Insights API の認証は、コンパクトで自己完結型の JSON トークンである JWT を介して行われます。JWT を生成するには、当社の オンラインジェネレーターあるいは Vonage CLI.JWTを生成するには、アプリケーションIDと秘密鍵が必要です。JWTを取得したら、APIにリクエストを送信できます。

この例は、「加入者在籍期間」のインサイトに対する cURL リクエストを示しています。これは、指定された電話番号に関連付けられた加入者が、監視対象期間全体を通じて同じ通信事業者と契約を維持していたかどうかを確認するためのものです。監視対象期間の開始日は、 date パラメータが必要だ：

curl -X POST https://api-eu.vonage.com/identity-insights/v1/requests  \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "14040000000",
    "purpose": "FraudPreventionAndDetection",
    "insights": {
        	"subscriber_tenure": {
          "date": "2023-07-03"
          }
        }
    }'

その後、APIは当該の携帯電話番号に関連付けられた契約期間情報を取得し、リクエストで指定された日付と照合して検証を行います：

{
    "request_id": "f41087de-b9fc-4081-ab85-9d6475a19706",
    "insights": {
        "subscriber_tenure": {
            "is_tenure_met": true,
            "contract_type": "PREPAID",
            "status": {
                "code": "OK",
                "message": "Success"
            }
        }
    }
}

ここでは status オブジェクトは、指定された電話番号について返された情報のステータスを示します：

フィールド 説明
status.code リクエストのステータスを示すコード。のいずれかでなければならない：

NO_COVERAGE:国またはモバイルネットワークは、利用可能なサプライヤーによってサポートされていません。
INVALID_PURPOSE:使用された目的は、このインサイトで有効または許可されていません。
UNAUTHORIZED:アプリケーション、サプライヤー、電話番号の組み合わせでは、リクエストを承認できませんでした。
INTERNAL_ERROR:リクエストの処理中に内部エラーが発生しました。
SUPPLIER_ERROR:サプライヤーがリクエスト処理中にエラーを返しました。
NOT_FOUND:このインサイトの電話番号が見つかりません。
UNSUPPORTED_NETWORK_TYPE:このインサイトでは、ネットワークタイプはサポートされていません。
INVALID_NUMBER_FORMAT:電話番号フォーマットは、キャリアからユーザーへの割り当てには無効です。
OK:インサイトは正常に処理されました。
status.message より詳細なステータスの説明。

もし status.code 応答は OKまた、下表のフィールドが表示されることもある。必須」の欄で「はい」とマークされているフィールドは、ステータスが「OK」の場合、常に返される。フィールドが「No」とマークされている場合、そのフィールドは返される場合と返されない場合がある。

フィールド 説明 必須
is_tenure_met true 特定された携帯電話契約の有効期間が開始されたのは date, そうでなければ false. はい
contract_type このフィールドが存在する場合、以下のいずれかの値が入力されます： PREPAID プリペイド（従量課金）アカウントの場合、 POSTPAID 契約アカウントの場合、または BUSINESS ビジネス（エンタープライズ）アカウントの場合。この情報は利用できない場合、レスポンスセットからこの属性が省略されることがあります。 いいえ

さらに読む