POST /account/web/create_account

Create a current account for a branch or store via the Dashboard API. Linked to your main pool account and available for virtual sub-accounts.

Use this endpoint to create a current account for a specific branch or store location. Each account you create is automatically linked to your main pool account and can itself act as a pool account for virtual sub-accounts. Your business account must be in active status before you can create additional accounts.

Endpoint

POST /api/v1/account/web/create_account

Authentication

Include your JWT access token in the Authorization header.

Authorization: Bearer <access_token>

Obtain a token via POST /auth/web/login.

Request body

account_name · string

A human-readable label for the account (e.g., "Lagos Branch Sales" or "Online Store"). If omitted, the system generates a default name. Maximum 255 characters.

Example request

curl --request POST \
  --url https://baasapi.payrepmfb.com/api/v1/account/web/create_account \
  --header "Authorization: Bearer <access_token>" \
  --header "Content-Type: application/json" \
  --data '{
    "account_name": "Lagos Branch Sales"
  }'

Response

A successful request returns the newly created account object.

status · boolean

true when the request succeeds.

response_code · string

"00" on success.

message · string

Human-readable result message, e.g. "Account created successfully".

data · object

The created account object.

Show data fields

account_number · string

The 10-digit account number assigned to the new account.

account_name · string

The name provided or the system-generated default.

account_type · string

Always "current" for accounts created through this endpoint.

status · string

Initial account status. Always "active" on creation.

balance · string

Starting balance in decimal format. Always "0.000000000" on creation.

last_balance_update · string | null

ISO 8601 timestamp of the last balance change. null on creation.

{
  "status": true,
  "response_code": "00",
  "message": "Account created successfully",
  "data": {
    "account_number": "7801234567",
    "account_name": "Lagos Branch Sales",
    "account_type": "current",
    "status": "active",
    "balance": "0.000000000",
    "last_balance_update": null
  }
}

Error codes

Response code	Meaning
41	Customer not found — your session credentials are invalid.
60	Customer not active — your business account must be activated before creating accounts.
80	Service unavailable — the core banking provider is temporarily down.
83	Provider error — the core banking system rejected the request (e.g., account limit reached).