Surcharges, taxes & fees
Charges that quote cleanly and explain themselves
Taxes and fees are part of the fare engine, not afterthoughts. The admin app supports method, percentage basis, value, taxable behavior, geofence triggers, enabled state, and whether the charge appears at the end.
Charge workflow
Define the charge, then decide exactly when it applies
A tax or fee can be fixed or percentage based, applied on a selected percentage basis, made taxable or not taxable, tied to a geofence, and optionally shown as a charge at the end of the quote.
Name the charge
Create a reusable record with required name, method, percentage basis, and value.
Choose tax behavior
Set taxable state and decide whether the charge appears at the end.
Target geography
Use geofence trigger type and fence selection for location-specific fees.
Control availability
List and detail screens expose enabled, taxable, and geofenced toggles.
Admin surfaces
Fee setup gives billing and dispatch the same source of truth
The admin docs map list, create, and detail flows for taxes and fees. List rows expose name, type, value, enabled, taxable, geofenced, and order. Create and detail forms add percentage basis, geofence type, fence, and final-charge visibility.
Named charge records
Keep airport fees, tolls, taxes, and surcharges as controlled records.
Fixed or percentage methods
Choose the method and value that matches the billing rule.
Percentage basis
Decide what subtotal a percentage fee should apply to.
Taxable toggle
Control whether a fee participates in tax calculations.
Geofence fees
Apply charges only when pickup or drop-off geography matches the fence.
Final charge visibility
Choose whether a charge is shown at the end for clearer checkout review.
Controls that matter