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.
- AI agents can order from you within limits each customer sets, and your own rules on top: which agents may order, the most per order, your hours, and "the customer approves anything over $X".
- A signed record of every payment decision: what the customer allowed, the price they were quoted, who approved what, and every payment and refund.
- Agent on every payment: when an AI agent pays, each payment records which agent it was, how that was checked, the permission it used and what it paid with.
- Dispute evidence built from that record, and a Dispute Evidence Package when an agent gets an order wrong.
- Things only the customer can confirm (for example "I'm 21 or older"), and repeating orders that always go to the customer.
- Signed prices, the Agent Readiness Check, and Dashboard with a Setup checklist.
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
- Sandbox keys and the sample companies: Get Sandbox Keys, then the Quickstart that fits: fixed price, or variable amounts.
- 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.
- Orders: create an order when the customer checks out, take the payment, finish it, record refunds.
- Webhooks so your system hears what happened: Webhooks.
- Report what happens to the money (captures, voids, refunds) if you charge yourself: Reporting the Rest of the Order.
- 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.
- Codes for customers without a screen lock: text them from your system (
customer.code_requested), or send Wilby the customer's email for it. - Dashboard: an "Open Wilby" button in your admin; choose who may change settings.
- Your look: name, logo and colors on every customer page and email.
- Customers' way back: link "Manage Your AI Agents" from your app, receipts and texts.
3. Decisions Only You Can Make
- Who charges the card: you or Wilby.
- Which AI agents may order (Agent Access Policy), and your rules for agent orders: the most per order, hours, "the customer approves anything over $X", per seller.
- Which sellers take agent orders; statements only the customer can make (for example "I'm 21 or older" on age-restricted items).
- Whether your final price can change after checkout (section 4), and if so the limit choices you offer customers.
- Who on your team may change Wilby settings.
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:
- At checkout the customer chooses how much more may be charged without asking (for example 20%). Show the choice yourself or use the ready-made screens (web, Flutter, React Native).
- When the price goes up, ask Wilby first with the reason and evidence (a receipt, a photo). Inside the customer's limit it goes through; above it the customer approves with their phone's lock or a code, in your app or on a page in your look.
- Later answers arrive by webhook (approved, declined, no answer). An unanswered request expires on time and nothing is charged.
- Follow the Quickstart: Variable Amount After Checkout.
5. What Customers and Sellers See
- Customers: a page in your look to set what an agent may spend; approval requests only above their limits; receipts with a link to the signed record; "Your AI Agents" to see and turn off any agent.
- Sellers: agent orders arrive like any order; their own view in Dashboard, and their Readiness score.
6. Go-Live Checklist
- 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. - 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.
- Agent ordering: Dashboard → Agent Readiness for every seller, and → Listing before submitting to the directories (directories list your live storefront).
- 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
- A chargeback: the signed record goes into the evidence for you: what the customer allowed, the signed price, who approved what.
- An agent got it wrong: the customer taps "Report an Agent Mistake"; you get
agent_order.reported_wrongand a Dispute Evidence Package showing the order was authorized but wrong (not fraud). You can pause that agent. - A lost or new phone: the customer sets up their phone's lock again with a one-time code.
- An incremental charge wasn't answered (if your price can change): it expires on time and you're told (
incremental_charge.expired); nothing is charged. - The card was declined after the customer approved an incremental charge: report the failed charge; the approval stays valid for another card or a payment link.
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