latestOpenAPI 3.0.3UNLICENSED2026-08-2196241404.2 KB

76329919f8a7

ledger-accounts

Create a bank account number for an account.

Generates a bank account number for this account in the given currency through the account-number provider. Returns the existing details if one was already generated.

post/ledger/accounts/{accountId}/account-details

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
      }
    }
  ]
}