WARNING — enabling charging is live. With “Charge for Ride” set to yes and a payment processor configured (MAM Stripe Manager), riders’ cards are charged real money at booking. In releases before this one a key mismatch meant the switch silently did nothing — sites upgrading with the switch already set to yes will start charging on upgrade. Verify the Charge Type and Charge amount, and test with a sandbox/test card before going live.
The settings
Mobile App Manager → WooCommerce Settings → Ride Share tab:
| Setting | Option id | Values |
|---|---|---|
| Charge for Ride | tsl-setting-charge_ride |
yes / no (default behavior: no) |
| Charge Type | tsl-setting-wc_ride_share_type |
per_mile / flat_rate |
| Charge amount | tsl-wc_ride_share_charge_amount |
A money amount — see below for what it means in each mode |
How the fare is computed
The fare is applied to the ride’s WooCommerce order when it is booked through the app’s checkout path:
-
Flat rate — one unit of the trip product at Charge amount (fallback 20 when the amount is unset).
-
Per mile — the trip’s Mapbox routing distance is converted to miles and billed in tenth-of-a-mile units:
quantity = ceil(miles × 10), each unit priced at Charge amount (fallback 1 when unset).So Charge amount is the price per 0.1 mile. For $2.00/mile, set Charge amount to
0.20. A 4.3-mile trip billsceil(43) × 0.20 = $8.60. -
Charging off — quantity 1 at price 0: the order totals $0 and the ride is tip-only. After the trip the rider is shown “Review and Tip your Driver” (MAM Reviews Manager); the tip is split with the driver per the vendor’s Driver Tip Percentage and the
wc-rs-driver-tipnotification goes to the driver and the vendor managers.
Notes:
- If Mapbox can’t return a route (no token, outage), the distance falls back to 0 — a per-mile fare then bills 0 miles rather than failing the booking. Fix the token, don’t raise the price.
- Rides booked through the Gravity-Forms request form use the vendor’s auto-created Trip product, which is created at price 0. The distance quantity (
ceil(miles × 10)) is still recorded on the line item, so if you set a regular price on a vendor’s Trip product, form-booked rides will billprice × quantityfor that vendor. Leave the Trip products at 0 unless that is what you want. - Manager-assigned rides are never charged: the Assign flow removes the credit-card field and books with quantity 1 / distance 0.
Verifying
- Set the three settings, book a test ride, and open the order in WooCommerce admin: the trip line item should show the expected quantity and total, and the order meta
trip_distance(miles) should match the route. - The rider’s live trip card shows “Cost: $…” when the order totals more than 0, otherwise “Cost: Tip Only”.
Related articles
- Plugin: mam-woocommerce-ride-share
- Recipe: Set up a ride-share service
- Recipe: Mapbox and geocoding setup
Metadata
| Field | Value |
|---|---|
| Article type | Recipe |
| Plugin slug | mam-woocommerce-ride-share |
| Applies to plugin version | 1.3.1+ |
| Category | Building Your App |
| Audience | App builder |
| Last verified | 2026-06-10 |
