# リスト

お客様独自の情報リストを作成して、一致する支払いをブロック、許可、または審査します。

[Radar プラン](https://docs.stripe.com/radar/how-radar-works.md#compare-plans)で機能がサポートされている場合、特定の種類の情報をリスト化して[ルール](https://docs.stripe.com/radar/rules.md)で使用できます。たとえば次のようなリストを使用してルールを作成できます。

- **信頼できる顧客の顧客 ID**: このリストを使用して、特定の顧客による支払いを自動的に許可します。
- **不正利用に関連付けたメールアドレス**: このリストにあるメールアドレスを使用した支払いを自動的にブロックします。
- **疑わしい IP アドレス**: 合致する IP アドレスからの支払いをレビュー対象にします。

リストを使用すると、ルールを管理しやすくなります。1 回に 1 つのアイテムに対して個別のルールを作成するのではなく、同様のタイプの情報 (メールアドレスなど) をリストに追加して、ルールで自動的に使用されるように設定できます。

## デフォルトのリスト

Stripe Radar には、利用開始に役立つ一連のデフォルトリストが含まれています。[デフォルトの許可ルールとブロックルール](https://docs.stripe.com/radar/rules.md)は、以下のカテゴリの許可リストとブロックリストを参照できます。

> デフォルトリストへの項目の追加と削除は可能ですが、デフォルトリスト自体の編集や削除はできません。

### カード

|  |
| **カード BIN** | 決済に使用されたカードの銀行識別番号 (BIN)。これはカード番号の最初の 6 桁です (例: `424242`)。 |
| **カードの発行国** | カードが発行された国に対応する 2 文字のコード (`US` など)。 |
| **カードのフィンガープリント** | 決済に使用されたカードの[フィンガープリント](https://docs.stripe.com/api.md#card_object-fingerprint)。カードのフィンガープリントは、特定のカード番号を示す Stripe 固有の識別子です (例: orWziM4j7CiRL8)。これは [Card](https://docs.stripe.com/api.md#card_object) オブジェクトのプロパティであり、決済を表示するときにダッシュボードで確認できます。 |
| **支払いの説明** | 支払い時に入力された[説明](https://docs.stripe.com/api.md#charge_object-description)。 |
| **クライアントの IP アドレスの所在国** | 支払いの発生元である IP アドレスの国レベルの地理的位置に対応する 2 文字のコード (`GB` など)。 |
| **クライアントの IP アドレス** | 決済の発生元の IP アドレス (例: `13.112.224.240`)。 |
| **顧客 ID** | 支払い時に入力された[顧客 ID](https://docs.stripe.com/api.md#charge_object-customer) (たとえば、`cus_AeFLnRaI51AbRi`)。 |
| **メールアドレス** | `Charge`、`Card`、`Customer` の各オブジェクトから、この順序で取得した最初のメールアドレス (例: `jenny.rosen@example.com`)。 |
| **メールドメイン** | その注文で `Charge`、`Card`、または `Customer` のオブジェクトから最初に得られたメールドメイン (例: `example.com`)。 |

### ACH Direct Debit

|  |
| **ACH フィンガープリント** | 決済に使用された銀行口座の[フィンガープリント](https://docs.stripe.com/api/customer_bank_accounts/object.md#customer_bank_account_object-fingerprint)。ACH フィンガープリントは、特定の ACH 銀行口座を示す Stripe 固有の識別子です (例: orWziM4j7CiRL8)。これは [Bank Account](https://docs.stripe.com/api/customer_bank_accounts/object.md) オブジェクトのプロパティであり、決済を表示するときにダッシュボードで確認できます。 |
| **支払いの説明** | 支払い時に入力された[説明](https://docs.stripe.com/api.md#charge_object-description)。 |
| **クライアントの IP アドレスの所在国** | 支払いの発生元である IP アドレスの国レベルの地理的位置に対応する 2 文字のコード (`GB` など)。 |
| **クライアントの IP アドレス** | 決済の発生元の IP アドレス (例: `13.112.224.240`)。 |
| **顧客 ID** | 支払い時に入力された[顧客 ID](https://docs.stripe.com/api.md#charge_object-customer) (たとえば、`cus_AeFLnRaI51AbRi`)。 |
| **メールアドレス** | `Charge`、`Bank Account`、`Customer` の各オブジェクトから、この順序で取得した最初のメールアドレス (例: `jenny.rosen@example.com`)。 |
| **メールドメイン** | `Charge`、`Bank Account`、または `Customer` オブジェクトからこの順序で得られた最初のメールドメイン (例: `example.com`)。 |

### SEPA ダイレクトデビット

|  |
| **SEPA ダイレクトデビットのフィンガープリント** | 決済に使用された銀行口座の[フィンガープリント](https://docs.stripe.com/api/customer_bank_accounts/object.md#customer_bank_account_object-fingerprint)。SEPA フィンガープリントは、特定の SEPA 銀行口座を示す Stripe 固有の識別子です (例: orWziM4j7CiRL8)。これは [Bank Account](https://docs.stripe.com/api/customer_bank_accounts/object.md) オブジェクトのプロパティであり、決済を表示するときにダッシュボードで確認できます。 |
| **支払いの説明** | 支払い時に入力された[説明](https://docs.stripe.com/api.md#charge_object-description)。 |
| **クライアントの IP アドレスの所在国** | 支払いの発生元である IP アドレスの国レベルの地理的位置に対応する 2 文字のコード (`GB` など)。 |
| **クライアントの IP アドレス** | 決済の発生元の IP アドレス (例: `13.112.224.240`)。 |
| **顧客 ID** | 支払い時に入力された[顧客 ID](https://docs.stripe.com/api.md#charge_object-customer) (たとえば、`cus_AeFLnRaI51AbRi`)。 |
| **メールアドレス** | `Charge`、`Bank Account`、`Customer` の各オブジェクトから、この順序で取得した最初のメールアドレス (例: `jenny.rosen@example.com`)。 |
| **メールドメイン** | `Charge`、`Bank Account`、または `Customer` オブジェクトからこの順序で得られた最初のメールドメイン (例: `example.com`)。 |

## カスタムのリスト

特定の種類の情報を持つアイテムを含む独自のリストを作成できます。 作成できるリストの種類は以下のとおりです。

- 文字列
- 大文字と小文字を区別する文字列
- カードのフィンガープリント
- カード BIN
- 顧客 ID
- メールアドレス
- IP アドレス
- 国
- SEPA Direct Debit の指紋認証
- ACH Direct Debit の指紋認証

[ダッシュボード](https://dashboard.stripe.com/test/radar/lists)または [API](https://docs.stripe.com/api/radar/value_lists/create.md) を使用して、リストを作成します。ダッシュボードで新しいリストを作成するには、次の手順に従ってください。

1. **新規**をクリックします。
2. リスト名を入力します (Stripe はルールの作成時に参照として使用するエイリアスを自動生成しますが、これは上書きできます)。
3. 作成するリストのタイプを選択します。
4. **追加**をクリックして新しいリストを保存します。

新しいリストを作成したら、それを参照する[新しいルールを追加](https://docs.stripe.com/radar/rules/reference.md#lists)します。

オーバーフローメニュー (**•••**) をクリックすると、作成したリストを編集または削除できます。リスト名をクリックして、直接編集することもできます。

## リストアイテムの管理

[ダッシュボード](https://dashboard.stripe.com/test/radar/lists)でリストを表示して、項目の表示、追加、削除を行えます。各項目には、追加したユーザーと日付に関する情報が含まれています。値、作成者、追加日で項目にフィルターを適用できます。各リストには 5 万項目まで含めることができます。

カード決済の場合、決済を[返金し、不正利用として報告](https://docs.stripe.com/radar/transaction-risk-prevention.md#feedback-on-risk-evaluations)することで、以下のアクションがトリガーされます:

- カードのフィンガープリントを、デフォルトのカードフィンガープリントのブロックリストに追加します。[Customer (顧客)](https://docs.stripe.com/api.md#customer_object) オブジェクトを使用して支払いが行われる場合は、その他のカードのカードフィンガープリントもリストに追加されます。
- 支払いに関連するすべてのメールアドレスを、デフォルトのメールアドレスのブロックリストに追加します。メールアドレスは以下から取得されます。
  - 支払いの `receipt_email`
  - 支払いが作成された `Customer` オブジェクトの `email`
  - 顧客または支払いの `description` フィールド、およびカードの `name` フィールドにあるメールアドレス

不正利用の疑いにより支払いを返金する際は、AI モデルが将来同様のケースを識別できるように、必ずその理由を指定してください。

API を使用して[支払いの更新](https://docs.stripe.com/api/charges/update.md#update_charge-fraud_details)リクエストを作成し、`fraud_details.user_report` を `fraudulent` に設定することもできます。また、これにより、関連するカードとメールアドレスがカードフィンガープリントとメールのブロックリストに追加されます。

ダッシュボードで文字列のリストアイテムを追加する際に、有効期限までの期間を選択できます。有効期限が切れると、ルール評価には使用されなくなります。

許可リストがあると、特に不要な入力が定期的に削除されない場合に、不正使用者は制限なく活動でき制御を回避できることがあります。このため、デフォルトのフィンガープリント許可リストのエントリの有効期間は最大 30 日間となっています。

カスタムルール用に、有効期限がより長いか無期限の、カスタムの決済手段フィンガープリントのリストを作成できます。

## See also

- [ルール](https://docs.stripe.com/radar/rules.md)