Quickstart: Verify your user's bank accounts

To integrate with Verification API in sandbox, do the following:

Step 1: Sign up

  1. Sign up to the TrueLayer Console to get your sandbox client_id and client_secret.
  2. Install Postman and download our sandbox Postman collection. It contains sample requests so that you can quickly retrieve data, and generate code snippets in various languages of your choice. It also has our Sandbox environment endpoints preconfigured.

Step 2: Authorise a user

Create a test authentication link to authenticate users via the Auth Link Builder in our Console. With the test auth link, you can easily connect to our mock bank.

To create your test auth link:

  1. Select the set of Permissions with info and account scopes to include in the authentication link.
  2. Choose a Redirect URI where the user will be redirected after authenticating.
  3. Check that the Mock provider is enabled to use our mock bank user credentials for testing.
  4. Select Test to open the generated test auth link and connect to our mock bank.
  5. To get an exchange code, select Mock Bank and fill in the following when asked for credentials:
    • First name: john
    • Last name: doe

Step 3: Obtain an access token

Use the Postman Exchange Code request in the Authentication folder to exchange the generated code into an access_token. To do so:

  • Add the missing variables:
    1. client_id: Your sandbox client_id. You can find this value in your console.
    2. client_secret: Your sandbox client_secret. You can find this value in your console.
    3. code: The code that you generated in Step 2 with a link to the step we're referring to here.
  • Send the request and retrieve a response containing an access_token and refresh_token.

Step 4: Access data

With the access_token, run any of the requests in the Sandbox Postman collection to verify an account holder name.


Did this page help you?