# Localización

Descubre cómo traducir las API de Stripe que admiten localización.

Puedes mostrar información a los usuarios en su idioma preferido proporcionando contenido localizado para las API admitidas.

1. Stripe proporciona los campos traducibles para un grupo de API en *formato 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. Tú descargas y traduces el contenido para tus idiomas de destino.
3. La aplicación brinda el contenido traducido a los usuarios según su ubicación.

## Forma de API localizable

Los puntos de conexión que admiten la localización exponen una nueva forma dentro de la API específicamente para permitir cadenas autolocalizadas:

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

Esta forma consta de dos claves:

- **localization\_key**: identifica una parte del contenido específica del idioma que los integradores pueden usar en su propio back-end de localización para mostrar la traducción correspondiente.
- **content**: es el texto traducido que corresponde a la clave.

## API admitidas

El punto de conexión [PayoutMethodsBankAccountSpec](https://docs.stripe.com/api/v2/money-management/payout-methods-bank-account-spec.md?api-version=2025-04-30.preview) te permite localizar las etiquetas de los formularios al integrar las cuentas bancarias de los usuarios.

## Descarga el archivo XLIFF

Stripe proporciona una lista de campos traducibles en *formato 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). Cada campo contiene una clave de identificación estable (ID de unidad en el archivo XLIFF), una traducción al inglés y una descripción contextual.

En el ejemplo siguiente se muestra un campo traducible en el archivo 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>
```

Integra el siguiente archivo en tu proceso de localización para que los traductores puedan traducir con precisión el contenido en función del contexto proporcionado en la descripción.

**Archivo de localización de gestión de dinero:** [stripe_api_localizations-money_movement.xlf](https://docs.stripecdn.com/a5c1f9ef04530fda8d4a3c0b1e2464d9f609214558d4b7b76c7739d3326308ca.xlf)

Traduce todos los campos incluidos en el archivo para todos los países en los que tu empresa opera o planea operar, con el fin de evitar una experiencia de idioma mixto (MLX). Una MLX ocurre cuando los usuarios ven solo una parte de los campos en su idioma preferido. Esto puede suceder si traduces solo algunos campos para un país específico, aunque Stripe exige que los usuarios completen la información en todos los campos. Ver solo algunos campos en su idioma preferido y el resto en inglés de EE.&nbsp;UU. (idioma y configuración regional predeterminados de Stripe) puede generar confusión y reducir la confianza en tu empresa.

## Cambios en las API localizables

Stripe protege tus API localizadas para que no introduzcan un MLX. Si agregamos nuevos campos a una API localizada durante una versión secundaria, te pedimos que vuelvas a enviar la versión actual del archivo de traducción que admites para la API. No devolveremos los nuevos campos en la respuesta de la API hasta que proporciones una versión actualizada del archivo de traducción.