# 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).
1. Descargas y traduces el contenido a tus idiomas de destino.
1. 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 incluidos en el archivo para todos los países a los que tu empresa presta servicio o planea prestar servicio, a fin de evitar una experiencia en varios idiomas (MLX). Un MLX es cuando los usuarios ven solo un subconjunto de campos en su idioma preferido. Esto puede suceder si traduces solo un subconjunto de campos para un país determinado, pero Stripe requiere que tus usuarios envíen su información para todos los campos. Ver solo unos pocos campos en su idioma preferido y los demás campos en inglés de EE.&nbsp;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.