Set up TrueLayer in UAT

Before you can access banking data from TrueLayer for testing, you need to set up an integration in Codat's UAT environment. You'll need to:

  • Retrieve your secure keys from the TrueLayer live console.
  • Update your TrueLayer settings.
  • Add your secure keys to the Codat portal.
  • Enable your test TrueLayer integration.
  • Check your sync settings.

📘

Why do I need to use TrueLayer's live environment for testing?

If you use TrueLayer's live environment, you can test TrueLayer using a demo data source, or live bank accounts, so that you can:

  • Make sure you're happy with your customer journey.
  • Retrieve and check banking data.

Retrieve your secure keys from TrueLayer

To set up TrueLayer for UAT testing, you need to retrieve your secure keys from TrueLayer's live console.

  1. Sign in to your TrueLayer account, or create a new account if you don't have one already. If you're setting up an account for the first time, you're prompted to add a unique value to your client_id, and to download your client secret. You'll need this later.
  2. In the TrueLayer console, in the left pane, select DATA API.
  1. Then, if you're using a new account, select GO TO LIVE ENV. Otherwise, in the top menu, select LIVE.
  1. In the left pane, select the settings icon.

The APP SETTINGS page is displayed.

  1. In the Identifiers pane, find your client_id and copy it to a Word or similar document. If you already had a TrueLayer account, and you've forgotten your client_secret, select the refresh icon next to it to download a new one.

Stay on this page and continue to the next stage of the set up process.

Update your TrueLayer settings

Next, you need to add your redirect URIs to TrueLayer. This is the location your customers are sent to after they authorise your connection to their banking data. When you start testing, you'll follow the same process that your customers will.

Even though you're integrating with TrueLayer's live environment, you need to add both URIs described below.

  1. Still on the APP SETTINGS page, in the Allowed redirect URIs pane, delete any existing URIs, and then select the plus icon.
  2. Enter https://truelayer-uat.codat.io/oauth/callback, and then select the tick icon to save.
  3. Repeat step 2, this time enter https://truelayer.codat.io/oauth/callback.

Your TrueLayer configuration is complete.

Add your secure keys to Codat

You now need to configure TrueLayer in Codat's UAT portal.

  1. Open the Codat portal in UAT and log in.
  2. In the left pane, select Integrations > Banking Integrations.
  3. Find TrueLayer and select Manage next to it.
    The TrueLayer Credentials page is displayed.
  4. Find the secure keys you retrieved earlier and paste in the client_id and client_secret, and then select Save.
  5. Repeat step 2.
  6. Find TrueLayer Open Banking and select Manage next to it.
    The TrueLayer Open Banking Credentials page is displayed.
  7. Repeat step 4.

Enable your TrueLayer integration in the Codat portal

Now you're ready to enable the TrueLayer integration in the Codat UAT portal.

  1. In the left pane of the portal, select Integrations > Banking.
  2. Use the toggles next to TrueLayer and TrueLayer Open Banking to update them from Disabled to Enabled.
  3. In the Banking Sources panel, in the TrueLayer and TrueLayer Open Banking columns, scroll down the list and select the banking data sources that you need to connect to. If you want to use a demo bank account with test data, select Demo Bank from the TrueLayer Open Banking column.
  4. Scroll back up the page to the top of the Banking Sources panel and select Save Changes.
    A confirmation message is displayed.

Check your sync settings in the Codat portal

To view any test data from linked bank accounts straight away in the Codat UAT portal, configure your sync settings correctly.

  1. In the left pane of the portal, select Account > Sync Settings.
  2. In the list of data types, find Bank Statements and set the Fetch on first link toggle to On.
  3. Select Save Changes to update your configuration.

Now follow the instructions in Test TrueLayer to test your setup.


Did this page help you?