Single domestic payments and single international payments are concepts defined in the Open Banking Standards.
With the Payments API, you can split single payments into one of two categories:
- A payment from a user to your TrueLayer merchant account
- A payment from a user to a bank account (either external or your own)
When you create a payment using the
/payments endpoint, you must provide information such as payment value, payment method and more. You provide this information within the different objects in your POST request to the API.
Some objects you configure as part of a payment require more consideration than others. Specifically, the
providers object refers to the financial provider a payment is made through, typically a bank. When you configure a payment, you can:
- require that the payment is made through a specific provider
- list only certain providers as a payment option
- filter providers based on certain criteria such as payment scheme
users object enables you to provide user information as part of a payment. This includes user
id, name, email, date of birth, phone number, and address.
Reusing the user
id for multiple payments enables you to build a profile of their payments. It's also important to collect personal information as part of a payment to ensure compliance with financial regulations.
There are a range of possible payment statuses that inform you of the progress of a payment. If a payment fails, the payment status can tell you why.
In addition to payment statuses, the errors that the Payments API returns include reasons why a payment doesn't work.
Updated 4 months ago