コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要決済を受け付ける構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つける継続課金
対面決済
決済手段
決済業務
残高と売上処理にかかる期間領収書返金とキャンセル
高度な連携システム
決済以外の機能

顧客濫用調査非公開プレビュー

顧客のアカウント登録とログインイベントのリスク評価を取得します。

顧客の Account Evaluation API は、登録とログインフローについてリスクインテリジェンスを提供し、複数のアカウントパターンと疑わしいアカウント共有を検知します。

  • 支払い回収不要: 登録時とログイン時にリスク評価を行ってから、決済情報を収集します。
  • アップファネルでのリスクスコアの算出: ワークフローの早い段階で判断のシグナルを適用して、従来の Stripe PaymentIntents より早めに (ログインまたは登録段階で) リスクスコアを取得します。これによりサービスの濫用が疑われるアカウントのアクセスを許可するかブロックするかを情報に基づいて判断できます。

アカウント評価のライフサイクル

不正使用を検出するためのアカウント評価をリクエストするには、次の手順を実行します。

  1. クライアント側で、Stripe.js を使用してデバイスのメタデータを取得する Radar セッションを作成し、セッショントークンをサーバーに送信します。
  2. 顧客を作成するか、エンドユーザーデータをインライン顧客作成用に準備します。
  3. 顧客が登録またはログインしたときに、AccountEvaluation をリクエストします。
  4. 顧客が登録またはログインしたら、結果を Stripe に報告して今後の評価を改善します。

次の図は、登録時のビジネス (お客様)、Stripe、および最終顧客間のやり取りの概要を示しています。

Radar セッションを作成する

アカウント評価をリクエストする前に、Stripe.js を使用してクライアントからデバイスメタデータをキャプチャーする必要があります。レスポンスからの Radar セッション トークンをサーバーに渡して、アカウント評価リクエストで使用します。Radar セッション の詳細をご確認ください。

AccountEvaluation を作成する

デバイスのメタデータをキャプチャーするRadar セッションを作成したら、AccountEvaluation をリクエストして、Stripe からリスクシグナルを取得します。この評価では、タイプに基づくポリモーフィズムを使用して、さまざまなイベントタイプをサポートします。

登録フロー

registration_initiatedタイプを使用して、新しいユーザー登録を評価します。既存の顧客を参照するか、インラインで作成できます。顧客 ID は、今後の支払いリクエストで使用するために保持して、不正利用を正確に検出できるようにします。

既存の顧客を使用する

Command Line
cURL
No results
curl https://api.stripe.com/v1/radar/account_evaluations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-10-29.preview" \
  -d type=registration_initiated \
  -d "registration_initiated[customer]"=
"{{CUSTOMER_ID}}"
 \
  --data-urlencode "registration_initiated[client_device_metadata_details][radar_session]"="rse_****"

インライン顧客作成の使用

既存の顧客 ID を指定しない場合、Stripe は customer_data を使用して新しい Customer オブジェクトを作成します。

Command Line
cURL
No results
curl https://api.stripe.com/v1/radar/account_evaluations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-10-29.preview" \
  -d type=registration_initiated \
  --data-urlencode "registration_initiated[customer_data][email]"="user@example.com" \
  --data-urlencode "registration_initiated[client_device_metadata_details][radar_session]"="rse_****"

ログインフロー

login_initiated タイプを使用して、ユーザー ログイン試行を評価し、アカウント共有パターンを検出します。登録時に作成したのと同じ顧客 ID を使用します。

Command Line
cURL
No results
curl https://api.stripe.com/v1/radar/account_evaluations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-10-29.preview" \
  -d type=login_initiated \
  --data-urlencode "login_initiated[customer]"="cus_****" \
  --data-urlencode "login_initiated[client_device_metadata_details][radar_session]"="rse_****"

リスクシグナル

Stripe は、評価タイプに基づいてリスクシグナルをレスポンスで返します。これらのシグナルを使用して、アクションを許可するかブロックするかについて十分な情報に基づいた決定を行います。

評価タイプシグナルが返されました説明
registration_initiatedmulti_accounting同じ最終顧客が複数回登録するリスク
login_initiatedaccount_sharing同じアカウントが複数の場所から同時に使用されるリスク

各信号にはスコアが含まれます。

レポート結果

アカウントを評価したら、最終的な結果を Stripe に報告します。このフィードバックにより、時間の経過とともに不正使用検出の精度が向上します。

report_event を呼び出し、レポートするイベントのタイプを渡します。サポートされるイベントタイプは次のとおりです。

  • registration_succeeded: 登録が正常に完了したときにレポートします
  • registration_failed:登録が失敗したときにレポートします
  • login_succeeded: ログインが正常に完了したときにレポートします
  • login_failed: ログインが失敗したときにレポートします

次の例は、登録が正常に完了したケースを示しています。

Command Line
cURL
No results
curl https://api.stripe.com/v1/radar/account_evaluations/aceval_******/report_event \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-10-29.preview" \
  -d type=registration_succeeded

AccountEvaluation を取得する

ID を使用して、以前に作成した AccountEvaluation をいつでも取得できます。

Command Line
cURL
No results
curl https://api.stripe.com/v1/radar/account_evaluations/aceval_****** \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-10-29.preview"

Payment Intent での使用

支払いを作成する際は、アカウント評価に使用したのと同じ顧客 ID を使用する必要があります。これにより、同一顧客の登録、ログイン、支払いアクティビティを関連付け、正確なリスク評価を行うことができます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-10-29.preview" \
  -d amount=1000 \
  -d currency=usd \
  --data-urlencode customer="cus_****" \
  --data-urlencode payment_method="pm_****" \
  -d confirm=true

メモ

支払い時の customer パラメータは、AccountEvaluation の作成時に使用された顧客 ID と一致する必要があります。