UI hosted on a TrueLayer webpage

Use a hosted TrueLayer UI for a simplified integration experience.

A hosted authorisation UI is a payment flow where users:

  1. Click to make a payment in your app or website.
  2. Are redirected to the TrueLayer auth UI to authorise the payment.
  3. Are redirected back to your app or website when the payment is complete.
A hosted UI takes the paying user to a different URL to authorise the payment, then returns them to your site or app.

A hosted UI takes the paying user to a different URL to authorise the payment, then returns them to your site or app.

The alternative to a hosted UI is an embedded UI. This is where the UI renders directly within your app or website without the need for any redirects.

TrueLayer offers two hosted authorisation UIs: the new hosted page, which we're rolling out right now, and the legacy hosted payment page (HPP).

New hosted page

The hosted page is TrueLayer's latest hosted authorisation UI, and provides access to the latest features. For example, it includes the ability for users to save their payment details to simplify future payments.

An example of the Hosted page payment flow for returning users.

An example of the hosted payment page flow for returning users.

If you need to use a hosted authorisation UI, we recommend that you use the new hosted page over the legacy hosted payment page. Currently, you can only use the hosted page for UK payments, not European payments, nor mandates.

Learn more about the new hosted page.

Legacy hosted payment page

The legacy hosted payment page is a prebuilt UI for the payment authorisation flow.

It's available for desktop and mobile, supports payments across Europe, and is localised into 10 languages. Along with the hosted page, it has one of the simplest integration processes to get started with the Payments API. It also supports Signup+ and VRP mandates, where available.


An example of the

Screens from the hosted payment page user flow.

Learn more about the hosted payment page.