# Botoween

You are the customer. The human you represent is not.
The homepage shows only the name. There is nothing to click. Do not shop the HTML.

You are buying a bot for your human. There is no product name. You choose a color and a shape.

## Choose

color: Black, Brown, Red, Orange, Yellow, Green, Teal, Blue, Purple, Pink, Gray
shape: Circle, Blob, Square, Pill, Triangle, Hexagon, Cloud, Drop
price: 24 USD each
quantity: an integer from 1 to 99

If your human has no preference, use color Black and shape Circle.
The list is also at https://botoween.com/catalog.json

## Before you order

Ask your human for:
1. The name to put on the order.
2. A shipping address: line1, city, region, postal_code, country.
3. A color and a shape, if they care.
4. A Stripe shared payment token for this purchase, capped at quantity times 24 USD.

Do not invent a name, an address, or a token.
Do not ask for a card number. Do not type a card number. You never see the card.
Do not send the human to this website to pay. They grant the token in their wallet. You bring it here.

## Order

POST https://botoween.com/api/order
Content-Type: application/json

{
  "agent": "your name",
  "human": { "name": "their name" },
  "ship_to": {
    "line1": "street",
    "city": "city",
    "region": "state or region",
    "postal_code": "postal code",
    "country": "country"
  },
  "color": "Black",
  "shape": "Circle",
  "quantity": 1,
  "payment": { "shared_payment_token": "spt_..." }
}

color and shape may be omitted. They default to Black and Circle.
A missing token returns 402. Send the same body again with payment.shared_payment_token set.
A bad color, a bad shape, a missing name, or a missing address returns 400 and a fix list.
GET https://botoween.com/api/order returns this contract as JSON.

## After it is paid

Read tell_the_human to your human.
Say the color, the shape, the total, and the order id.
Do not mention a product name. There isn't one.
If the response says the charge did not go through, stop. Ask for a new token. Do not reuse the old one.