PayDirect to Payments v3 API: merchant account requests

Track transactions to and from your merchant account, and set up sweeping.

A merchant account is a bank account managed by TrueLayer on your behalf. The merchant account sits in the middle of the payments journey and enables the following flow of funds:

  • Payments from the end user's bank account to your merchant account (pay-ins)
  • Payments from your merchant account to the end user's bank account (payouts)
  • Payments from your corporate business account to your merchant account
  • Sweeping payments from your merchant account to your corporate business account

Find the details of this account in the TrueLayer Console, including:

  • the merchant account holder name
  • the account number
  • the sort code
  • the IBAN

All payments coming into and out of this account are recorded in the Console, except payments on a mandate.

With the PayDirect API, you could retrieve balances and transactions via API call. See below for how to migrate those calls to Payments V3 and set up sweeping variable recurring payments.

Get /balances

Docs | API specs

PayDirect endpointPayments v3 endpoint
https://paydirect.truelayer.com/v1/balanceshttps://api.truelayer.com/merchant-accounts

The v3 response includes more information than the PayDirect response, including the sort_code and account_number (for UK currency) and the merchant account id. This id identifies the merchant account that pay-ins are made into, or payouts are sent from.

{
    "items":
    [
        {
            "id": "68e11e56-1062-4529-8cc7-e5c291948db7",
            "currency": "GBP",
            "account_identifiers":
            [
                {
                    "type": "sort_code_account_number",
                    "sort_code": "040668",
                    "account_number": "00001719"
                },
                {
                    "type": "iban",
                    "iban": "GB71CLRB04066800001719"
                }
            ],
            "available_balance_in_minor": 4039,
            "current_balance_in_minor": 4039,
            "account_holder_name": "Federico Casali"
        },
        {
            "id": "dc75c4c0-85c9-489d-8394-09854f651d4e",
            "currency": "EUR",
            "account_identifiers":
            [
                {
                    "type": "iban",
                    "iban": "GB21CLRB04066800002328"
                }
            ],
            "available_balance_in_minor": 9835,
            "current_balance_in_minor": 9835,
            "account_holder_name": "Federico Casali"
        }
    ]
}

Get /transactions

Docs | API specs

PayDirect endpointPayments v3 endpoint
https://paydirect.truelayer.com/v1/balanceshttps://api.truelayer.com/merchant-accounts/{id}/transactions

Set up sweeping

Docs | API specs

To set up or change automated sweeping settings, you need to use a different endpoint. You must also pass your merchant account id as part of the endpoint URI.

PayDirect endpointPayments v3 endpoint
https://paydirect.truelayer.com/v1/sweephttps://api.truelayer.com/merchant-accounts/<merchant_account_ID>/sweeping

There are no changes to the API request body.