Overview

System Five now supports automatic payment fees (surcharges) for credit and debit card transactions. This allows businesses to apply a fixed amount or percentage-based fee during customer-present (pinpad) payments.

⚠️ This feature is currently in BETA and must be enabled before use.

Key Features

  • Automatically applies credit card surcharges and debit payment fees
  • Supports:
    • Percentage (%) or fixed amount
    • Optional minimum and maximum limits
  • Displays fee details on POS and pinpad
  • Adds fee directly to the invoice
  • Can also support tips and cash discounts

Requirements

  • System Five version 7.0.0.1553 or newer
  • Datacap Netepay Hosted integration
  • Feature enabled in Setup Registry

Limitations

This feature applies only to customer-present transactions using a pinpad.

Not supported for:

  • Payments on account
  • Recurring payments
  • Card-on-file transactions

Setup Instructions

Step 1: Enable the Feature

  1. Go to Menu/Navigator > Setup Tools > Configuration > Setup Registry
  2. Navigate to: FEATUREFLAG > PAYMENTFEES
  3. Set value to: Y
  4. Save changes

Step 2: Create Payment Fee Item

  1. Create a non-inventory part
    • Recommended name: PAYMENTFEE
  2. Configure:
    • Tax settings (if applicable)
    • GL account for tracking fees

Step 3: Configure Payment Fees

  1. Go to payment processor settings
  2. Set up fee structure:
    • Choose percentage (%) or fixed amount
    • (Optional) Define minimum and maximum limits
  3. Configure separately for:
    • Credit surcharges
    • Debit payment fees

How It Works (POS Workflow)

  1. Start a POS transaction
  2. Select payment via pinpad
  3. Customer taps/inserts/swipes card
  4. System:
    • Detects credit or debit card
    • Applies the configured fee
  5. Fee is:
    • Displayed to the customer
    • Added automatically to the invoice

Additional Notes

  • The system uses a non-inventory item (PAYMENTFEE) to track fees
  • “Surcharge” text on receipts is not configurable
  • Force Card Type can be used if needed for correct fee application
  • Minor rounding differences may occur depending on tax setup

Troubleshooting

Fee not applied

  • Confirm feature flag is enabled
  • Verify Netepay Hosted is in use
  • Ensure transaction is customer-present

Incorrect fee amount

  • Review fee configuration
  • Check card type detection

Compliance Reminder

Businesses are responsible for ensuring that payment surcharges comply with local laws and card brand regulations. Always inform customers of applicable fees before completing the transaction.

Need Help?

  • Contact Support for setup assistance or system upgrades
  • Contact your Account Manager for licensing and Netepay Hosted requirements

If you'd like, I can also generate a short “Quick Setup” version for agents or a customer announcement email aligned with your rollout process.