Sign in
OpenAPI 3.0.3UNLICENSED2026-08-1396241401.4 KB

35fe01ca087b

ledger-sub-accounts

Create a bank account number for a sub-account.

Generates a bank account number for this sub-account in the given currency through the account-number provider. The account name must be supplied by the client.

post/ledger/subaccounts/{subAccountIdRef}/account-details

Request body

accountNamestring required

Name to assign to the generated bank account.

Example request

{
  "accountName": "ACME Collections"
}

Response

Bank account number created

payinCurrencystring required

Currency the destination account accepts for the deposit.

Example response

{
  "details": {
    "accountName": "John Doe",
    "accountNumber": "230101010",
    "reference": "PROV123456"
  },
  "payinCurrency": "NGN",
  "paymentMethods": [
    {
      "fee": {
        "percentage": 0.0035,
        "fixedAmount": 1.5,
        "currency": "USD"
      },
      "limits": {
        "minAmount": 1,
        "firstParty": {
          "maxPerTransaction": 250000,
          "maxPerDay": 24000
        },
        "thirdParty": {
          "maxPerTransaction": 250000,
          "maxPerDay": 24000
        },
        "currency": "USD"
      },
      "timeline": {
        "minValue": 1,
        "maxValue": 3
      }
    }
  ]
}