Wilby DocsGet Sandbox Keys

Playbook › Platforms and Marketplaces

Platforms and Marketplaces

You run an app or website where customers order from many sellers or stores: retail, food, groceries, tickets, services.

AI agents can order from your sellers within limits each customer sets, under your name, and every payment decision is signed so disputes are answered with proof. Your checkout, your processor and your logins stay yours.

Not sure where to start? Check your website first: a free score for how ready it is for AI agents.

Every business gets:

1. What Wilby Does for You

Customers are starting to ask AI agents to buy for them. Wilby lets them do it on your marketplace safely: the customer signs in with your account and sets what the agent may spend; your rules apply on top; anything above them goes back to the customer. Every order, ordinary or agent, gets one signed record your support team, the customer and the card company all see the same way.

2. What You Set Up, in Order

  1. Sandbox keys and the sample companies: Get Sandbox Keys, then the Quickstart that fits: fixed price, or variable amounts.
  2. Sellers (stores) and how they're paid: you charge and report each charge, or Wilby charges your processor account (Stripe, Braintree, Square, Adyen, PayPal). Platform Integration: Pick Your Path.
  3. Orders: create an order when the customer checks out, take the payment, finish it, record refunds.
  4. Webhooks so your system hears what happened: Webhooks.
  5. Report what happens to the money (captures, voids, refunds) if you charge yourself: Reporting the Rest of the Order.
  6. AI agents: a sign-in page and a few endpoints answering from your own catalog (search, product, delivery options, quote, order, status, cancel; locations and times only if customers choose them): Agent Storefront. The same answers serve Google's agent checkout (UCP) once you turn it on; to go live on Google, report shipments with tracking, save your Google key for order updates, and get Google's approval in Merchant Center (on Braintree, turn Google Pay on in Braintree first). Goods sold by weight use UCP 2026-08-25. On a marketplace that charges once, a cart from several sellers is one order. Then Dashboard → Agent Readiness, and → Listing before submitting to Claude's and ChatGPT's directories.
  7. Codes for customers without a screen lock: text them from your system (customer.code_requested), or send Wilby the customer's email for it.
  8. Dashboard: an "Open Wilby" button in your admin; choose who may change settings.
  9. Your look: name, logo and colors on every customer page and email.
  10. Customers' way back: link "Manage Your AI Agents" from your app, receipts and texts.

3. Decisions Only You Can Make

4. If Your Final Price Can Change After Checkout

For services, weighed goods, substitutions and anything priced after the work (a repair, a grocery order, laundry by the pound, a rental's extra fees). Turn it on with POST /v1/settings {"variable_amount": true}, then:

5. What Customers and Sellers See

6. Go-Live Checklist

  1. Dashboard → Setup (or GET /v1/integration/check) until every item is Done. It reads your own sandbox activity from the last 30 days and gives the fix for anything missing. Items you don't use (for example extra charges, if your price is fixed) show Not Used.
  2. Test with real staff in the sandbox: an order, a refund, and (if agents can order) one agent order inside the customer's limit and one above it.
  3. Agent ordering: Dashboard → Agent Readiness for every seller, and → Listing before submitting to the directories (directories list your live storefront).
  4. Ask Wilby for live access. Live keys are issued after a short review; sandbox passkeys and settings don't carry over, so set your live settings again.

7. When Something Goes Wrong

8. Links

Quickstart · Platform Integration · Agent Storefront · Webhooks · Signed Records · API Reference


Other paths: Stores on a Platform · Businesses With Their Own Website · AI Agent Makers · Banks and Card Networks · Processors and Payment Companies