We've added documentation for a new authorisation flow you can use as part of a direct API integration. In a direct API integration, you previously had to use the /v3/payments/{id}/authorization-flow endpoint to start the sequence of requests and responses that authorised a payment.
You can now use the authorization_flow parameter when you create a payment to start the authorisation flow. You provide the same information in. the authorisation_flow parameter as you do in the /v3/payments/{id}/authorization-flow endpoint.
Configurable waiting time for payment result screen on web
Change type
Date of change
Affected products
Affected auth flows
New feature
13 May 2024
Payments Payouts
HPP, EPP
You can now change the waiting period before the payment result screen displays in the HPP or EPP. This can be useful if you want to confirm something before finalising a payment.
👍
This behaviour applies to all new and integrations (and the associated client_ids) created from 15 April 2024. For any integrations created before this date, you need to contact us if you want to enable this behaviour.
You can see if a payout or refund has been returned in several places:
This version of the React Native SDK has been updated to use the underlying Android and iOS SDK version 3.1.0.
The most significant change in this release is the addition of the resultShown property to the processorResult type. This means that you can see which payment or mandate result screen was displayed to the user.
You can download v2.1.0 of the React Native SDK on GitHub here.
Dynamic merchant logos in the HPP and EPP
Change type
Date of change
Affected products
Affected auth flows
New feature
19 April 2024
Payments VRP
HPP, EPP
It's now possible to dynamically select a merchant logo when users authorise a payment or mandate through the hosted payment page and embedded payment page. To do this, you need to provide a URL with the required merchant logo at payment or mandate creation (which we need to approve the domain of).
Learn how to implement dynamic logos in the HPP and EPP.
Returns for payouts and refunds
Change type
Date of change
Affected products
Affected auth flows
Non-breaking change
15 April 2024
Payments Payouts
All
As of 15 April 2024, payouts and refunds can now transition from executed to failed in some rare cases. This happens when the bank 'returns' the payment. For example, when the beneficiary account has been closed.
This behaviour applies to all new and integrations (and the associated client_ids) created from 15 April 2024. For any integrations created before this date, you need to contact us if you want to enable this behaviour.
You can see if a payout or refund has been returned in several places:
This version of the iOS SDK includes some visual changes, bug fixes, improvements so you can see the result screen shown to the user, and improvements to provider search for users:
Improved the UI for users to learn more about how VRP mandates work.
Added an a new resultShown enum to the processSinglePayment and processMandate completion handlers. This tells you which payment or mandate result was shown to the user if the result screen is enabled.
Users can now search for countries when selecting a provider by using a 2- or 3-letter country code.
Branch searching has been improved for users to make it easier to find an intended branch.
Default colours for primary and secondary buttons have been changed.
An error now displays in rare cases where there is no additional input available for a user to select.
You can download v3.1.0 of the iOS SDK on GitHub here.
Android SDK v3.1.0
Change type
Date of change
Affected products
Affected auth flows
New feature
4 April 2024
Payments VRP Signup+
Android
This version of the Android SDK includes some UX improvements, improvements so you can see the result screen shown to the user, and some bug fixes:
Improved the UI for users to learn more about how VRP mandates work.
There is a new ResultShown callback you can use to see the payment or mandate result that the user received.
Fixed an issue where users would be forced to update all fields if one was incorrect. For example, users would have to update both username and password if validation found that one was incorrect.
You can download v3.1.0 of the Android SDK on GitHub here.
The latest major version of the React Native SDK contains a variety of minor improvements and bug fixes. It also includes the following larger changes, which align it with the latest versions of the iOS and Android SDKs:
The introduction of the payment and mandate result screen.
This is enabled by default and you need to explicitly disable it.
The UI now displays Signup+ specific wording when signupplus is specified as a related_product at payment creation.
Made optimisations to the decoupled authorisation flow for payments in Spain.
Added localisation for the Italian language.
Added a default merchant logo if one hasn't been uploaded in Console.
You can download v2.0.0 of the React Native SDK on GitHub here
The Android SDK no longer supports the Material Theme adaptor.
The UI now displays Signup+ specific wording when signupplus is specified as a related_product at payment creation.
Made optimisations to the decoupled authorisation flow for payments in Spain.
Added localisation for the Italian language.
Added a default logo in case the merchant doesn't upload a logo in Console.
You can download v3.0.0 of the Android SDK on GitHub here.
Removal of Material Theme adaptor for Android SDK
Change type
Date of change
Affected products
Affected auth flows
Non-breaking change
21 February 2024
Payments VRP
Android
In v3.0.0 of the Android SDK, we removed the Material Theme adaptor. If you used that, you need to migrate to Compose when you update to the latest version of the Android SDK.
New /payment-providers/search endpoint
Change type
Date of change
Affected products
Affected auth flows
New feature
1 February 2024
Payments VRP
HPP, EPP, iOS, Android, React Native, Direct API integration
Previously, if you wanted to get a full list of providers, you had to use one of the following options:
There is now an optional payment_settlement_stalled webhook you can enable that informs you if a payment hasn't settled after a certain period of you time.
In Console, you can now build and test a customised UI for payment authorisation through the EPP.
Users can now see scheme fees in TrueLayer payment UIs
Change type
Date of change
Affected products
Affected auth flows
New feature
November 14 2023
Payments VRP
HPP, EPP, iOS, Android, React Native
If you use TrueLayer's hosted payment page or embedded payment page, your users now see a message advising them about fees when they select a payment scheme to make their payment over (if applicable).
The payment auth flow now adapts to Signup+ payments
Change type
Date of change
Affected products
Affected auth flows
New feature
November 7 2023
Signup+
HPP, EPP, iOS, Android, React Native
If you use a TrueLayer payment authorisation UI, such as the HPP, EPP, or mobile SDKs, the user flow automatically adapts if a payment is made through Signup+. In this case, screens are omitted from the user flow to create a quicker and easier payment experience.
Our Shopify eCommerce plug-in is now available on the Shopify app store.
This plugin enables Shopify merchants to accept open banking payments through our HPP. It also enables merchants to issue refunds directly through the admin panel in Shopify.
Installation is entirely no-code and completed within Shopify, with no need to generate keys locally.