# Pelokalan

Pelajari cara menyediakan terjemahan untuk Stripe API yang mendukung pelokalan.

Anda dapat menampilkan informasi kepada pengguna dalam bahasa pilihan mereka dengan menyediakan konten lokal untuk API yang didukung.

1. Stripe menyediakan bidang yang dapat diterjemahkan untuk Kelompok API dalam *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. Anda mengunduh dan menerjemahkan konten untuk bahasa target.
3. Aplikasi Anda menyajikan konten terjemahan kepada pengguna sesuai dengan lokasi mereka.

## Bentuk API yang dapat dilokalkan

Endpoint yang mendukung pelokalan mengekspos bentuk baru dalam API yang secara spesifik untuk memungkinkan string yang dilokalkan sendiri:

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

Bentuk ini terdiri atas dua kunci:

- **localization\_key**: mengidentifikasi konten bahasa spesifik yang dapat digunakan integrator di backend pelokalan mereka sendiri untuk menampilkan terjemahan yang sesuai.
- **content**: adalah salinan terjemahan yang sesuai dengan kunci.

## API yang didukung

Endpoint [PayoutMethodsBankAccountSpec](https://docs.stripe.com/api/v2/money-management/payout-methods-bank-account-spec.md?api-version=2025-04-30.preview) memungkinkan Anda melokalkan label formulir ketika melakukan onboarding rekening bank pengguna.

## Unduh file XLIFF

Stripe menyediakan daftar bidang yang dapat diterjemahkan dalam *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). Setiap bidang berisi kunci pengidentifikasi stabil (identifikasi unit dalam file XLIFF), terjemahan bahasa Inggris, serta deskripsi kontekstual.

Contoh berikut menampilkan bidang yang dapat diterjemahkan dalam file 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>
```

Integrasikan file berikut ke dalam alur pelokalan Anda sehingga penerjemah dapat menerjemahkan konten secara akurat berdasarkan konteks yang disediakan dalam deskripsi.

**File pelokalan manajemen uang:** [stripe_api_localizations-money_movement.xlf](https://docs.stripecdn.com/a5c1f9ef04530fda8d4a3c0b1e2464d9f609214558d4b7b76c7739d3326308ca.xlf)

Terjemahkan setiap bidang yang disediakan dalam file untuk semua negara yang dilayani atau direncanakan oleh bisnis Anda untuk menghindari Mixed Language Experience (MLX). MLX adalah ketika pengguna hanya melihat subset bidang dalam bahasa pilihan mereka. Hal ini mungkin terjadi jika Anda hanya menerjemahkan subkumpulan kolom untuk negara tertentu, tetapi Stripe mengharuskan pengguna Anda mengirimkan informasi mereka untuk semua kolom. Melihat hanya beberapa kolom dalam bahasa pilihan mereka dan kolom lainnya dalam bahasa Inggris AS (bahasa dan lokal default Stripe) dapat membingungkan pengguna dan menurunkan kepercayaan mereka terhadap bisnis Anda.

## Perubahan pada API yang Dapat Dilokalkan

Stripe memproteksi API Anda yang dilokalkan dari memperkenalkan MLX. Jika kami menambahkan bidang baru ke API yang dilokalkan selama rilis minor, kami mengharuskan Anda untuk menyerahkan ulang versi file terjemahan saat ini yang Anda dukung untuk API tersebut. Kami tidak mengembalikan bidang baru dalam respons API sampai Anda menyediakan versi file terjemahan yang diperbarui.