Fees
The fee generally refers to a stream of revenue generating from your customers. Which means that when the cardholder performs a transaction an associated fee with the card product will be charged.
At nCore platform you can link different fees on the card product based on transaction types (e.g. purchase, withdrawal, and etc.). The transaction will be authorized only if there are sufficient funds available in the account which means it is real time fee evaluation. Real time fee evaluation requires that the account has sufficient funds available to cover both the transaction amount and the fee to authorize the transaction.
What does it mean to have sufficient funds?
There are typically three types of amounts involved in an authorization, which are:
  • Transaction amount (TA) is the amount requested in the authorization
  • Acquirer fee (AF) is the fee that is charged by the acquirer (optional)
  • Issuer fee (IF) issuer fee is the fee that you configure and link to the card product (optional)
In order to authorize the transaction the account should have sufficient funds to cover the three amounts, otherwise the authorization will be declined. That is funds in account ≥ TA + AF + IF.
Following are the fee types offered in nCore.
S No.
Fee Type
Fee Description
1
Flat fee
A fixed amount that the cardholder pays regardless of the transaction amount
2
Percentage fee
A percentage applied on the transaction amount that the cardholder pays
3
Range fee
Transaction amount based fee slabs where each slab has a flat fee or a percentage fee

Create a fee

You can create a fee as required by sending a POST request to /fees endpoint as given below.

Retrieve a fee

nCore offers two retrieval options for fees.
Retrieve all fees
You can retrieve all existing fees by sending a GET request to /fees endpoint as shown below.
GET /fees
Retrieve a specific fee
You can retrieve a specific fee by sending a GET request to /fees/{fee_id} endpoint as shown below.

Update a fee

You can update a specific fee as required. Send a PUT request to /fees/{fee_id} endpoint.
You can link a fee with a card product by sending a POST request to /cardproducts/{id}/fees:link endpoint as given below.
You can unlink a fee from a card product as per your requirement by sending a POST request to /cardproducts/{id}/fees:unlink endpoint. Noted that fee will not charge for a specific card product after unlinking it.

Retrieve linked fees

You can retrieve all fees which are linked with your card product. Send a GET request to /cardproducts/{id}/fees endpoint as shown below.