Mobile ordering
Sign in with usc auth login. Mobile-order commands reuse USC SSO and keep
the Transact bearer token in memory. They do not save carts or order history.
Browse and choose
usc mobileorder locations
usc mobileorder payments
usc mobileorder menu --location LOCATION_ID --fulfillment pickup --payment-method PAYMENT_ID [--flat]
usc mobileorder orders
usc mobileorder orders --pending
menu returns location status and visible sections with item IDs, names,
prices and availability. Hidden/deleted entries and internal POS metadata
are omitted. Prices are cents; modifiers can change the final price.
usc mobileorder item ITEM_ID --location LOCATION_ID --fulfillment pickup --payment-method PAYMENT_ID
usc mobileorder checkout --location LOCATION_ID --fulfillment pickup --payment-method PAYMENT_ID
item returns a description and modifier choices, including required
minimums, maximums and combo item IDs. Fetch a combo item by its ID to see
its own modifier choices. checkout returns time/date slots, location-specific
tenders, pickup spots and checkout questions. Item availability does not
mean the location is currently open; check the location status too.
--fulfillment accepts pickup, delivery, or address. Payment 0 selects
campus card; 1 and 2 identify saved cards. For campus payment, supply the
selected tender with --tender when browsing and tender_id in the cart.
Delivery/address purchasing needs location-specific details and has not been
verified; pickup is the live-tested flow. The menu’s tender list may differ
by payment context; a quote can return a different effective tender.
Build and quote a cart
No hand-written JSON is needed for ordinary orders:
usc mobileorder cart --location LOCATION_ID --fulfillment pickup \
--payment-method PAYMENT_ID --tender TENDER_ID --asap \
--item ITEM_ID --select ITEM_ID:VALUE_ID > cart.json
usc mobileorder quote --cart cart.json
Omit --tender when it is not applicable. Repeat --item for additional
items or multiple units. Repeat --select ITEM_ID:VALUE_ID for each chosen
modifier value from item ITEM_ID. The library supplies section/option IDs
from the current menu and checks required modifier counts. It never picks
default choices. Repeated copies of the same item share its selections;
use the JSON input below if copies need different customization.
For a combo, select its value on the parent item and specify any child
modifiers with the child item ID shown in item details. Required child
choices are checked too. Use --checkout-choice ID, --pickup-spot ID and
--comment TEXT when required. Choose --asap explicitly, or provide both
--date and --time from checkout slots.
Cart output also pipes directly into usc mobileorder quote --cart -.
The client stores no cart itself; redirecting to a file is optional and makes
it easy to reuse exactly the same selections when placing the order.
Advanced JSON input
Supply a JSON object with your explicit selections via --cart FILE, or
--cart - for stdin. Example shape (IDs below are placeholders):
{
"location_id": 123,
"fulfillment": "pickup",
"payment_method": 0,
"tender_id": 456,
"secondary_tender_id": 0,
"date": "",
"time": "",
"pickup_spot_id": 0,
"comment": "",
"checkout_choices": [],
"items": [{
"itemid": 789,
"sectionid": 101,
"meal_ex_applied": false,
"options": [{
"optionid": 202,
"values": [{"valueid": 303, "combo_itemid": 0, "combo_items": []}]
}]
}]
}
Date and time keys are required. Empty strings explicitly request the app’s immediate/default-time behavior; use returned slot values for a scheduled pickup. Repeat item entries for multiple units. Combo values contain nested items with their own options. Select required modifiers and checkout answers yourself; the client does not choose defaults from the menu.
usc mobileorder quote --cart cart.json
Inspect total, pickup time, payment_method_default, ct_id, ct_id2 and any banner messages in the returned cart. A quote is not a reservation and does not guarantee a currently closed location will accept a purchase.
Place and track
usc mobileorder order place --cart cart.json --expected-total TOTAL_IN_CENTS
usc mobileorder order continue ORDER_ID
usc mobileorder orders --pending
usc mobileorder order check-in ORDER_ID --barcode ORDER_BARCODE
usc mobileorder order cancel ORDER_ID
place requotes immediately, requires an exact total match, and rejects
server changes to payment or pickup selections before sending a single
staged submission. Review a changed quote before editing and resubmitting.
continue advances the staged purchase and may process payment. It is
not a read-only order-status operation. Only stage success confirms
checkout success; intermediate stages need further continuation. A failed
stage is not success. Use orders to read fulfillment status; order output
includes its check-in barcode when supplied by the service.
An unknown submission/continuation outcome is reported as
mobileorder_order_unknown. Inspect pending and past orders before any new
submission; do not blindly retry a purchase. The client performs no automatic
purchase retries. Cancellation and check-in are explicit actions on an
existing order. Configure or add payment cards through the official app;
this client lists existing methods only.
Verification
Live-verified: SSO, account, locations, menus, existing payment methods, past and pending orders, a single-item quote, and rejection of a mismatched expected total before submission. The sample fries quote was 385 cents; prices and availability change.
Not live-verified: successful purchase/continuation, cancellation, check-in, combo purchases, split payments, or scheduled fulfillment. These operations are implemented from the app contract but need a user-selected real order for end-to-end verification. No purchase was made during implementation.
menu --flat returns {"location_id":123,"status":"Closed","items":[{"id":456,"name":"Latte","price":450,"available":true,"section_id":7,"section":"Coffee","section_available":true}]}. It uses the same menu request, retains all visible items in source order, and preserves venue status and section context. Item availability alone does not mean the venue is open; prices remain integer cents.