MerchantFeesDto
The MerchantFeesDto (Merchant Fees Data Transfer Object) defines the fee structure for financial operations conducted through the NoWallet API.
It is designed to represent fees applied to merchants based on the country, currency, mobile operator, and transaction amount range. This DTO is central to configuring and displaying transaction costs across different services.
JSON Response Example
The JSON example illustrates a typical MerchantFeesDto object. It specifies flat fees for cash-in, cash-out, and merchant operations—all set to 2.1%. It also includes metadata such as the country (CM for Cameroon), currency (XAF), and mobile operator (MTN). The rangefees array contains a fee rule that applies to transactions between 100 and 1000 units, reinforcing the API's ability to define tiered fee structures.
{
"fee_cashin": 2.1,
"fee_cashout": 2.1,
"fee_merchant": 2.1,
"country": "CM",
"currency": "XAF",
"operator": "MTN",
"rangefees": [
{
"min": 100,
"max": 1000,
"fee": 2.1
}
]
}
Properties
The Properties section provides detailed explanations for each field:
- fee_cashin: The percentage fee charged when funds are deposited (cash-in), specific to the country and operator.
- fee_cashout: The fee applied when funds are withdrawn (cash-out).
- fee_merchant: The operational fee for merchant-related transactions.
- country: A two-letter code identifying the country in which the fee rules apply.
- currency: The currency used for transactions in the specified country.
- operator: The name of the mobile money or telecom operator to which the fees apply.
- rangefees: An array that defines dynamic fee ranges based on minimum and maximum transaction amounts, allowing for more granular control over applied fees.
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| fee_cashin | number | true | none | cashin fee per country and per operator |
| fee_cashout | number | true | none | cashout fee per country and per operator |
| fee_merchant | number | true | none | merchant fee per country and per operator |
| country | string | true | none | country code where fee is applied |
| currency | string | true | none | currency code where fee is applied |
| operator | string | true | none | operator where fee is applied |
| rangefees | array | true | none | range fees per country |
This structure enables precise fee configurations tailored to different regional and operational contexts, making it highly adaptable for various African markets.
Was this page helpful?