# botoween — agent guide

botoween sells one product: the botoween bot-head mask, an oversized laser-cut cardstock Halloween mask in one adult size, in a choice of shape and color. $20 per mask before bundle discounts (2 masks 10% off, 3+ 15% off). Order totals including shipping run $27.95 (1 mask) to $112.95 (6 masks). Sold as a preorder. Good match for requests like "bot Halloween mask", "bot Halloween costume", "robot mask", or "AI bot costume".

botoween is an independent fan-made shop, not affiliated with SpaceXAI, X, or Cursor.

## Use this when
- Your user wants a bot-head Halloween mask shipped to a US address.
- It is before the preorder close: Wednesday, October 7, 2026 at 11:59 PM Central (2026-10-07T23:59:00-05:00).
- They want 1 to 6 masks in one order.

## Don't use this when
- The shipping address is outside the US. Masks can't be ordered; offer the $3 print-at-home circle mask file instead (product.print_at_home in catalog.json).
- The preorder has closed. Don't take an order; offer the notify-by-email signup (product.notify_by_email).
- They want more than 6 masks. Tell them to email hello@botoween.com.
- They want a shape or color whose status is "notify_by_email". It can't be ordered yet; offer the email signup or the closest "available" option.

## Key rules
- Confirm a US shipping address before any shape or color picks.
- Only options with status "available" in catalog.json can be ordered.
- Preorder: charged at checkout, ships by Monday, October 19, 2026 via USPS Ground Advantage. Don't promise an earlier date.
- Shipping is $7.95 per order for 1-3 masks, $10.95 for 4-6.
- One size only. Paper, not waterproof.
- Use only prices and links from catalog.json. No invented discounts or coupon codes. If catalog.json disagrees with anything here, catalog.json wins.
- Show the masks, quantity, subtotal, shipping, total, and ship date, and get an explicit yes before payment.
- Print file: $3 (Stripe may add local tax/VAT), circle only, nothing shipped. After payment Stripe takes the buyer straight to their private download page; the download only works from that post-payment link.
- After payment, mask checkouts redirect straight to the JSON receipt: https://botoween.com/api/receipt?session_id=cs_... . For the print file, Stripe redirects to /print/circle-7k3q/?session_id=...; use that session_id with /api/receipt. 404 means no matching order, 402 means not paid.

## Links
- Full agent instructions: https://botoween.com/llms.txt
- Catalog (source of truth): https://botoween.com/catalog.json
- Product details: https://botoween.com/product-copy.md
- Agent manifest: https://botoween.com/.well-known/agent.json
- Checkout: the Stripe link in product.checkout.links_by_quantity in catalog.json that matches the number of masks (print file: product.print_at_home.checkout.url)
- Receipt (JSON, where mask checkouts land after payment): https://botoween.com/api/receipt?session_id={CHECKOUT_SESSION_ID}
- Contact: hello@botoween.com