Automatic tip distribution onto the tour compensation object

June 3, 2026

Tips set on individual bookings now flow automatically onto the tour compensation object when a tour completes — so everything a driver earned (base earnings, bonuses, and tips) lives in one place instead of being stitched together after the fact.

Why this matters

Tips are set per booking, but drivers are paid per tour. Until now there was no automatic bridge between the two: tip data sat on bookings while payout reporting happened at the tour level, leaving operations to reconcile the two by hand. With automatic tip distribution, a completed tour’s compensation breakdown carries the tip total directly — visible to drivers in the app, to operators in the dashboard and API, and to your server-to-server integrations through the existing compensation webhook.

Enabling it

Tip distribution is opt-in per tour service and off by default, so nothing changes until you switch it on. Set the tour service’s tip distribution strategy with Update a service and read it back via Show a service. API support is available now; configuring it from the dashboard is coming soon.

The distribution strategy

The first available strategy, completed_dropoffs_on_tour, awards a booking’s tip to the tour where its drop-offs were completed. Bookings whose drop-offs are split across multiple tours, that still have unresolved drop-offs, or whose tip currency differs from the tour’s compensation currency don’t contribute — and a currency mismatch pauses distribution for that tour and notifies your admins by email. The default noop strategy opts out entirely. The Services docs spell out the exact eligibility rules on the strategy field — start there for the specifics.

Where the result shows up

Once a tour completes, the distributed tip appears in the tips component of its compensation breakdown — readable via Get tour compensation and delivered through tour.compensation_updated. This fills the tip slot that the tour compensation object reserved for platform-side population, and builds on booking tip currency validation, which keeps a booking’s tip currency sound before it ever reaches a tour.