# 对账单描述符

了解对账单描述符的原理。

如果您管理具有自定义账户或 Express 连接账户的 *Connect* (Connect is Stripe's solution for multi-party businesses, such as marketplace or software platforms, to route payments between sellers, customers, and other recipients) 平台，请参阅[使用 Connect 设置对账单描述符](https://docs.stripe.com/connect/statement-descriptors.md)。

对账单描述符对银行对账单上的收款或付款进行解释。使用清晰准确的对账单描述符可以减少撤单和争议。银行和卡组织要求包含某些类型的信息，以帮助客户理解他们的对账单，对账单描述符的作用就是来提供这些信息。

在您[设置 Stripe 账户](https://docs.stripe.com/get-started/account/set-up.md#public-business-information)时，可设置一个对账单描述符（静态对账单描述符），这个描述符将显示在所有客户的对账单上。对于银行卡扣款，您还可以创建一种对账单描述符：包含与账户关联的静态前缀，以及与每笔扣款对应的动态后缀。这样您就能在银行或银行对账单上，标注产品、服务或支付相关的具体明细。

大多数银行会一致显示此信息，但有些可能会错误显示或根本不显示。

## 对账单描述符的要求

完整的对账单描述符（无论是单个静态描述符还是前缀和后缀的组合）必须满足以下要求：

- 仅包含拉丁字符。
- 包含 5 到 22 个字符（含）。
- 包含至少一个字母（如果使用前缀和后缀，两者都至少要有一个字母）。
- 不要包含以下任何特殊字符：`<`、`>`、`\`、`'`、`"`、`*`。
- 反映您的“经营名称”（DBA，即“Doing Business As”）。
- 包含多个常见术语或常见网站 URL。可以仅提供网站 URL，前提是它能在客户对账单上清晰准确地描述交易。

静态前缀，在管理平台中也叫做简短描述符，必须包含 2 到 10 个字符（含）。其余字符留给动态后缀。

## 设置静态对账单描述符

您可以在[管理平台](https://dashboard.stripe.com/settings/business-details)中设置静态对账单描述符或缩短的描述符（前缀）。该值会出现在所有客户的收款或付款对账单上。

在下列情况下，静态对账单描述符是足够的：

- 您的公司只提供单一产品或服务。
- 您的客户理解与您的企业进行的任何交易的静态值。
- 您想为所有交易提供相同的对账单描述符。

对于银行卡收款，在下列情况下，应考虑使用一个带动态后缀的静态前缀：

- 您提供多种产品或服务。
- 您的客户可能无法理解与您的公司进行的所有交易中的某个值。
- 您更偏向于在对账单描述符中提供与交易相关的细节。

您既可以为非银行卡收款设置对账单描述符，也可以为银行卡扣款设置简短对账单描述符。

如果您设置了对账单描述符且未设置前缀（简短描述符），则对于银行卡付款，Stripe 使用对账单描述符作为前缀。如果账户对账单描述符超过 10 个字符，我们会根据需要将其截断，以满足字符限制。

## 设置动态后缀

动态后缀仅支持银行卡付款。使用后缀指定交易细节，以便客户通过其对账单清楚地了解交易。后缀与前缀、`*` 符号和空格连接在一起，形成客户看到的完整对账单描述符。

确保拼接后的描述符总长度不超过 22 个字符，包括 `*` 符号和空格。如果前缀是 `RUNCLUB`（7 个字符），动态后缀最多可包含 13 个字符 — 例如，`9-22-19 10K`（11 个字符）或 `OCT MARATHON`（12 个字符）。计算出的对账单描述符是 `RUNCLUB* 9-22-19 10K` 或 `RUNCLUB* OCT MARATHON`。

对于银行卡扣款，提供动态对账单描述符需要 `statement_descriptor_suffix` 值。对于非银行卡扣款，如果您在 PaymentIntent 上只为 `statement_descriptor` 设置了一个值，Stripe 将用它来代替账户对账单描述符（静态描述符）。

下例显示了如何向 PaymentIntent 对象添加后缀。

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1099 \
  -d currency=usd \
  -d "payment_method_types[]=card" \
  -d "statement_descriptor_suffix=example descriptor"
```

## 设置非银行卡收款的对账单描述符

使用 `statement_descriptor` 参数为非银行卡收款设置完整的对账单描述符。

创建 PaymentIntent 时，尝试为银行卡收款设置此参数会导致 400 错误。对于用银行卡完成的付款，请改用 `statement_descriptor_suffix`。

## 设置日语对账单描述符

日本商家可以设置汉字和假名对账单描述符。提供清晰易懂的对账单描述符对于减少混乱和减少撤单非常重要。我们建议在所有三种受支持的脚本（汉字、假名和拉丁字符）中设置对账单描述符。

您可以在[管理平台](https://dashboard.stripe.com/settings/business-details)中更改账户的[静态](https://docs.stripe.com/get-started/account/statement-descriptors.md#static)汉字和假名对账单描述符以及缩写描述符（前缀）。

对于银行卡扣款，您可以在 PaymentIntents 和 Checkout Session 上用汉字和假名设置[动态后缀](https://docs.stripe.com/get-started/account/statement-descriptors.md#dynamic)。我们通过连接短版前缀和分隔符来计算持卡人看到的完整描述符，方法与 `statement_descriptor_suffix` 相同。

以下示例显示如何在 PaymentIntent 上设置汉字和假名后缀。

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1000 \
  -d currency=jpy \
  -d "payment_method_types[]=card" \
  -d "statement_descriptor_suffix=example descriptor" \
  -d "payment_method_options[card][statement_descriptor_suffix_kanji]=漢字サフィックス" \
  -d "payment_method_options[card][statement_descriptor_suffix_kana]=カナサフィックス"
```

### 要求

虽然日语的对账单描述符与[英语的要求](https://docs.stripe.com/get-started/account/statement-descriptors.md#requirements)有一些共同之处，但汉字和假名描述符有一些额外要求，具体见下表。

|         | 汉字                    | 假名                |
| ------- | --------------------- | ----------------- |
| 最大总长度   | 17                    | 22                |
| 最小前缀长度  | 1                     | 2                 |
| 最大前缀长度  | 10                    | 10                |
| 支持的字符类型 | 汉字、假名和拉丁字符            | 假名                |
| 验证规则    | 不允许使用 `< > \ ' " * ＊` | 只允许使用假名、空格、破折号和句点 |

> 总长度为静态描述符或连接符（前缀 + 分隔符 + 后缀）的长度。超过最大长度的描述符将被截断。

### 发卡人行为

只有当满足以下两个条件时，日语对账单描述符才可用：

- 这张卡是在日本发行的 Visa 或 Mastercard。
- 收款由日本商家或代表日本商家处理。

对于适用的扣款，大多数发卡行使用日语而不是拉丁语。但是，是否在持卡人的对账单上显示汉字、假名或拉丁字符最终由发卡行决定。

API 响应中的[calculated_statement_descriptor](https://docs.stripe.com/api/charges/object.md#charge_object-calculated_statement_descriptor)始终是拉丁语对账单描述符，但这并不妨碍发卡行使用日语对账单描述符。

### 对账单描述符显示时间

汉字和假名对账单描述符会在捕获付款时发送给发卡行。因此，它们通常需要几天时间才能出现在持卡人的对账单上。在此期间，持卡人可能会看到一个临时描述符：

- \**Visa、Mastercard：**英文对账单描述符。
- \**JCB、Diners Club 和 Discover：**账户的默认对账单描述符。