Make a payout to your business account

When onboarding with TrueLayer, you can choose to associate your merchant account with your business account. Some checks need to be performed as part of this.

An alternative method for withdrawing money from your merchant account to your business account is to set up merchant account sweeping.

Before you start

In order to pay out to your business account with this method, you must have associated a business account with your merchant account as part of onboarding. You need the id for this merchant account to create the payout request.

As with all Payments API requests, you also need to:

• Set up request signing so you can create a Tl-Signature header for your request.
• Generate an access token to include as a bearer token for your request.
  This should also have the appropriate scopes (payments for a single payment).

You should also provide an Idempotency-Key with each of your payout requests.

Create a payout to your business account

To create an open-loop payout, make a POST request to /payouts endpoint, providing the parameters below. You must select business_account as the beneficiary.type for an open-loop payout.

🚧

Integration options

Although the example on this page uses HTTP, we also offer complete .NET and Java libraries you can use to integrate payout creation.

This is an example of a business account payout creation request using HTTP:

POST /payouts HTTP/1.1
Content-Type: application/json; charset=UTF-8
Idempotency-Key: random
Tl-Signature: {SIGNATURE}
Authorization: Bearer {TOKEN}
Host: api.truelayer.com
{
  "beneficiary": {
    "type": "business_account",
    "reference": "TrueLayer withdrawal"
  },
  "merchant_account_id": "a",
  "amount_in_minor": 100,
  "currency": "GBP"
}

Below is an example of a successful response, including the payout id:

{  
  "id": "fb976298-dc3a-4207-b399-c1084ee8232c"
}