Reserve a ride and pay for it automatically
reserve_and_payReserve a Quo ride and complete payment immediately, using the guest's already-linked card, only works if get_payment_method shows a linked card whose remaining 24-hour cap covers this fare. The fare is computed server-side from real pricing, never trusted from the caller. If the fare exceeds what is left of the guest's rolling 24-hour cap, or no card is linked, this refuses and suggests reserve_ride instead (a human-confirmed request with no charge). If the ride is created but the charge fails, the ride is NOT lost, it stays reserved and unpaid, and the response explains next steps. Requires session_token from verify_code.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"session_token": "<session_token>",
"pickup": "<pickup>",
"when": "<when>"
},
"name": "reserve_and_pay"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| when | Yes | Pickup date and time, ISO 8601 (e.g. 2026-12-04T14:30:00-05:00) | |
| hours | No | ||
| notes | No | ||
| stops | No | Ordered intermediate stops between pickup and dropoff within this one reservation. Up to 3. Each stop adds a flat surcharge, and the trip is routed through the stops; both are included in the charged amount. | |
| pickup | Yes | Pickup address, airport, or hotel | |
| dropoff | No | Destination, omit for an hourly/as-directed booking | |
| service | No | transfer | |
| vehicle | No | sedan | |
| flightNumber | No | For an airport pickup, Quo tracks the flight and the captain waits if it's delayed | |
| session_token | Yes | ||
| idempotency_key | No | Optional. A unique string for this request (e.g. a UUID). If the call is retried with the same key, the original answer is returned instead of reserving and charging a second ride. | |
| specialRequests | No | ||
| additionalRiders | No | Other named riders on this same booking, for a group/split-fare trip, the verified phone above stays the sole booking owner and the only one charged. Purely for the driver's manifest and, if a phone is given, that rider's own SMS ride updates. |