# Localisation

Découvrez comment fournir des traductions pour les API Stripe qui prennent en charge la localisation.

Vous pouvez afficher des informations aux utilisateurs dans leur langue préférée en fournissant un contenu localisé pour les API prises en charge.

1. Stripe fournit les champs traduisibles d’un groupe d’API au format *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. Vous téléchargez et traduisez le contenu dans vos langues cibles.
3. Votre application propose le contenu traduit aux utilisateurs en fonction de leur emplacement.

## Forme localisable de l’API

Les points de terminaison qui prennent en charge la localisation exposent une nouvelle forme dans l’API spécifiquement pour autoriser les chaînes autolocalisées :

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

Cette forme se compose de deux clés :

- **localization\_key** : permet d’identifier un élément de contenu propre à la langue que les intégrateurs peuvent utiliser dans leur propre application dorsale de localisation pour afficher la traduction correspondante.
- **content** : il s’agit de la copie traduite qui correspond à la clé.

## API prises en charge

Le point de terminaison [PayoutMethodsBankAccountSpec](https://docs.stripe.com/api/v2/money-management/payout-methods-bank-account-spec.md?api-version=2025-04-30.preview) vous permet de localiser les libellés de formulaire lors de l’inscription des comptes bancaires des utilisateurs.

## Télécharger le fichier au format XLIFF

Stripe fournit une liste des champs traduisibles au format *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). Chaque champ contient une clé d’identification stable (id d’unité dans le fichier au format XLIFF), une traduction en anglais, ainsi qu’une description contextuelle.

L’exemple suivant montre un champ traduisible dans le fichier au format 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>
```

Intégrez le fichier suivant dans votre pipeline de localisation afin que les traducteurs puissent traduire avec précision le contenu en fonction du contexte fourni dans la description.

\**Fichier de localisation de la gestion financière&nbsp;: ** [stripe_api_localizations-money_movement.xlf](https://docs.stripecdn.com/a5c1f9ef04530fda8d4a3c0b1e2464d9f609214558d4b7b76c7739d3326308ca.xlf)

Traduisez tous les champs fournis dans le fichier pour tous les pays que votre entreprise dessert ou prévoit de desservir pour éviter une expérience multilingue (MLX). On parle de MLX lorsque les utilisateurs ne voient qu’une partie des champs dans leur langue préférée. Cela peut se produire si vous ne traduisez qu’une partie des champs pour un pays donné, mais que Stripe exige de vos utilisateurs qu’ils renseignent tous les champs. Le fait de ne voir que quelques champs dans leur langue préférée et les autres en anglais américain (la langue et les paramètres régionaux par défaut de Stripe) peut dérouter les utilisateurs et nuire à leur confiance envers votre entreprise.

## Modifications apportées aux API localisables

Stripe protège vos API localisées contre l’introduction d’une expérience&nbsp;MLX. Si nous ajoutons de nouveaux champs à une API localisée dans une version mineure, nous vous demanderons de soumettre à nouveau la version actuelle du fichier de traduction que vous prenez en charge pour l’API. Nous ne renvoyons pas les nouveaux champs dans la réponse de l’API tant que vous n’avez pas fourni une version mise à jour du fichier de traduction.