Skip to main content

Booking Trip Credits

Issue and manage sponsor-funded booking credits for riders and groups.

Written by Jonathan Osacky
Updated this week

What this screen does

  • Lets fleet owners/admins issue sponsor-funded booking credits.

  • Supports rider-targeted credits and group-targeted credits.

  • Validates rider phone numbers before creating rider profiles.

  • Creates rider profiles (phone-backed accounts) as needed before issuing credits.

  • Shows issued credit grants with status, balance, expiration, and notes.

  • Lets admins update notes/expiration and cancel existing grants.

  • Shows created credit groups and member phone numbers.

How to get here

Web:

  1. Sign in to the fleet dashboard.

  2. Open the left sidebar.

  3. Go to Fleet β†’ Booking Credits.

URL route

  • /app/fleet/bookings/credits

Key actions

  • Issue credit to one rider: Enter rider phone, select allocation type, amount, optional expiration/notes, then create.

  • Issue credit to a group: Switch target to group, add one rider phone per line, optionally name the group, then create.

  • Update an issued credit: Edit notes or expiration on the grant row, then save.

  • Cancel an issued credit: Use the cancel action on a grant row.

Permissions & entitlements

  • Roles: Owners and admins can access and manage booking trip credits.

  • Drivers/non-fleet members: Redirected away from this screen.

  • Plan gating: Wrapped with fleet paywall behavior (FleetPaywallWrapper).

Edge cases & gotchas

  • Invalid rider phone numbers are rejected before rider creation/credit issuance.

  • Group creation requires at least one valid rider phone.

  • Currency allocation requires a 3-letter currency code.

  • Canceling a grant sets it to canceled and zeros remaining balance.

  • Existing canceled grants cannot be canceled again.

Troubleshooting checklist

  • Confirm the user is an owner/admin in the fleet.

  • Check rider phone numbers are in valid international format.

  • Verify fleet ID/sponsor context is correct.

  • Refresh the page after transient API/network failures.

  • Check Sentry for API error codes (booking_trip_credit_*).

What users call this

  • Booking credits

  • Ride credits

  • Rider wallet credits

  • Fleet-sponsored credits

Related screens

  • Fleet bookings list: /app/fleet/bookings

  • New booking flow: /app/fleet/bookings/rider and /app/fleet/bookings/new

last_verified

  • Date: 2026-02-24

  • Verified builds: Web app (meter-repo main + booking credits management UI branch)

Did this answer your question?