Settlement Accounts

Eyowo Disburse

You can set up multiple settlement accounts either as a split payment or have a preferred account you want to settle different services you offer.

For example, if you run an e-commerce storefront, and want to settle multiple merchant accounts without getting your books messy, our multiple settlement accounts enable you to deliver instant payouts to your merchants.

There are two major types of settlement accounts: subaccount and principal.

Principal Accounts

The Principal account is the main account or primary account for all transactions. Principal accounts don’t need any prior instruction to complete transaction settlements.

Sub-Accounts

“sub” account - these accounts are substitutes to the principal account. For sub-account, we need to specify the account or accounts the value of the transaction finally settles into.

POST https://api-thirdpartydev.bank.eyowo.com/v1/checkout/account

Request Body

Name	Type	Description
accountNumber*	String	Your preferred account number either NUBAN personal or business accounts
percentage*	String	Share-value for the specified account
type*	String	Enum ["principal", "subaccount" ]

201: Created

{
  {
    "success": true,
    "data": {
        "active": true,
        "type": "principal",
        "_id": "xxx",
        "deleted": false,
        "merchantId": "xxx",
        "account": {
            "accountNumber": "xxx",
            "percentage": 0.1,
            "userId": "xxx",
            "accountRef": "xxx"
        },
        "__v": 0
    }
}
}