Mock providers

Learn about the mock providers you can use to test your integration with the Payments API v3 in sandbox.

TrueLayer provides mock providers per country with payments API v3 . You can use them to test your integration, regardless if you are integrating via our Hosted Payments Page, via our iOS or Andriod SDKs, or via a direct API integration.

Based on how you create the payment, you will see different banks available within HPP or SDKs as you are testing. For direct integration, you would observe this take effect in the list of providers you receive for provider_selection action.

📘

Payment creation limit

When selecting merchant_account as payment_method.beneficiary.type, amount_in_minor cannot exceed 50000.

Mock UK Payments - Redirect Flow

By choosing currency as GBP and making sure country filter for user_selected type provider_selection is either empty or filled with GB, you can enable Mock UK Payments - Redirect Flow to be visible during authorisation.

Mock UK Payments - Redirect Flow simulates UK banks that use the redirect authorisation flow.

When you initiate a payment using this provider, we will return a URI to redirect your user to our mock provider authorisation page.

UI for `mock-payments-gb-redirect`UI for `mock-payments-gb-redirect`

UI for mock-payments-gb-redirect

On the authorisation prompt page, different actions lead to different outcome for the payment.
The following table describes the different actions you can make on the authorisation page and their outcomes:

OutcomeActionUsername
ExecuteEnter usernametest_executed
Auth failureEnter usernametest_authorisation_failed
Execution RejectionEnter usernametest_execution_rejected
CancellationClick cancel button-

Once you log in with one of the predetermined usernames, the mock provider will present the account selection page. When you provide the remitter account details in the payment initiation request, only the stated account can be selected on this screen.

Mock Ireland Payments – Redirect Flow

By choosing curreny as EUR and making sure country filter for user_selected type provider_selection is either empty or filled with IE, you can enable Mock UK Payments - Redirect Flow to be visible during authorisation.

Mock Ireland Payments – Redirect Flow represents the typical redirect authorisation flow used by a bank in Ireland.

UI for `mock-payments-es-redirect`UI for `mock-payments-es-redirect`

UI for mock-payments-es-redirect

When you initiate a payment using this provider, we will return a URI to redirect your user to our mock provider authorisation page.

Different actions on this page will lead to different outcomes for the payment.
The following table describes the different actions you can make on the authorisation page and their outcomes:

OutcomeActionUsername
ExecuteEnter usernametest_executed
Auth failureEnter usernametest_authorisation_failed
Execution RejectionEnter usernametest_execution_rejected
CancellationClick cancel button-

After you log in with one of the predetermined usernames for the test case, an account selection page will be the next step. If you provide the remitter account details in the payment initiation request, you can only select the account with those details on this screen.


Did this page help you?