Update Fee Setting

PUT/fee-settingsOpen in the API playground →

Create or update a fee setting. Uses upsert - creates if not exists, updates if exists.

Endpoint

PUT /api/v1/fee-settings

Authentication

Authorizationstringheaderrequired

Bearer token (Admin JWT)

Request Body

transaction_typestringbodyrequired

Transaction type

party_typestringbodyrequired

Party type: sender, recipient, agent, processor

fee_typestringbodyrequired

Fee calculation: percentage or flat

fee_valuenumberbodyrequired

Fee value (percentage 0-100 or flat amount in SLE)

debit_enabledbooleanbody

Apply fee on debit transactions

credit_enabledbooleanbody

Apply fee on credit transactions

Example

cURL

curl -X PUT "https://demo.api.vultlocal.com/api/v1/fee-settings" \
  -H "Authorization: Bearer ADMIN_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_type": "transfer_p2p",
    "party_type": "sender",
    "fee_type": "percentage",
    "fee_value": 1.5,
    "debit_enabled": true
  }'

Response

{
  "success": true,
  "message": "Fee settings updated successfully",
  "id": 1,
  "transaction_type": "transfer_p2p",
  "party_type": "sender",
  "updated_by": "admin"
}

Validation

• Percentage fee cannot exceed 100%
• Fee value must be >= 0

Errors

Code	Description
400	Invalid request or percentage exceeds 100%
401	Unauthorized
500	Internal server error