ledger-sub-accounts

Create sub-account for a customer.

This endpoint helps to create sub-accounts for a customer. The endpoint requires the main account ID to create a sub-account under it.

post/ledger/subaccounts

Request body

accountIdstring uuid required

The main account ID under which the sub-account will be created.

referencestring required

A unique reference for the sub-account. This must be unique across all sub-accounts.

displayNamestring

An optional name for the sub-account.

Response

Sub-account created Successfully

idstring uuid required

Unique sub-account ID

accountIdstring uuid required

The main account ID to which this sub-account belongs.

displayNamestring

An optional name for the sub-account.

referencestring required

A unique reference for the sub-account.

currencystring required

Currency of the sub-account

frozenboolean required

Indicates if the sub-account is frozen (locked) or not.

createdDatestring date-time required

The date the sub-account was created.

Example response

{
  "currency": "USD",
  "accountBalance": {
    "balance": 1000,
    "availableBalance": 1000
  }
}

Changes

Changed in 1 of the 6 revisions of this API.2

    • the endpoint scheme security HMACAuth was added to the API

      api-security-added

    • the endpoint scheme security authToken was removed from the API

      api-security-removed

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog