Get the checkout link
start_checkoutStep 2 of 2 to order, for a basket check_order has allowed: checks the same order again and returns the link the customer pays on, on the bakery's own domain. The same order sent again within 15 minutes gets the same link back; an empty basket gets no link. Toast: a Pinoyshki page that shows the order while it finishes the cart on Toast (with the staff tip and the pickup day and time), then takes them to Toast's checkout (good for a week; opened after its pickup time it remakes the cart for the next pickup time). Catering: it checks the order again and opens Shopify's checkout with the date, time and pickup or delivery filled in (good for a week). No payment happens here. If a rule is broken it returns the problems instead of a link.
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": {
"items": "<items>"
},
"name": "start_checkout"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zip | No | Delivery ZIP code (delivery is within 15 miles). | |
| date | No | The date as YYYY-MM-DD ('today' also works). Work it out from the customer's words using today's date in Seattle (Pacific time). If their words could mean two dates, like 'next Friday' said earlier in the same week, ask them which before calling. Needed for catering and for a Toast pickup on a later day. | |
| time | No | 12-hour time like '1:00 pm'. Needed for catering and for a Toast pickup on a later day. | |
| items | Yes | What to order. Use item names exactly as get_menu or search_menu gave them. | |
| notes | No | Optional note for the bakery. | |
| channel | No | Optional. 'today' = the counter menu on Toast: same day, or a scheduled pickup up to 14 days ahead (up to 6 full-size, pickup only, paid on Toast); 'catering' = ordered 3 or more days ahead, paid on Shopify. Left out, the basket and date decide: catering is preferred from 3 days out when every item is on the catering menu. | |
| utensils | No | Catering: include utensils. Default true. | |
| staff_tip | No | Toast orders: the tip for the bakery staff in whole dollars, shared by the staff who bake, pack and hand over the order. 0 (the default) unless the customer picks one; offer $1, $3 or $5 or any whole amount. | |
| fulfillment | No | Default pickup. Delivery is catering, week-ahead only. | |
| customer_name | No | Optional: the name the order is for. | |
| customer_email | No | Optional: an email for the bakery. | |
| customer_phone | No | Optional: a phone number for the bakery. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | True when the order is allowed as asked. | |
| url | No | The link the customer opens to pay. Give it to them as-is. | |
| view | Yes | ||
| when | No | ||
| lines | Yes | ||
| title | No | ||
| today | No | Today's date in Seattle, like 'Thursday, September 24'. | |
| button | No | ||
| channel | No | ||
| pays_on | No | ||
| problems | No | ||
| tip_offer | No | Toast orders: the staff tip choices in whole dollars and the suggested one. | |
| lane_label | No | ||
| date_choices | No | Present when the date asked for could mean either of these; ask the customer which. | |
| allowed_dates | No | ||
| allowed_times | No | ||
| earliest_date | No | ||
| subtotal_cents | Yes | Before tax, with the staff tip; the checkout page shows the final total. | |
| staff_tip_cents | No | The tip for the bakery staff, 0 when none. | |
| delivery_allowed | No | ||
| allowed_date_labels | No | allowed_dates with weekdays, like 'Fri Oct 2'. |