> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vestrapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Services and splits overview

> Set up services, accounts and splits in the merchant dashboard so that one customer payment can settle to several bank accounts.

Many businesses collect money that is not all theirs. A school collects tuition and insurance. A licensing agency collects a fee that is shared with a federal body and an insurer. A marketplace collects an order and owes part of it to a seller. In each case the customer makes one payment, and the money has to reach several bank accounts in the right proportions.

Vestrapay handles that division for you. You describe the arrangement once in the merchant dashboard. From then on, every payment that names it is allocated automatically and settled to the right accounts, with a record of exactly what went where.

The dashboard pages for this are **Services** and **Accounts**. You work in the dashboard for the sandbox at [merchant.sandbox.vestrapay.app](https://merchant.sandbox.vestrapay.app) and for live at [merchant.vestrapay.com](https://merchant.vestrapay.com). The two environments are separate, so you set up each one on its own.

## The building blocks

> [card] [Services](https://docs.vestrapay.com/services/splits.md)
>
> A named revenue stream, such as Tuition or Platform fee. Each has a service key that your payments use.

> [card] [Sub-accounts](https://docs.vestrapay.com/services/subaccounts.md)
>
> Destination bank accounts, checked with the bank, which supplies the account holder name.

> [card] [Splits](https://docs.vestrapay.com/services/splits.md)
>
> The percentage shares that divide a service among sub-accounts. Shares total exactly 100.

### Services

A service is a named product or revenue stream that you collect money for. The **Services** page describes its purpose in one line: "Split transaction money between multiple bank accounts."

When you add a service, Vestrapay generates its **service key** from the title: lower case, with runs of other characters replaced by a dash. A service titled "Platform fee" gets the key `platform-fee`. If the key is already taken, a numeric suffix is added, as in `platform-fee-2`. The key appears on the service in the dashboard, and it is what a payment uses to refer to the service. Treat it as a stable identifier.

Every merchant also has a default service. The default service cannot be disabled.

### Sub-accounts

A sub-account is a bank account in your pool of destinations. You add it under **Accounts** by choosing a bank and entering an account number. Vestrapay asks the bank for the account holder name, so the name is never typed by you. Once an account is in the pool, any number of services can use it.

### Splits

A split is a configured share of a service. A service's splits say, for example, that 85% of every amount allocated to Tuition goes to one account and 15% to another. Each split has a title, such as FEDERAL GOVT, which appears as a tag on the settlement it produces. The shares on one service always add up to 100%.

### The primary settlement account

Your **primary settlement account** is the account you gave during KYB. It is shown under **Accounts** in the **Primary Account** section. It is never a split participant, because it already receives everything that is not allocated elsewhere: the remainder of every payment, and the whole of any payment that names no service. Think of it as the account that catches whatever the splits do not claim.

If a service has no splits, the dashboard says so: "All revenue settles to your primary account".

## How the pieces fit

```mermaid theme={"theme":{"light":"github-light","dark":"github-dark"}}
flowchart LR
  P[Customer payment 1,000.00] --> D{Distribution on initialise}
  D -->|tuition: 600| S1[Tuition service]
  D -->|insurance: 150| S2[Insurance service]
  D -->|not allocated: 250| PR[Primary settlement account]
  S1 -->|85 percent| A1[Sub-account A]
  S1 -->|15 percent| A2[Sub-account B]
  S2 -->|100 percent| A3[Sub-account C]
```

The configuration is static, and you manage it in the dashboard: services, sub-accounts and splits. The allocation is per payment: the distribution that your server sends when it initialises a payment says how much of that particular payment goes to which service. The two are deliberately separate, so a fixed arrangement can serve payments of any size and mix.

| Question | Where it is answered |
| - | - |
| Which accounts can money go to? | Sub-accounts, in the pool under **Accounts** |
| What proportion of a service goes to each account? | Splits, configured on the service under **Services** |
| How much of this payment goes to each service? | The distribution on the payments API, sent at initialise |
| Where does the rest go? | The primary settlement account |

## Setting it up

**1. Complete the KYB settlement stage**

Your primary settlement account must exist before you can add sub-accounts. See [Go live](https://docs.vestrapay.com/payments/go-live.md).

**2. Add sub-accounts**

Open **Accounts** and add each destination bank account to the pool. See [Sub-accounts](https://docs.vestrapay.com/services/subaccounts.md).

**3. Add a service**

Open **Services** and choose **Add a service**. Give it a title, then continue to the split configuration. See [Splits](https://docs.vestrapay.com/services/splits.md).

**4. Configure the splits**

Add a split for each sub-account that should be paid from this service, with shares that total 100%.

**5. Name the service when you collect**

Your server sends the service key in the distribution when it initialises a payment. See [Distribution](https://docs.vestrapay.com/services/distribution.md).

**6. Reconcile**

Verify shows how each payment was allocated, and [Settlements](https://docs.vestrapay.com/settlements/overview.md) shows how it was paid out.

## Managing services

On the **Services** page you can add a service, edit its details and splits, and enable or disable it. The **Services** page does not offer a delete action, so plan service titles with that in mind.

| To do this | Do this |
| - | - |
| Add a service | Choose **Add a service**, complete **Define service**, then **Split configuration**, and choose **Create service**. |
| Edit a service | Choose the pencil icon on the service. See [Splits](https://docs.vestrapay.com/services/splits.md#edit-a-service). |
| Stop a service taking part in new payments | Disable it. See below. |
| Take a disabled service back into use | Enable it again. |

### Disabling a service

Disabling a service stops new payments and new payment links from naming it. A payment that names a disabled service in its distribution is rejected. The configuration is kept, and payments that were initialised before you disabled it still credit their configured accounts. Existing collections and settlements are untouched. Enable the service again to resume.

The dashboard asks you to confirm in a dialog before it enables or disables a service. The default service cannot be disabled.

## Where to go next

> [card] [Sub-accounts](https://docs.vestrapay.com/services/subaccounts.md)
>
> Build the pool of destination accounts under Accounts.

> [card] [Splits](https://docs.vestrapay.com/services/splits.md)
>
> Add and edit services, and configure shares, titles and manual settlement.

> [card] [Distribution](https://docs.vestrapay.com/services/distribution.md)
>
> Allocate a single payment across services with the payments API.

> [card] [Partners](https://docs.vestrapay.com/partners/overview.md)
>
> Let an external party see the settlements they are owed.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.