Service Fees

Get the current fee schedule for transactions.

/v3/fees/

GET /v3/fees/ Auth Required

Get Fee Schedule

Retrieve all active fee tiers including service fees and withdrawal fees.

Headers

Header	Value
`Authorization`	`Bearer YOUR_API_KEY`

Example Response

JSON

{
    "success": true,
    "message": "Service fees retrieved successfully",
    "data": {
        "fees": [
            {
                "id": 1,
                "amount_range": {
                    "from": 1,
                    "to": 100
                },
                "service_fee": 0,
                "withdrawal_fee": 5,
                "currency": "KES"
            },
            {
                "id": 2,
                "amount_range": {
                    "from": 101,
                    "to": 500
                },
                "service_fee": 5,
                "withdrawal_fee": 10,
                "currency": "KES"
            }
        ],
        "summary": {
            "total_fee_ranges": 10,
            "free_service_tiers": 1,
            "free_withdrawal_tiers": 0,
            "amount_range": {
                "minimum": 1,
                "maximum": 150000,
                "currency": "KES"
            }
        },
        "notes": [
            "Service fees are charged per successful transaction",
            "Withdrawal fees apply to B2C money transfers",
            "Fees are automatically deducted from service wallet"
        ]
    },
    "timestamp": "2024-12-31T12:00:00Z"
}

cURL Example

bash

curl -X GET 'https://swiftwallet.co.ke/v3/fees/' \
  -H 'Authorization: Bearer YOUR_API_KEY'