Low balance notifications for merchant accounts

You can now contact us to enable the optional balance_notification webhook. This webhook notifies you when your merchant account balance is approaching a specified threshold.

This can be useful if your integration makes payouts, to ensure none fail due to insufficient funds.

Learn more about low balance notifications.

Organisations in Console

We introduced organisations in Console. This doesn't currently affect the user experience of administrating your apps in Console, but is an underlying logic of how apps and users relate to each other. This also introduced the concept of 'roles' within Console.

Learn more about how organisations work in Console.

Provider unavailability in payment UIs

TrueLayer payment UIs now highlight when a provider is not currently available as part of the payment authorisation flow.

Release of payment links

TrueLayer's payment links product is now live. You can use payment nlinks to integrate TrueLayer payments quickly, with a customisable user interface based on the hosted payments page.

Payment links are useful for a variety of use cases and generate a itemised checkout page ideal for eCommerce and invoicing.

Learn about payment links and how to get started.

Metadata for payments in Console payments view

The optional metadata parameter that you can provide when you create a payment or payout now displays within the payment view in Console.

You provide the metadata as a series of key-value pairs when you create a payment or payout.

Provider availability in payment authorisation flow

Relevant API responses that contain provider information and IDs now also contain information about whether a provider is currently available or experiencing downtime.

This availability information affects the UI customers see when using TrueLayer payment authorisation UIs, and can be used in your own direct API integration.

See an example in the response of the /single-immediate-payments-providers endpoint.

Self serve sweeping configuration in Console

You can now configure sweeping rules in Console to automate payments from your merchant account to your business account. To do this, open the Merchant Account Sweeping tab on the Merchant Account page in Console. You can specify the threshold above which to sweep funds, and also the frequency of sweeping.

Learn how to set up sweeping in Console.

iOS SDK v2.5.0

This version of the iOS SDK includes a variety of changes, like new information for certain international payment flows, an improved provider selection flow, and new logos.

React Native SDK documentation

The latest version of the React Native SDK, v1.2.0, added support for Signup+ payments. Alongside this, we released documentation on how to integrate the React Native SDK.

Improved provider status page

We made some improvements to the TrueLayer provider status page. Each provider is now listed with their name, rather than provider id.

iOS SDK v2.4.0

The latest version of the iOS SDK includes support for Signup+, as well as several bug fixes and UI improvements.

Improved filters and exports in Console

We improved the payments view in Console, adding the ability to filter the view by a date range, and also adding more customisable fields to CSV exports.

iOS SDK v2.3.0

The latest version of the iOS SDK contains a variety of changes. Most prominently, it includes several tweaks to improve the authorisation flow for German banks, such as the ability to search for branches. It also contains UI tweaks and payment retries for failures due to 500 errors.

Signup+ general availability release

TrueLayer's Signup+ product is now fully released. You can use Signup+ to retrieve user details alongside an initial payment, simplifying the signup process and improving your user experience.

Learn how to integrate Signup+ in our documentation.

Sort code and account number payout beneficiaries

You can now specify a beneficiary of a payout using sort code and account number. To do so, select sort_code_account_numner as the value for beneficiary.account_identifier parameter when you create a payout.

React Native SDK released

The initial version of the React Native SDK has released. It supports everything that the iOS and Android SDKs support, except for UI customisation, which will come later.

December 2022

iOS SDK v2.1.0

The latest version of the iOS SDK simplifies the set up of the Payments API v3 as part of an iOS integration. It supports payment creation, mandate creation, and payment statuses.

This version works regardless of the Swift version in use, and also if there is legacy Objective-C code. Learn more in our documentation.

Decoupled payment authorisation flow

Decoupled payment flows enable payments that require customers to authorise payments in a 'decoupled' platform. For example, a separate banking app. This is a common requirement in certain countries such as Germany.

Decoupled payment authorisation is enabled by default for payments made via the HPP and EPP. As part of a direct API integration, the wait action enables you to complete this flow.

Merchant account and payments reporting in Console

We have introduced two new dashboards in Console to help you administrate your integration and view payments.

The first dashboard is the Merchant Account section in Console, and includes historical balances for the past 7 days and 6 months, the ability to generate reports for specific days or months, and easier access to information.

The second dashboard is the Payments view in Console, which includes a view of payments, their statuses and other information. This was available on request previously, but is now enabled for all Console users.

Smart retries for VRPs

We added the ability to retry payments over a mandate with a smart behaviour. This retries the payment when it's most likely to go through. To enable this, use smart as the type for the payment_method.retry parameter when you create a payment on a mandate.

November 2022

Embedded Payments page documentation

We released documentation for our embedded payments page. This enables you to display a user interface for payment and mandate authorisation embedded on a page, with no need to direct the user to a different page.

Learn about and how to set up the embedded payment page.

iOS SDK v2.0.0

