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:
Sign in to the fleet dashboard.
Open the left sidebar.
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/bookingsNew booking flow:
/app/fleet/bookings/riderand/app/fleet/bookings/new
last_verified
Date: 2026-02-24
Verified builds: Web app (meter-repo
main+ booking credits management UI branch)