Driver Tip Percentage Feature¶

Feature Launch Date: October 2025 For: Business Owners & Administrators

Overview¶

The driver tip feature has been upgraded from fixed dollar amounts to configurable percentages. This gives you complete control over the tip options your customers see, and ensures tips scale appropriately with order totals.

What Changed¶

Before¶

Customers saw fixed buttons: $1 | $2 | $5
Tips were the same regardless of order size
No way to customize the tip amounts

After¶

Customers see percentage buttons: 15% | 20% | 25% (configurable)
Tips calculate automatically based on order total
You control what percentages to offer
Customers can still enter custom dollar amounts via "Other"

How to Configure Tip Percentages¶

Access the Driver Tips Admin Panel
Navigate to: /kiv/driver-tips.php
Look for the "Tip Percentage Defaults" section at the top
Set Your Preferred Percentages
Enter three percentage values (e.g., 10%, 15%, 20%)
Valid range: 1% to 100%
Click "Save Percentages"
Changes Take Effect Immediately
All customers will see your new percentages on their next page load
No system restart or additional steps needed

Customer Experience¶

How Customers See Tips¶

When customers are managing their order, they'll see: - No Tip button - Three percentage buttons (using your configured values) - Other button (for custom dollar amounts)

How Tips Calculate¶

Example: Customer's order total is $100 - 15% tip = $15.00 - 20% tip = $20.00 - 25% tip = $25.00

The system automatically calculates the dollar amount based on the order's actual total.

Tip Frequency Options¶

For each tip option, customers can choose: - One-time tip: Applied only to their current order - Recurring tip: Automatically applied to all future orders in their subscription

Special Behaviors¶

Custom Percentage Display¶

If a customer has previously selected a percentage that doesn't match your current defaults, they'll temporarily see an extra button with their custom percentage.

Example: - Your defaults: 10%, 15%, 20% - Customer has: 25% selected - They see: No Tip | 10% | 15% | 20% | 25% | Other

Once they select a new option, the custom button disappears.

Legacy Dollar Amount Tips¶

Customers who had dollar amount tips from the old system will see their "Other" button highlighted, indicating a custom dollar amount. The system maintains full backward compatibility.

Technical Details¶

Database Storage¶

The system stores two pieces of information: - Tip Percentage: The percentage value (0-100) - Tip Dollar Amount: The calculated dollar amount

Both values are saved for: - Individual orders (cust_order table) - Subscription defaults (subscriptions table)

Backward Compatibility¶

All existing dollar amount tips continue working exactly as before. Reports and driver tip tracking remain unchanged.

Best Practices¶

Choosing Percentages¶

Consider Your Order Sizes - Small orders ($20-50): Consider 10%, 15%, 20% - Medium orders ($50-100): Consider 15%, 20%, 25% - Large orders ($100+): Consider 10%, 15%, 18%

Industry Standards - Most food delivery services use: 10%, 15%, 20% - Restaurant standard is typically: 15%, 18%, 20% - Premium services often use: 18%, 20%, 25%

Test Different Options - Monitor driver tip totals after changing percentages - Ask for driver feedback on tip amounts - Adjust based on what works for your business

Communication to Customers¶

When you change tip percentages, consider: - Sending an email notification explaining the change - Emphasizing that tips help support your drivers - Reminding customers they can still enter custom amounts

Troubleshooting¶

"Percentages must be between 1 and 100"¶

Make sure you enter whole numbers without the % symbol
Example: Enter 15 not 15%

Customer reports tip amount seems wrong¶

Verify the tip is calculating from the correct order total
Check if they have a custom dollar amount from before (shows as "Other" selected)
Remind them that percentage tips calculate based on their current order total

Want to revert to dollar amounts?¶

The system doesn't support reverting to fixed dollar amounts
However, you can set low percentages and communicate dollar equivalents
Example: For $100 orders, use 1%, 2%, 5% = $1, $2, $5

FAQ¶

Q: Can I change percentages as often as I want? A: Yes, you can update them anytime. Changes are immediate.

Q: Will changing percentages affect existing customer selections? A: No. Customers who have already selected a tip will keep their selection until they change it.

Q: Can customers still leave a custom dollar amount? A: Yes, the "Other" button allows them to enter any dollar amount.

Q: Do percentage tips work with subscription orders? A: Yes, the tip percentage saves to their subscription and calculates on each recurring order based on that order's total.

Q: What if a customer's order total changes after they set a percentage tip? A: The tip recalculates automatically based on the final order total at checkout.

Q: Can I set percentages higher than 25%? A: Yes, you can set any value from 1% to 100%, though very high percentages may surprise customers.

Q: Do tips go entirely to drivers? A: The driver tip feature tracks tips for drivers. How tips are distributed to drivers is controlled by your business processes and the driver tip tracking system at /kiv/driver-tips.php.

Support¶

If you need assistance with this feature: - Review this documentation - Check the admin panel at /kiv/driver-tips.php - Contact your system administrator

Last Updated: October 31, 2025