UI hosted on a TrueLayer webpage

Use a hosted TrueLayer UI for a simplified integration experience.

TrueLayer offers two hosted authorisation UIs, the hosted page and the hosted payment page (HPP).

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.

Our UIs have a number of benefits. Along with other benefits, they:

  • are faster to integrate and go live with.
  • make it simpler to expand into new geographies or products.
  • don't need any maintenance if bank flows change, or TrueLayer coverage expands.

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 page payment flow for returning users.

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

You can set up your integration to use the hosted page for payments where it's possible, and to fall back to the hosted payment page for other payments.

Learn more about the hosted page.

Hosted payment page

The hosted payment page is a prebuilt UI you can use for your user's 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.


An example of the

Screens from the hosted payment page user flow.

Learn more about the hosted payment page.