# Localización

Descubre cómo proporcionar traducciones para 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 compatibles.

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. Descargas y traduces el contenido a tus idiomas de destino.
3. Tu aplicación muestra 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 un contenido específico del idioma que los integradores pueden usar en su propio backend de localización para mostrar la traducción correspondiente.
- **contenido**: es la copia traducida que corresponde a la clave.

## API aceptadas

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 hacer el onboarding de 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 para la gestión del dinero:** [stripe_api_localizations-money_movement.xlf](https://docs.stripecdn.com/a5c1f9ef04530fda8d4a3c0b1e2464d9f609214558d4b7b76c7739d3326308ca.xlf)

Traduce todos los campos que figuran en el archivo para todos los países en los que opera tu empresa o en los que tiene previsto operar, con el fin de evitar una experiencia con idiomas mezclados (MLX). Una MLX se produce cuando los usuarios solo ven una parte de los campos en su idioma preferido. Esto puede ocurrir si solo traduces una parte de los campos para un país determinado, pero Stripe exige a tus usuarios que rellenen todos los campos. Ver solo algunos campos en su idioma preferido y el resto en inglés de EE. UU. (el idioma y la configuración regional predeterminados de Stripe) puede confundir a los usuarios y mermar su confianza en tu empresa.

## Cambios en las API localizables

Stripe protege tus API localizadas de introducir un MLX. Si añadimos nuevos campos a una API localizada durante una versión menor, requerimos que vuelvas a enviar la versión actual del archivo de traducción que usas para esa API. No devolveremos los nuevos campos en la respuesta de la API hasta que proporciones una versión actualizada del archivo de traducción.