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, trusted payeeTrusted Payee A trusted recipient for payments, including the business or individual's details and their bank account or instrument details. Sending to a Trusted Payee may let customers skip Strong Customer Authentication (SCA) on Outgoing Wire Transfer or Send transactions, reducing the number of approval steps required. Previously referred to as a Beneficiary. management, account details, OTP entry, password and biometric prompts, terms acceptance, and user consent dialogs.

Supported languages

Language	Locale code
English (default)	en
French	fr
German	de
Italian	it

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: "fr",
        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, fr, 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.