对账单描述符

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

在您激活账户时，可以设置一个出现在所有客户对账单上的对账单描述符（静态对账单描述符）。对于银行卡收款，您还可以创建一个包含与您的账户有关的静态前缀和与每笔收款有关的动态后缀的对账单描述符。这样您就可以指定与产品、服务或银行付款或银行卡对账单有关的具体信息。

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

对账单描述符的要求

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

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

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

设置静态对账单描述符

您可以在管理平台中设置静态对账单描述符或缩短的描述符（前缀）。该值会出现在所有客户的收款或付款对账单上。

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

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

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

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

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

如果您设置了对账单描述符且未设置前缀（简短描述符），则对于银行卡付款，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 https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=usd \
  -d "payment_method_types[]"=card \
  -d statement_descriptor_suffix="example descriptor"

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

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

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

设置日语对账单描述符

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

您可以在管理平台中更改账户的静态汉字和假名对账单描述符以及缩写描述符（前缀）。

对于银行卡扣款，您可以在 PaymentIntents 和 Checkout Session 上用汉字和假名设置动态后缀。我们通过连接短版前缀和分隔符来计算持卡人看到的完整描述符，方法与 statement_descriptor_suffix 相同。

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

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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]"="カナサフィックス"

要求

虽然日语的对账单描述符与英语的要求有一些共同之处，但汉字和假名描述符有一些额外要求，具体见下表。

发卡人行为

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

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

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

API 响应中的calculated_statement_descriptor始终是拉丁语对账单描述符，但这并不妨碍发卡行使用日语对账单描述符。

对账单描述符显示时间

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

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