Skip to main content

Tipping in Softpay

How tipping works in Softpay, including how it's enabled based on MCC codes, customization options for merchants, and how the tipping screen appears during the payment flow.

Softpay supports tipping as part of the payment flow, giving merchants flexibility in how and when the tipping screen is shown to customers.

By default, tipping is disabled if the MCC code does not fall within the hospitality segment. Once enabled, merchants can fully customize the tipping experience to best suit their business needs and customer expectations. MCC is a standard, four‑digit classification used globally across card networks. It is not acquirer specific.

Tipping is enabled automatically for the following MCC codes:

  • 4121 – Taxicabs and Limousines

  • 5812 – Eating Places and Restaurants

  • 5813 – Bars, Cocktail Lounges, Discotheques, Nightclubs, Taverns

Furthermore, a reseller can activate tipping on merchants independent of MCC code by using the onboarding API. To do this, use the merchant endpoint to set the tippingSupported parameter to true for the desired merchant. Save the changes to ensure tipping is enabled.

Tipping user guide

Automatic activation

Tipping is automatically enabled if the merchant’s MCC (Merchant Category Code) qualifies (for example, restaurants, bars, or hotels). After activation, ensure to reload the device configuration to apply the changes.

Configuration in the app

Once tipping is active for your merchant, you can enable and configure it in the app by navigating to:
​Menu → Settings → Enable Tipping → Configure Tipping Variants.

Screenshot 2025-09-16 at 16.34.22.png

Tipping variants

Merchants can choose when the tipping screen appears — either before or after the card is tapped. You can also decide whether the cardholder enters a tip amount directly or updates the total amount including tip.

Screenshot 2025-09-16 at 16.34.06.png

Default percentages

Up to three default tip percentages can be set, giving cardholders convenient quick options when adding a tip.

High tip threshold

A maximum tip amount (blocking threshold) can be configured to prevent unusually high tips.

Screenshot 2025-09-16 at 16.34.12.png

Troubleshooting Common Issues

Tipping Not Appearing:

  1. Ensure that tipping is enabled either via the Onboarding API or through MCC-based activation.

If the tipping option is not visible after updating the merchant:

  1. Open the Softpay app and navigate to Settings → Reload configuration to update the device settings.

  2. Fully close the app and reopen it to refresh the user interface.

Best Practices for resellers for Enabling Tipping During Onboarding

To prevent the tipping option from being missing for new merchants, follow these best practices during the onboarding process:

  1. Use the Onboarding API:

    • Enable tipping as part of the merchant setup using the API.

  2. Onboarding via Excel Files:

    • Include a request in the onboarding email to enable tipping for the merchant.

  3. Default Tipping for Specific MCC Codes:

    • Note that tipping is enabled by default for merchants with MCC codes 4121, 5812, and 5813.

Did this answer your question?