Playbook › Businesses With Their Own Website
Businesses With Their Own Website
You sell directly on your own website or app, without a marketplace: an online shop, a restaurant, a florist, a repair company.
The short path: Wilby charges your processor, AI agents can order from you under your name, and every payment has signed proof. One person can set it up.
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
AI agents can find what you sell, get a signed price and order within limits each customer sets. Wilby charges your own processor account, so the money goes straight to you, and keeps the signed record you use in any dispute.
2. What You Set Up, in Order
- Sandbox keys (choose "Wilby charges the card"), then the Quickstart: Fixed Price.
- Connect your processor (Stripe restricted key, Braintree, Square, Adyen or PayPal): Platform Integration.
- Webhooks, so your order page updates as things happen: Webhooks.
- Your storefront for AI agents (Agent Storefront): answer what fits you (a catalog, delivery, locations, times). The Harbor Home Goods sample is an online shop; Little Fern Flowers takes pickup orders.
- Your look: name, logo, colors.
- See and govern AI agents on your own website: a website key and the server snippet or the Cloudflare Worker, then pass the check id with the order (AI Agents on Your Website).
3. Decisions Only You Can Make
- Which AI agents may order, your most per agent order, and your hours for agent orders.
- Whether a visit that is only "likely" an AI agent is recorded only (the default) or the customer confirms it above your amount.
- Statements only the customer can make (for example age, or accepting terms for a booking).
- Whether your final price can change after checkout (section 4).
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.
- The Maple & Pine Home Repair sample shows a final price set after the job.
5. What Customers See
- A page in your look to set what an agent may spend, approvals only above their limits, receipts with the signed record, and "Your AI Agents".
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.
- If AI agents can order: Dashboard → Agent Readiness and → Listing.
- 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 · Agent Storefront · Webhooks · API Reference
Other paths: Platforms and Marketplaces · Stores on a Platform · AI Agent Makers · Banks and Card Networks · Processors and Payment Companies