Retrieve Allowed SIF Names

Returns all SIF (System Integration Fee) fee names that are configured and available for the ISO associated with the authenticated API user. SIF names are used to label custom line-item fees applied to merchant accounts during boarding. The list is scoped to the caller's ISO — different ISOs may have different sets of available fee names based on their processor agreements.

Endpoint

GET /api/v1/SIFFeeNames

Authentication

Basic HTTP Authentication required.
Encode username:password in Base64 and pass in the Authorization header:

Authorization: Basic {base64(username:password)}

When to use

Call this endpoint before configuring SIF fees on a merchant application to obtain the list of valid fee names your ISO is authorized to use. The returned strings are the exact values that must be passed when setting up SIF fees on a merchant record. This is typically called once per session and the results cached for use in fee-selection dropdowns.

Response

200 OK

The data field contains an array of strings, where each string is a SIF fee name available to the caller's ISO.

{
  "data": [
    "INTERNET GATEWAY",
    "POS INSURANCE",
    "POS SERVICE",
    "POS SUPPORT",
    "ACCOUNT MAINTENANCE",
    "INACTIVITY FEE",
    "MERCHANT CLUB",
    "SERVICE FEE",
    "ONE TIME PLACEMENT",
    "SOFTWARE MONTHLY",
    "MONTHLY POS PLACEMENT",
    "WARRANTY",
    "EMV encryption",
    "Equipment LEASING",
    "Installation Fee",
    "PCI Annual Fee",
    "PCI Monthly",
    "NMI Gateway",
    "Monthly Service",
    "mPOS Access",
    "Equipment placement",
    "Equipment Fee"
  ],
  "status": "OK",
  "error": null,
  "warning": null,
  "validationResults": [],
  "requestId": 91023
}

Error Codes

Common Mistakes

• Attempting to use a SIF fee name that is not in the returned list — only names returned by this endpoint are valid for the caller's ISO.
• Hardcoding SIF fee names in application code — names can vary by ISO and may change over time; always fetch the list dynamically.
• Expecting this endpoint to return fee amounts or configurations — it returns only the names (labels); fee amounts are configured separately on the merchant record.
• This endpoint takes no query parameters; any parameters provided will be ignored.

Related Endpoints

• GET /api/v1/merchant/fees — retrieve the fee schedule configured for a specific merchant
• PUT /api/v1/merchant/fees — update the fee schedule on a merchant application
• GET /api/v1/merchant/boardingSettings — retrieve boarding settings including allowed fee configurations for an agent profile

Example

curl -X GET "https://hq.staging.netevia.dev/api/v1/SIFFeeNames" \
  -H "Authorization: Basic $(echo -n 'username:password' | base64)" \
  -H "Accept: application/json"