# 本地化

了解如何为支持本地化的 Stripe API 提供翻译。

您可以通过为支持的 API 提供本地化内容，以用户首选语言向他们显示信息。

1. Stripe 为 API 组提供 *XLIFF 2.0 格式* (XLIFF (XML Localization Interchange File Format) is a standardized format used to store and transfer localizable content between different translation and localization systems)的可翻译字段。
2. 您下载并翻译目标语言的内容。
3. 您的应用程序根据用户的位置向他们提供翻译内容。

## 可本地化的 API 形状

支持本地化的端点会在 API 中公开一个新形状，专门用于允许自本地化的字符串：

```json
{
 "localization_key": "payout_methods.bank_account.account_number",
 "content": "Account Number"
}
```

该形状由两个键组成：

- **localization\_key**：标识集成商可在自己的本地化后端使用的特定语言内容，以显示相应的译文。
- **content**：是与密钥对应的翻译副本。

## 支持的 API

[PayoutMethodsBankAccountSpec](https://docs.stripe.com/api/v2/money-management/payout-methods-bank-account-spec.md?api-version=2025-04-30.preview) 端点允许您在为用户银行账户注册时本地化表单标签。

## 下载 XLIFF 文件

Stripe 提供*XLIFF 2.0 格式* (XLIFF (XML Localization Interchange File Format) is a standardized format used to store and transfer localizable content between different translation and localization systems)的可翻译字段列表。每个字段都包含一个稳定的标识符键（XLIFF 文件中的单元 ID）、一个英文翻译以及一段上下文描述。

以下示例显示了 XLIFF 文件中的可翻译字段：

```xml
<unit id="payout.methods_bank.account_account.number">
  <notes>
    <note id="n1">Form field label for bank account number.</note>
  </notes>
  <segment id="s1">
    <source>Account Number</source>
  </segment>
</unit>
```

将以下文件集成到本地化管道中，以便译员可以根据描述中提供的上下文准确翻译内容。

**资金管理本地化文件：** [stripe_api_localizations-money_movement.xlf](https://docs.stripecdn.com/a5c1f9ef04530fda8d4a3c0b1e2464d9f609214558d4b7b76c7739d3326308ca.xlf)

将文件中提供的所有字段翻译为您的业务所服务或计划服务的所有国家/地区的语言，以避免出现混合语言体验 (MLX)。MLX 是指用户只看到部分字段以其首选语言显示。如果您只翻译某一国家/地区的部分字段，可能会出现这种情况，但 Stripe 要求用户提交所有字段的信息。如果用户看到只有少数字段以其首选语言显示，而其他字段则以美式英语显示（Stripe 的默认语言和地区），这可能会让用户感到困惑，还会降低他们对您业务的信任。

## 对可本地化 API 的更改

Stripe 可保护您的本地化 API，避免引入 MLX。如果我们在次要版本中向本地化 API 添加新字段，我们会要求您重新提交您支持的 API 的当前翻译文件版本。在您提供更新的翻译文件版本之前，我们不会在 API 响应中返回新字段。