Console basics

Use Console to manage your different integrations and quickly access payments data.

Console is a back-office platform for your integration that contains a variety of functionality and information. For example, you can do the following (and more):

Organisations and apps

In Console, you work within applications, which represent a single payments integration. Applications are grouped within organisations, so a single business can have multiple applications in one place, for different countries for example.

Generally, the hierarchy in Console is organisation > application > users. Learn more about organisations and user management in Console.

At any time in Console, you can click your initials in the top-right corner to change the organisation you're signed into, or to set up multi-factor authentication .

Signing up to Console

To use TrueLayer products, you need to sign up to Console. When you first sign up for Console, a dialog displays that contains instructions on how to get started.

If you don't see an email from us when you sign up for Console, check your spam folder and ensure you can receive emails from the @truelayer.com domain.

Console home page

The screen that displays when you sign into Console.

The screen that displays when you sign into Console.

If you're the owner of an organisation, you can click the edit icon next to the organisation name in the top-left corner to change the name.

The Console homepage displays the three apps you've accessed most recently. You can also click the initials of the organisation's name in the top-left corner to switch between the different organisations you have access to. The left bar contains the following options:

Icon in menuDescription
Icon

Home

Navigate to the Console Home page, which contains links to your three most recently accessed apps and various other information.
Icon

Apps

Opens the Applications page, which contains a full list of apps you have access to within the current organisation you have open.
Icon

Providers

Opens the Supported Providers page.
Icon

Products

Opens the Products page, which contains an overview of the available TrueLayer products and add-ons.

App overview page

When you open an app from the shortcuts on the Home page, or Apps page, the overview page for that app displays.

The screen that displays when you open an app.

The screen that displays when you open an app.

You access most of the functionality for your app from the horizontal tab bar near the top of the page. There's also a variety of links and shortcuts, including to this docs site, the TrueLayer status page, and to quickly add people to your application.

The tab bar contains tabs for the following functionality:

Tab bar pageDescription
OverviewTakes you to the app overview page.
Merchant accountShows the balance of any merchant accounts in your app. You can also:

- View and export the Historical Balances for the past day or month for each account.
- View and export the Transactions for a given date for each account.
- Set up Merchant account sweeping to automate fund withdrawals from your accounts.
- View the merchant account Details, such as the id, beneficiary name, and bank details.
PaymentsAccess the Payments view, where you can view and filter a list of payments. You can also export reports and refund payments.
Product UITakes you to a page where you can customise and preview your user interface for the Payments API, specifically the hosted payments page and embedded payments page.

If you're integrating the Data API add-on, you can customise the the auth dialog here, and also create auth links with the auth link builder.
PeopleA page that displays who is currently a member of your app, along with their role, MFA status, and the time of their last interaction.

If you have sufficient permissions, you can add new members, edit an existing member's role, or remove existing users from the app.

There's also a tab you can use to check on pending invites and generate links to help them sign up.
SettingsA range of settings and resources to help you manage your integration. On this page you can:

- View your client_id and reset your client_secret.
- Set Redirect URIs to specify where your users are directed after a payment.
- Upload you public key within Signing keys so you can sign your requests.
- Set your Webhook URI so you can get webhook notifications.
- Decide whether to display for legacy products.
ProductsView a list of TrueLayer products and whether they're active. There are also links to learn more or to contact us to enable them.

Sandbox vs Live

If you have opened an app in Console, you see a Sandbox <> Live toggle in the top-right corner. Use this to switch between the sandbox and live environments. If you're in the sandbox environment, a yellow Sandbox banner displays at the top of the screen.

In the sandbox environment, no real money is moved, so it's ideal for testing and learning about TrueLayer's APIs.

Your sandbox client_id and client_secret are different to your live credentials, and you can see them on the Settings page. The Payments view and Merchant Account dashboard contain different information for both environments also.