Skip to main content
Calculate the fee for a single transfer before initiating it. Use this to show your users the exact cost.

Endpoint

POST /api/v1/business/fee/single
Signature required: Yes

Headers

HeaderRequiredDescription
x-api-keyYesYour API key
x-signature-keyYesRequest signature

Request body

FieldTypeRequiredDescription
amountnumberYesThe transfer amount in Naira

Request example

curl -X POST "https://api-dev.usenumero.com/numeroaccount/api/v1/business/fee/single" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key" \
  -H "x-signature-key: generated_signature" \
  -d '{
    "amount": 50000
  }'

Response

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "version": "v1",
  "reference": "abc123",
  "data": {
    "totalAmount": 50000.00,
    "numeroFee": 15.00,
    "stampDuty": 50.00,
    "totalFee": 65.00,
    "totalDeductible": 50065.00
  },
  "error": null
}
FieldTypeDescription
totalAmountnumberThe original transfer amount
numeroFeenumberThe fee you’re charged for this transfer
stampDutynumberNGN stamp duty (₦50 on third-party NGN transfers ≥ ₦10,000) — a government levy, not a Numero fee
totalFeenumberTotal fee (numeroFee + stampDuty)
totalDeductiblenumberTotal amount that will be deducted from your balance