Clickbus

Generate a checkout payment URL for the reserved seat. Do NOT ask the user for personal data — the ClickBus checkout page collects name, email, CPF, and birth date itself. You MUST call this immediately after block_seat. PREVIOUS: block_seat (to get seatBlockId and seatPrice). Params: tripId (a tripUuid), seatBlockId ("id" from block_seat), seatPrice ("price" from block_seat). Returns a checkout URL — present it to the user. NEVER fabricate a URL yourself.

generate_checkout_link

MANDATORY FIRST STEP. Resolve city names to terminal slugs. You MUST call this before search_trips. City names are ambiguous (e.g. "Itu" can match "Itueta, MG" or "Itu, SP"). This tool returns the correct slug. Call it for BOTH origin and destination cities. NEXT: search_trips (pass the slugs as origin/destination).

list_terminals

Release a previously blocked seat. Use this when the user changes their mind, wants to pick a different seat, or the checkout was aborted. Safe to call on already-expired blocks (idempotent).

unblock_seat

Temporarily reserve a seat (~20 min hold). REQUIRED before generating a checkout link. Save the returned "id" (seatBlockId) and "price" (seatPrice) — you need them for generate_checkout_link. PREVIOUS: get_seat_map (to see available seats). NEXT: IMMEDIATELY call generate_checkout_link. Do NOT ask the user for personal data (name, email, CPF) — the checkout page collects that itself.

block_seat

Search for available bus trips. Origin and destination MUST be slugs from list_terminals — do NOT pass raw city names (they cause wrong matches). PREVIOUS: list_terminals (REQUIRED — call for both origin and destination first). NEXT: get_seat_map (MUST call using a tripUuid to show the seat map). Do NOT skip get_seat_map. Do NOT send the user to any URL.

search_trips

Get the seat map, bus info, and travel company details for a specific trip. You MUST call this after the user picks a trip from search_trips. Returns every seat with label, availability, and position. Show the available seats to the user and let them choose. PREVIOUS: search_trips (to get tripUuids). NEXT: block_seat (reserve the seat the user chose).

get_seat_map