Skip to main content
Use this endpoint to provision a current account for a branch, department, or store location within your business. The account is linked to your main pool account, and you can use each current account as an independent settlement target or as the parent pool for virtual accounts. Your business account must be active before you can call this endpoint. Endpoint 
POST https://baasapi.payrepmfb.com/api/v1/account/api/create_account
Sandbox 
POST https://shogun-dev.xchangeboxng.com/api/v1/account/api/create_account

​
Authentication

Include your Bearer token in the Authorization header: 
Authorization: Bearer <access_token>
Obtain a token from Generate Token.

​
Request body

​
account_name
string
A human-readable label for the account — for example, "Lagos Branch Sales" or "Warehouse 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/api/create_account \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "account_name": "Lagos Branch Sales"
  }'

​
Response

All responses follow the standard envelope format: status, response_code, message, and data.

​
Success

​
status
boolean
true when the request succeeds.
​
response_code
string
"00" on success.
​
message
string
Human-readable result message.
​
data
object
The created account object.
{
  "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

CodeMeaning
00Success
41Customer not found — your API credentials are invalid
60Customer not active — your business account must be activated first
80Service unavailable — the core banking provider is temporarily down
83Provider error — the core banking system rejected the request (for example, an account limit has been reached)