This latest version of the iOS SDK added support for mandate creation through the iOS SDK. This version of the SDK also supports cocoapods.

Scheme selection at payment creation

We've added a new parameter to payment creation requests that enables you to specify your preferred scheme selection method. You can enforce instant payment schemes, allow a fall back to non-instant schemes, preselect the scheme, or let the user select a scheme.

You specify the scheme selection method in the payment_method.provider_selection.scheme_selection parameter.

Learn more about scheme select as part of a payment.

October 2022

Payments table for merchants in Console

We have released a new screen in Console that enables you to see a list of payments made to your merchant account. Learn more about the payments view, or visit the page in Console.

Reconfirmation of consent for Data connections

We released a new flow that means customers can extend their consent to the Data API without the need for strong customer authentication. To use this new flow, you use the /connections/extend endpoint.

Your user interface must be compliant in order to reconfirm consent and extend user connections. Learn more.

Previously used banks in the iOS SDK

This latest version of the iOS SDK includes an improvement where user's previously used banking providers display for easy selection in repeated payments.

September 2022

Support for France and Germany in iOS and Android SDKs

We recently added support for French and German providers to both our iOS and Android SDKs.

Execution delay testing in Sandbox

We added new testing scenarios to TrueLayer's mock providers in sandbox. You can now test payments that will either execute or be rejected with a delay. This can be useful to ensure your integrations test for potential delays in live payment scenarios.

payment_authorized webhook in Payments v3

We introduced a new payment_authorized webhook. This informs you when a payment has been authorised, but is not yet executed.

August 2022

References for pay-ins and payouts

We added a new reference parameter for payment creation requests into a merchant account. This displays next to any relevant payments in Console, and also if you use a GET request to retrieve a payment or list of transactions.

Additionally, we also introduced a metadata parameter for payouts, where you can specify up to 10 key value pairs to help with payout reconciliation.

 Payment expiration

In the Payments API v3, any payments in the UK and some EUR payments are now automatically expired after 15 minutes.

Multifactor authentication (MFA) in Console

We now support MFA for sign-ins to Console through Google Authenticator. This supports a variety of secondary authentication methods such as one-time passwords, FIDO security keys, FIDO device biometrics, and Recovery codes.

Learn how to set up MFA in Console.

July 2022

Reconfirmation of consent sandbox for Data API

We added the ability to test reconfirmation of consent for Data API connections to our sandbox environment. This can be tested through the /connections/extend endpoint.

Embedded payment authorisation flow for German payments

Refund endpoints for the Payments API v3

You can now refund payments more simply through a variety of refund endpoints, instead of having to use a payout. The new endpoints include the /payments/{id}/refunds endpoint to create a refund or get details on all refunds for a given payment, and /payments/{id}/refunds/{id} to get details for a given refund.

Learn more about refunds.

June 2022

No notable changes

May 2022

Payments API v3 general availability release

We are publicly releasing TrueLayer's Payments API v3. This new version of the Payments API includes a variety of powerful features including new, simplified, endpoints, a hosted payment page, mobile SDKs, and client and request signing libraries to help you integrate smoothly.

Europe support for the Hosted Payment Page

We've now added support for a variety of European countries to the hosted payment page. This includes Spain, Portugal, France, the Netherlands, Lithuania, and Poland. More countries will be added as they become available.

April 2022

Settlement risk flags

We have added a settlement_risk object to the payment_executed webhook. You can use this to consider payments as complete before settlement in certain low-risk scenarios.

🚧

This feature has been deprecated. You should now use the payment_creditable webhook to determine the risk of payment settlement.

Release of our variable recurring payments API

We have released a new API and series of endpoints that enable you to create and accept variable recurring payments. View our documentation to learn more.

Official wording for Data API consent collection

We have released a variety of wording and templates you can use in your Data API auth dialog to ensure it's compliant. This is subject to change, but you can always see the latest wording to use in your integration in our docs here.

Payments v3 configuration in Console

Console now contains an introductory flow that helps you get started with the Payments API v3. It also contains a variety of screens to help you configure your existing integration, for example to upload signing keys or change webhook URIs.

March 2022

QR code handoff for the hosted payment page

Payment authorisation journeys that are started on desktop now display a page with a QR code. Users can scan this to authorise their payment on mobile through their banking app for a simplified experience. No integration is required if you use the hosted payment page.

PayDirect users can now use Payments v2

All PayDirect integrations now use Payments v2 by default.

❗️

Both the PayDirect and Payments v2 APIs are now legacy APIs. Use Payments v3 for all new payments integrations.

February 2022

Payments v3 API available in beta

The Payments API v3 is now available in beta, including the API, hosted payment page, and mobile SDKs.

January 2022

Multiple apps in sandbox in Console

It's now possible to create and test multiple apps in Console. Before, you could only have one app per account.