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.
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.
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.
Troubleshooting Common Issues
Tipping Not Appearing:
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:
Open the Softpay app and navigate to Settings → Reload configuration to update the device settings.
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:
Use the Onboarding API:
Enable tipping as part of the merchant setup using the API.
Onboarding via Excel Files:
Include a request in the onboarding email to enable tipping for the merchant.
Default Tipping for Specific MCC Codes:
Note that tipping is enabled by default for merchants with MCC codes 4121, 5812, and 5813.