Skip to main content

Localization (iOS SDK)

Our mobile SDK ships with built-in translations for all on-screen text shown by its UI components, including login confirmation, payment authorization, beneficiaryBeneficiary A trusted recipient for payments that includes both information about the business or individual as well as their bank account or instrument details. When using trusted beneficiaries, customers may be allowed to skip Strong Customer Authentication (SCA) when executing Outgoing Wire Transfer or Send transactions, reducing the number of approval steps required. management, account details, OTP entry, password and biometric prompts, terms acceptance, and user consent dialogs.

Supported languages

LanguageLocale code
English (default)en
Germande
Italianit

If the user's device language isn't on this list, the SDK falls back to English.

email language is separate

This page covers the SDK's UI strings only. To control the language of emails and other communications sent to users, see setting brand and locale.

How the SDK selects the language

The SDK uses the standard iOS localization system through NSLocalizedString. It picks the language from the user's preferred app languages, set under Settings → General → Language & Region → iPhone Language, or the per-app override under Settings → [Your App] → Language.

No code changes are needed. The SDK switches automatically when the user changes the device language.

Overriding the language

To run the SDK in a language other than the device language, use iOS's per-app language setting under Settings → [Your App] → Language. This is the supported, user-facing model for selecting an app's language on iOS 13 and later.

The SDK doesn't expose a programmatic API for forcing a locale at runtime.

KYC flow language

The KYCKYC Know Your Customer - the identity verification process for consumer identities. This process allows you to seamlessly and securely verify your user's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. flow runs on a separate provider with its own translation set. Set the KYCKYC Know Your Customer - the identity verification process for consumer identities. This process allows you to seamlessly and securely verify your user's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. language explicitly using the locale field on KYCFlowData:

UXComponents.kyc.startKyc(
viewController: presentingViewController,
kycData: KYCFlowData(
reference: reference,
locale: "de",
brandingConfig: brandingConfig
),
// ...
)

Set locale to match the language you want the user to see for KYCKYC Know Your Customer - the identity verification process for consumer identities. This process allows you to seamlessly and securely verify your user's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. — it doesn't have to match the SDK's UI language. The value follows ISO 639-1 (for example, en, de, it). If you pass an unsupported value, the KYCKYC Know Your Customer - the identity verification process for consumer identities. This process allows you to seamlessly and securely verify your user's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. flow falls back to English.