POST
/
merchants
/
accounts
/
add
cURL
curl -X POST "https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/add" \
  --header "Authorization: Bearer your-jwt-token" \
  --header "Content-Type: application/json" \
  --header "Accept-Language: en" \
  -d '{
      "organisationId": "FYH0NTVW0DXK",
      "accountName": "KHUSA VILLAGE BANKS",
      "currencyCode": "MWK",
      "levelNumber": "1",
      "capturedBy": "johndoe@example.com"
   }'
{
  "organisationId": "FYH0NTVW0DXK",
  "merchantAccountNumber": 35253486
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer , where is your access token.

Headers

​
Accept-Language
string
default:en

Preferred language for the response

Body

application/json
​
organisationId
string
required

The unique identifier of the organization

Example:

"FYH0NTVW0DXK"

​
accountName
string
required

The name of the merchant account

Example:

"KHUSA VILLAGE BANKS"

​
currencyCode
string
required

The currency code for the merchant (e.g., "MWK")

Example:

"MWK"

​
levelNumber
integer
required

The level number for the merchant. See Get Authorization Levels for available levels.

Example:

"1"

​
capturedBy
string<email>
required

Email address of the user creating the merchant

Example:

"johndoe@example.com"

Response

201 - application/json

Created - Merchant successfully created

​
organisationId
string

The unique identifier of the organization

Example:

"FYH0NTVW0DXK"

​
merchantAccountNumber
integer

The merchant account number

Example:

35253486