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 '{
      "accountName": "AVIATION",
      "currencyCode": "MWK",
      "categoryCode": "8352",
      "postalAddress": "SKYLINK PO Box 30245, Lilongwe, Malawi",
      "collectionFeeRuleCode": "CM",
      "disbursementFeeRuleCode": "CM",
      "organisationId": "FYH0NTVW0DXK",
      "levelNumber": 1,
      "capturedBy": "admin@onekhusa.com"
   }'
{
  "merchantAccountNumber": 53494120,
  "accountBalance": 51027168.89,
  "revenueAmount": 0,
  "dateCreated": "2025-11-20T09:11:55.405442",
  "statusCode": "A",
  "statusName": "Active",
  "levelName": "Initiator Only",
  "categoryName": "Other Services",
  "classificationCode": "0021",
  "classificationName": "Services",
  "collectionFeeRuleName": "Charge Fees To The Merchant",
  "disbursementFeeRuleName": "Charge Fees To The Merchant",
  "accountName": "AVIATION",
  "currencyCode": "MWK",
  "categoryCode": "8352",
  "postalAddress": "FAKE ADDRESS, P.O. BOX 1234567, MALAWI",
  "collectionFeeRuleCode": "CM",
  "disbursementFeeRuleCode": "CM",
  "organisationId": "FYH0NTVW0DXK",
  "levelNumber": 1,
  "capturedBy": "admin@onekhusa.com"
}

Authorizations

ā€‹
Authorization
string
header
required

Bearer authentication header of the form Bearer Token, Where accessToken is the access token used to authenticate the request.

Headers

ā€‹
Accept-Language
string
default:en

Preferred language for the response

Body

application/json
ā€‹
accountName
string
required

The name of the merchant account

Example:

"SkyLink Aviation Services"

ā€‹
currencyCode
string
required

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

Example:

"MWK"

ā€‹
categoryCode
string
required

The category a merchant account belongs to i.e. Other Services

Example:

"8352"

ā€‹
postalAddress
string
required

The postal address of the merchant

Example:

"P.O. Box 30245, Lilongwe, Malawi"

ā€‹
collectionFeeRuleCode
string
required

The rule code to apply when charging the transaction fee on collection payment whether should be borne by the merchant or customer

Example:

"CM"

ā€‹
disbursementFeeRuleCode
string
required

The rule code to apply when charging the transaction fee on disbursement (payout) payment whether should be borne by the merchant or customer

Example:

"CM"

ā€‹
organisationId
string
required

The unique identifier of the organization

Example:

"S7JZOQY8ILJ4"

ā€‹
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:

"admin@onekhusa.com"

Response

201 - application/json

Created - Merchant successfully created

ā€‹
merchantAccountNumber
integer

The merchant account number

Example:

53494120

ā€‹
accountBalance
number<decimal>

Current account balance

Example:

51027168.89

ā€‹
revenueAmount
number<decimal>

Revenue amount for the merchant account

Example:

0

ā€‹
dateCreated
string<date-time>

Account creation timestamp (ISO 8601)

Example:

"2025-11-20T09:11:55.405442"

ā€‹
statusCode
string

Account status code

Example:

"A"

ā€‹
statusName
string

Human-readable status name

Example:

"Active"

ā€‹
levelName
string

Human-readable level name

Example:

"Initiator Only"

ā€‹
categoryName
string

The name qualifying the category code

Example:

"Other Services"

ā€‹
classificationCode
string

The code assigned to merchant classification.

Example:

"0021"

ā€‹
classificationName
string

The name qualifying the classification code

Example:

"Services"

ā€‹
collectionFeeRuleName
string

The description qualifying the rule code

Example:

"Charge Fees To The Merchant"

ā€‹
disbursementFeeRuleName
string

The description qualifying the rule code

Example:

"Charge Fees To The Merchant"

ā€‹
accountName
string

The name of the merchant account

Example:

"NOEL DEV"

ā€‹
currencyCode
string

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

Example:

"MWK"

ā€‹
categoryCode
string

The category a merchant account belongs to

Example:

"8352"

ā€‹
postalAddress
string

The postal address of the merchant

Example:

"FAKE ADDRESS, P.O. BOX 1234567, MALAWI"

ā€‹
collectionFeeRuleCode
string

The rule code to apply when charging the transaction fee on collection payment

Example:

"CM"

ā€‹
disbursementFeeRuleCode
string

The rule code to apply when charging the transaction fee on disbursement (payout) payment

Example:

"CM"

ā€‹
organisationId
string

The unique identifier of the organization

Example:

"S7JZOQY8ILJ4"

ā€‹
levelNumber
integer

The level number for the merchant

Example:

1

ā€‹
capturedBy
string<email>

Email address of the user creating the merchant

Example:

"admin@onekhusa.com"