POST
/
merchants
/
fees
/
calculate
cURL
curl -X POST "https://dev.api.onekhusa.com/sandbox/v1/merchants/fees/calculate" \
  --header "Authorization: Bearer your-jwt-token" \
  --header "Content-Type: application/json" \
  --header "Accept-Language: en" \
  -d '{
    "merchantAccountNumber": 81496198,
    "feeType": "D",
    "channelType": "BA",
    "transactionAmount": 100000.00
  }'
{
  "currencyCode": "MWK",
  "transactionAmount": 100000,
  "convenienceFeeAmount": 700,
  "transactionFeeAmount": 1000,
  "merchantFeeAmount": 0,
  "governmentLevyFeeAmount": 50,
  "totalFeeBeforeVat": 1750,
  "vatAmount": 306.25,
  "netFeeAmount": 2056.25
}

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
ā€‹
merchantAccountNumber
integer
required

The unique identifier of the merchant account

Required range: 10000000 <= x <= 99999999
Example:

81496198

ā€‹
feeType
string
required

The type of fee to calculate (e.g., D = Disbursement, C = Collection)

Example:

"D"

ā€‹
channelType
string
required

The channel through which the transaction is processed (e.g., BA = Bank Account, MW = Mobile Wallet)

Example:

"BA"

ā€‹
transactionAmount
number<decimal>
required

The amount of the transaction to calculate fees for

Example:

100000

Response

200 - application/json

Success Response (200)

ā€‹
currencyCode
string

Currency used for fee calculation

Example:

"MWK"

ā€‹
transactionAmount
number<decimal>

Original transaction amount

Example:

100000

ā€‹
convenienceFeeAmount
number<decimal>

Convenience/service fee

Example:

700

ā€‹
transactionFeeAmount
number<decimal>

Standard transaction fee

Example:

1000

ā€‹
merchantFeeAmount
number<decimal>

Fee charged to the merchant

Example:

0

ā€‹
governmentLevyFeeAmount
number<decimal>

Government levy applied to the transaction

Example:

50

ā€‹
totalFeeBeforeVat
number<decimal>

Total fees before VAT

Example:

1750

ā€‹
vatAmount
number<decimal>

VAT charged on the total fee

Example:

306.25

ā€‹
netFeeAmount
number<decimal>

Final calculated fee including VAT

Example:

2056.25