What Is Tour Compensation?
Tour compensation is a structured view of everything a driver earns for a tour. It consolidates base earnings, bonuses, and tips into one total that is calculated automatically.
Previously, driver pay was stored as a single number on the tour. Tour compensation replaces this with a structured breakdown that lets you distinguish base pay from bonuses and tips, audit each component independently, and build accurate payroll exports.
Tour compensation is available to all tenants via the API, Dashboard, driver app, and webhook.
The Compensation Breakdown
The compensation object has three components:
Base earnings: the base pay for the tour, set via API by your integration
Bonuses: up to five named bonus items per tour, each identified by a unique key (for example,
peak_hoursorcompletion_q1). The key prevents the same incentive from being applied twice on the same tour.Tips: tips collected from bookings dispatched on the tour. Tips are calculated automatically upon tour completion and are read-only.
Tips are set automatically by MotionTools and cannot be written directly via the API. To learn how tip calculation works and how to enable it, read Configure Tip Distribution for Your Tour Service.
The total amount is calculated automatically from all three components and updates whenever a component changes.
Where to See Compensation
Dashboard
Go to Tours and open a completed tour. The Compensation tab on the Tour Details page shows the full breakdown: base earnings, each bonus, tips, and the total.
Driver App
Drivers see their compensation breakdown on the Past Tours screen. Two configurable labels show compensation values to drivers during and after a tour:
Compensation: displays the sum of base earnings and all bonuses
Tips: displays the tip amount separately
Both labels are disabled by default. Read the Customize Tour and Stop labels in the Driver App article to learn how to enable them.
Tips are only visible after a tour is completed. The Tips label and the compensation breakdown appear on the Past Tours screen once the tour has been processed.
How to use the Compensation API as a developer
The compensation object is available via a dedicated API endpoint on every tour. Continue with the How to use the Compensation API article to learn more.