Mobile SDKs: Android, iOS, React
TrueLayer's iOS, Android, and React Native SDKs enable native payment authorisation flows on mobile devices.
TrueLayer offers mobile SDKs for Android, iOS and React. These provide out-of-the-box UIs and functionality for authorising payments and mandates.
They present native screens that allow your user to select their bank and consent to the payment or mandate. Then, they redirect users to their banking app or website for authorisation.
The SDKs also include options to customise your UI. Android supports app-to-app redirects.
EU payments
We recommend mobile SDKs for all mobile payments, particularly for accepting payments in the EU. The additional considerations needed for EUR payments are all included within the hosted and embedded payments pages, including all auth flows and optimised provider search. No extra development needed.
Update your version of the SDK
We’re rolling out Android 4.0.0 and iOS 4.0.1, a major update to our mobile SDKs, introducing a refreshed user experience and powerful new features — including support for payment retries.
This is a breaking release: to get the new UI and behaviour, your app must meet new requirements.
Minimum requirements
| Android | iOS |
|---|---|
The Kotlin version is now 2.1.20 | Your end users must be on iOS 15 or later to see the new UI and use all features. |
The Compose BOM is now 2025.06.01 | The SDK will continue to support apps targeting iOS 14 and above, but users on iOS 14 will not see the updated interface. |
minSdk = 24compileSdk = 35targetSdk = 35 | The .redirect success status is removed entirely from iOS. It produces compiler errors if not fixed or accommodated for. |
In addition to these requirements, these new features are only supported for payments in the UK (GBP) or Ireland (EUR).
If you have implemented custom code or workarounds based on the previous redirect flow, these are no longer supported and may break in this release.
We're also deprecating older versions of the redirect flow as part of this change. The SDK now uses an uninterrupted flow, where a single view controller (or Activity on Android) is used only once for the entire payment, without having to invoke the SDK initialisation method twice.
New features
Payment retries
We now support payment retries in the SDK for GBP and Irish EUR payments. This lets users retry a failed payment attempt without needing to start the flow from scratch.
We recommend enabling TrueLayer result screens by setting featureFlag to true (these screens do appear by default).
If result screens are not enabled, your users won’t be able to retry a payment at the end of the flow, but can retry them if they request to cancel the payment.
Returning user journey
The SDK now preselects a recommended provider for returning users, enabling faster, simpler payments — in some cases, users can complete a payment in just one tap.
- Matching is based on the user's email address, not a user ID.
- This logic relies on previous successful usage of the SDK.
Updated user interface
We’ve refreshed the mobile SDK UI for a smoother and more consistent experience. The new interface will automatically appear for users on iOS 15 and above.
Legacy versions
Older versions of the SDK will continue to work, but they will not receive new features.
Updated 6 days ago