Queek

Search Products

PRIMARY way to shop on Queek — start here whenever the buyer names something they want. Searches products across ALL Queek merchants at the exact price the buyer pays. Every result carries `commerce_mode` + `mode_label`: - `shop` ("Ships nationally") — no location needed; go straight to create_checkout. - `quick` ("Local delivery": food, groceries, pharmacy) — needs the buyer's area. Results come back grouped (`groups`: shop vs quick) and also as a flat `products` list; present them under thei

Resolve Address

Turn the buyer's typed area into confirmable address options for LOCAL (quick-commerce) orders. Use it when the buyer wants food / groceries / pharmacy and you need their area: ask them to type their area, call resolve_address, show the returned `addresses` labels, let the buyer CONFIRM one, then pass that exact label as `location` to search_products (or as `address` to create_checkout). This stops a vague 'Lekki' from searching the wrong place. Not needed for nationally-shipped retail (shop).

Find Merchants

Find Queek MERCHANTS by store name or category. Use this only when the buyer names a specific store or wants to browse a merchant — for "I want <product>", use search_products. Each result carries `commerce_mode` + `mode_label` ('shop' = "Ships nationally", 'quick' = "Local delivery"). A keyword (store name / category) resolves across both modes even with no location; a bare browse with no keyword and no area returns nationally-shipped retail only. Provide the buyer's area to rank local merchan

List Products

List a merchant's products at the Queek price the buyer will be charged.

Get Item

Look up one product, including its selectable options. If the result's `requires_selection` is true, the buyer must choose before checkout: - for each REQUIRED group in `option_groups`, pass the chosen item id(s) in create_checkout as `options: [{id}]` (respect the group's min/max; `multiple` allows several); - if `variant_choices` is non-empty, pass the chosen `variant_id`. If you skip a required group, the server auto-picks the cheapest valid option so checkout still works — but prefer to as

Get Fulfillment Quote

Preview pickup/service fees for a merchant (Quote == eventual charge). OPTIONAL — you can skip it: create_checkout always returns the final `quote` (subtotal, fees, delivery, total). For a DELIVERY fee, call create_checkout with the buyer's `address` — it geocodes the address and returns the exact delivery fee in its quote.

Create Checkout

Create a user-confirmed checkout link. Returns {checkout_url} the buyer taps to log in, confirm and pay, plus the final `quote`. NO order or charge happens here. For `delivery_mode="delivery"` you MUST pass the buyer's `address` in plain words — the server geocodes it and the returned quote includes the exact delivery fee. For pickup, omit address.

Get Order Status

Check whether the buyer has completed and paid for a checkout (order or utility).

Get Utility Providers

List utility billers — electricity DISCOs, TV providers, internet/data, betting.

Get Utility Plans

List the buyable plans/denominations for a biller (airtime amounts, data bundles, TV bouquets).

Validate Utility Account

Verify a meter/smartcard and return the account holder's name. Do this BEFORE create_utility_checkout for electricity/TV so the buyer confirms the right account.

Create Utility Checkout

Create a user-confirmed utility checkout link. Returns {checkout_url} the buyer taps to confirm and pay FROM THEIR QUEEK WALLET (with their PIN). NO purchase happens here.