# 列表

创建您自己的可通过规则对匹配的付款进行阻止、允许或送交审查的信息列表。

如果[您的 Radar 方案](https://docs.stripe.com/radar/how-radar-works.md#compare-plans)支持此功能，您可以创建特定类型信息的列表，并在[规则](https://docs.stripe.com/radar/rules.md)中使用。例如，您可能希望使用以下列表创建规则：

- **受信任客户的客户 ID**：使用此列表自动允许这些客户的支付。
- **与欺诈关联的电子邮箱地址**：自动拦截来自此列表中所列电子邮箱地址的任何支付。
- **可疑 IP 地址**：将具有匹配 IP 地址的支付置于审核队列。

列表的使用方便了规则的管理。不需要每次都为项目创建单独的规则，可以将相似类型的信息添加到某个规则的列表（例如邮件地址）来自动使用。

## 默认列表

Stripe Radar 包含一组默认列表，可帮助您快速开始使用。您的[默认允许和拦截规则](https://docs.stripe.com/radar/rules.md)可以引用以下类别中的允许列表和拦截列表。

> 您可以在默认列表中添加和移除项目，但无法编辑或移除默认列表本身。

### 银行卡

|  |
| **银行卡 BIN** | 用于付款的银行卡的银行识别码 (BIN)，即指卡号的前六位数字（例如，`424242`）。 |
| **银行卡国家** | 与发卡行国家/地区对应的双字母代码（如 `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 地址所在国家/地区级别的地理位置对应的双字母代码（如 `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 直接借记

|  |
| **ACH 指纹** | 用于付款的银行账户的[指纹](https://docs.stripe.com/api/customer_bank_accounts/object.md#customer_bank_account_object-fingerprint)。ACH 指纹是 Stripe 对特定 ACH 银行账户的唯一标识符（例如，orWziM4j7CiRL8）。它是 [Bank Account](https://docs.stripe.com/api/customer_bank_accounts/object.md) 对象的属性，在查看付款时，您可以在管理平台中看到。 |
| **收款描述** | 提供的付款[描述](https://docs.stripe.com/api.md#charge_object-description)。 |
| **客户 IP 国家** | 与发起支付的 IP 地址所在国家/地区级别的地理位置对应的双字母代码（如 `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 指纹是 Stripe 对特定 SEPA 银行账户的唯一标识符（例如，orWziM4j7CiRL8）。它是 [Bank Account](https://docs.stripe.com/api/customer_bank_accounts/object.md) 对象的属性，在查看付款时，您可以在管理平台中看到。 |
| **收款描述** | 提供的付款[描述](https://docs.stripe.com/api.md#charge_object-description)。 |
| **客户 IP 国家** | 与发起支付的 IP 地址所在国家/地区级别的地理位置对应的双字母代码（如 `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 直接借记指纹
- ACH 直接借记指纹

用[管理平台](https://dashboard.stripe.com/test/radar/lists)或 [API](https://docs.stripe.com/api/radar/value_lists/create.md) 创建列表。要在管理平台中创建新列表：

1. 点击**新建**。
2. 输入列表的名称（我们会自动生成一个别名，用作编写规则时的参考，但您可以覆盖它）。
3. 选择要创建的列表类型。
4. 点击**添加**保存您的新列表。

创建新列表后，[添加新规则](https://docs.stripe.com/radar/rules/reference.md#lists)引用它。

可通过点击溢出菜单 (**•••**) 来编辑或删除您创建的列表，也可以直接通过点击列表名称来编辑列表。

## 管理列表项目

在[管理平台](https://dashboard.stripe.com/test/radar/lists)中查看列表时，您可以查看、添加或移除项目。每个项目都包含添加时间和添加者的信息。您可以按值、作者和添加日期筛选项目。每个列表最多可包含 50,000 个项目。

对于卡支付，您可以[退款并将付款标记为欺诈](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)
