Sub Accounts let you route incoming payments into other external accounts (apart from your main settlement account). Instead of manually calculating and splitting revenue, you set a percentage for each sub-account, and Monnify handles the distribution automatically.

This is ideal for paying vendor commissions, setting aside tax provisions, or keeping different revenue streams cleanly separated.

How to Set Up Sub Accounts

Note for Engineering Teams: Sub Accounts can be created via the dashboard or API. This guide covers the dashboard setup. For API integration, refer to the Transaction Splitting / Sub Accounts Developer Documentation.

Step 1: Request Feature Access

From the email address linked to your Monnify account, send a request to our team:

1. Send to: [email protected]
2. Subject: Need to Set Up Sub Accounts: [Your Business Name]
3. Body: Provide your Monnify Business Code, specify where you want the feature activated (Dashboard UI, API, or both), and briefly describe your intended use case.

Tip: You can find your Business Code at the top of your dashboard menu.

Step 2: Create Your Sub Accounts

Our team typically reviews and activates these requests within 24 hours. Once approved, you'll receive a confirmation email and a Sub Accounts option will appear in your dashboard menu.

1. On your Monnify Dashboard menu, click Sub Accounts.
2. Click Create a Sub Account.

3. Fill in the necessary details in the pop-up form. This includes the destination bank account details and the percentage of revenue this sub-account should receive from every split transaction.

4. Click Create Account to save.

Note: Your Sub-Accounts can be any valid bank account.

How to Use Sub-Accounts

Note: The combined percentage across all sub-accounts on a single transaction cannot exceed 100%. Ensure your split configuration is accurate before going live.

Once your sub-accounts are set up, you can apply them across the following payment types:

1. One-Time Payments (API only)

All one-time payments support sub-accounts. Pass your sub-account details in the incomeSplitConfig array of your payment request. See the Monnify API Reference for more details.

1. Reserved Accounts (API only)

Pass your sub-account details in the incomeSplitConfig field of your Create Reserved Account request. See the Reserved Account Developer Documentation for more details.

1. Offline Products (Dashboard only)

When creating an Offline Product, select the sub-account(s) you want to attach in the Sub Accounts section of the product setup form.

1. Direct Debit and Card Tokenization (API only:

Sub-accounts can also be applied to Direct Debit and Card Tokenization transactions via the incomeSplitConfig array.

1. Direct Debit: Pass the sub-account details at the point of debiting the mandate. See the Debit Mandate API Reference.
2. Card Tokenization: Pass the sub-account details when charging a card token. See the Card Tokenization API Reference.