Skip to main content
GET
/
api
/
v1
/
transfers
/
fiat
/
calculate-fee
Calculate Fiat Transfer Fee
curl --request GET \
  --url https://api-production.fossapay.com/api/v1/transfers/fiat/calculate-fee
{
  "status": true,
  "statusCode": 200,
  "message": "Transfer fee calculated successfully",
  "data": {
    "amount": 50000,
    "currency": "NGN",
    "feeAmount": 500,
    "total": 50500
  }
}

​
Query Parameters

​
amount
number
required
The transfer amount in NGN for which to calculate the fee. Must be a positive number (minimum 0.01).
Fees are always calculated for NGN payouts. You do not pass a currency parameter on this endpoint.

​
Request Example

curl -g 'https://api-production.fossapay.com/api/v1/transfers/fiat/calculate-fee?amount=50000' \
  -H "x-api-key: your_api_key_here"

const params = new URLSearchParams({ amount: '50000' });
const response = await fetch(
  `https://api-production.fossapay.com/api/v1/transfers/fiat/calculate-fee?${params}`,
  {
    method: 'GET',
  }
);

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

const feeData = await response.json();
When using curl in a shell, wrap the full URL in quotes (or use curl -g) so query string characters are not interpreted by the shell.

​
Response

{
  "status": true,
  "statusCode": 200,
  "message": "Transfer fee calculated successfully",
  "data": {
    "amount": 50000,
    "currency": "NGN",
    "feeAmount": 500,
    "total": 50500
  }
}
FieldDescription
data.amountThe amount you passed in the query (NGN)
data.currencyAlways NGN for fiat payout fee quotes
data.feeAmountThe fee charged for the payout
data.totalamount + feeAmount (total debited including fee)