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
  }'
{
  "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 , where is your access token.

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