Overview
Learn about our Payments product and how you can use it to accept payments from your users.
The TrueLayer Platform is integrated to UK and EU banks which offer Payment Initiation APIs, and provides a single public API which enables clients to request payment via all integrated banks. As our coverage for international banks grow, Payments API v2 offers full coverage to all of our integrated banks.
This feature is in private beta and is currently available to a limited number of clients. To join our private beta, contact Client Care.
To get access to the live Payments API, you must have:
- Created a TrueLayer account in the Console.
- Been approved for access to the Payments API v2.
To get support for the Payments API:
- Check the Payments API FAQs.
- Contact Client Care for help.
Supported countries
Check out our list of banks available for Payments V2 in different countries.
Integration Checklist
- Use our
/providers
endpoint to build a provider selection screen for your user to choose their bank. All assets are supplied via our/providers
endpoint. - Request an
access_token
from our authentication endpoint. - Create a new payment initiation request, specifying the provider the user has selected.
- Handle the response to allow the user to authorise the payment.
- For the
redirect
authorisation flow:- Redirect the user to the URI specified in the API response.
- Handle the user returning back from the bank on the
return_uri
you previously set in the console.
- For the
embedded
authorisation flow:- Display the inputs specified in the API response to the user.
- Submit the values they enter to our submission API.
- Repeat if the submission response specifies more inputs.
- For the
- Poll our
GET /v2/single-immediate-payments/{id}
endpoint until you see a final status, or provide a webhook URI for us to call you on.
For full guidance on including disclaimers to accept payments, refer to our Help Centre article or contact Client Care.
Test your integration in sandbox
To use the sandbox, use truelayer-sandbox.com
instead of truelayer.com
when making your requests. Make sure to use the right credentials for the sandbox.
In the sandbox, you will have access to providers that have a sandbox environment. With these providers, you can send a fake payment that will behave like a real one.
Name the payment method
When creating your checkout page, we recommend you label the payment method as Pay by bank transfer instead of using TrueLayer or Open Banking to increase user trust and confidence while paying.
See also
Updated 4 months ago