---
title: "Create A Subaccount"
method: POST
path: "/payaza-account/api/v1/subaccounts/merchant"
tags: ["Sub Accounts"]
---

# Create A Subaccount

`POST /payaza-account/api/v1/subaccounts/merchant`

This endpoint is used to create a subaccount. 

> **Notes:**
>
> 1. Please be advised that access to this API is available upon request. To initiate this process, kindly send an email to **support@payaza.africa**. You will be granted access once our team reviews and approves your request.
>

## Request body

- CreateASubAccountRequest
  - `mainAccountPayazaReference` string, required — The account reference of the main Payaza account.
  - `name` string, required — The name of the sub-account being created.
  - `currency` string, required — The currency code.
  - `country` string, required — The country code in ISO 3166-1 alpha-3 format (e.g., NGA).

## Response `200`

Subaccount creation successful

- CreateASubAccountResponse
  - `message` string — Response message.
  - `status` boolean — Request status.
  - `data` object[] — List containing the newly created account details.
    - `id` integer — Unique identifier for the sub-account.
    - `accountName` string — Name of the sub-account.
    - `accountStatus` string — Current status of the account (e.g., ACTIVE).
    - `accountBalance` number, double — Current available balance.
    - `escrowBalance` number, double — Balance currently in escrow.
    - `businessFk` integer — Foreign key linking to the main business entity.
    - `currency` string — Currency code.
    - `owner` string — Owner of the account.
    - `country` string — Country code.
    - `creationReference` string — Unique reference generated upon creation.
    - `actionStatus` string — Action status.
    - `payazaAccountReference` string — The Payaza reference ID for this sub-account.
    - `pnc` boolean — Post No Credit status.
    - `pnd` boolean — Post No Debit status.
    - `virtualAccounts` object[] — List of virtual accounts attached to this sub-account.
      - `accountNumber` string — Virtual account number.
      - `accountName` string — Name attached to the virtual account.
      - `bankCode` string — Bank code for the virtual account.

## Other responses

- `400` — Invalid request

---

[API](https://skmtc.net/payaza/apis/payaza-documentation.md) · [All operations](https://skmtc.net/payaza/apis/payaza-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payaza/payaza-documentation/revisions/1ecd4b94ff07/schema)