Get Merchant

cURL

curl -X GET "https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/get?merchantAccountNumber=35223486" \
  --header "Authorization: Bearer your-jwt-token" \
  --header "Accept-Language: en"

import requests

url = "https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/get"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/get', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/get",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/get"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/get")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "accountName": "SkyLink Aviation Services",
  "currencyCode": "MWK",
  "categoryCode": "AVI",
  "categoryName": "Aviation",
  "postalAddress": "P.O. Box 30245, Lilongwe, Malawi",
  "organisationId": "FYH0NTVW0DXK",
  "levelNumber": 3,
  "levelName": "Initiator -> Approver",
  "capturedBy": "admin@example.com",
  "merchantAccountNumber": 35253486,
  "classificationCode": "SME",
  "classificationName": "Small to Medium Enterprise",
  "collectionFeeRuleCode": "CC",
  "collectionFeeRuleName": "Charge Fees To The Customer",
  "disbursementFeeRuleCode": "CM",
  "disbursementFeeRuleName": "Charge Fees To The Merchant",
  "accountBalance": 1250000,
  "revenueAmount": 18500,
  "statusCode": "A",
  "statusName": "Active",
  "dateCreated": "2026-07-09T08:45:27.583Z"
}

GET

merchants

accounts

get

cURL

curl -X GET "https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/get?merchantAccountNumber=35223486" \
  --header "Authorization: Bearer your-jwt-token" \
  --header "Accept-Language: en"

import requests

url = "https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/get"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/get', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/get",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/get"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://dev.api.onekhusa.com/sandbox/v1/merchants/accounts/get")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "accountName": "SkyLink Aviation Services",
  "currencyCode": "MWK",
  "categoryCode": "AVI",
  "categoryName": "Aviation",
  "postalAddress": "P.O. Box 30245, Lilongwe, Malawi",
  "organisationId": "FYH0NTVW0DXK",
  "levelNumber": 3,
  "levelName": "Initiator -> Approver",
  "capturedBy": "admin@example.com",
  "merchantAccountNumber": 35253486,
  "classificationCode": "SME",
  "classificationName": "Small to Medium Enterprise",
  "collectionFeeRuleCode": "CC",
  "collectionFeeRuleName": "Charge Fees To The Customer",
  "disbursementFeeRuleCode": "CM",
  "disbursementFeeRuleName": "Charge Fees To The Merchant",
  "accountBalance": 1250000,
  "revenueAmount": 18500,
  "statusCode": "A",
  "statusName": "Active",
  "dateCreated": "2026-07-09T08:45:27.583Z"
}

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

Query Parameters

merchantAccountNumber

string

required

Merchant account number to retrieve

Response

200 - application/json

Success Response (200)

accountName

string

The name of the merchant account

Example:

"SkyLink Aviation Services"

currencyCode

string

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

Example:

"MWK"

categoryCode

string

The category a merchant account belongs to i.e. Aviation

Example:

"AVI"

categoryName

string

The name qualifying the category code

Example:

"Aviation"

postalAddress

string

The postal address of the merchant

Example:

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

organisationId

string

The unique identifier of the organization

Example:

"FYH0NTVW0DXK"

levelNumber

integer

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

Example:

3

levelName

string

Human-readable level name

Example:

"Initiator -> Approver"

capturedBy

string

Email address of the user creating the merchant

Example:

"admin@example.com"

merchantAccountNumber

integer

The unique identifier of the merchant account

Example:

35253486

classificationCode

string

The code assigned to merchant classification.

Example:

"SME"

classificationName

string

The name qualifying the classification code

Example:

"Small to Medium Enterprise"

collectionFeeRuleCode

string

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

Example:

"CC"

collectionFeeRuleName

string

The description qualifying the rule code

Example:

"Charge Fees To The Customer"

disbursementFeeRuleCode

string

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"

disbursementFeeRuleName

string

The description qualifying the rule code

Example:

"Charge Fees To The Merchant"

accountBalance

number<decimal>

Current account balance

Example:

1250000

revenueAmount

number<decimal>

Revenue amount for the merchant account

Example:

18500

statusCode

string

Account status code

Example:

"A"

statusName

string

Human-readable status name

Example:

"Active"

dateCreated

string<date-time>

Account creation timestamp (ISO 8601)

Example:

"2026-07-09T08:45:27.583Z"

Getting Started

Accept Payments

Disbursements

Bill Payments

Merchants

Disputes

Security

Supporting APIs

Authorizations

Headers

Query Parameters

Response