Sayso Shops API
Sell to AI agents, with the owner's say-so
Sayso makes small shops buyable by AI shopping agents through PayPal. This API is for agent platforms that call REST: find shops, search what they sell, build a cart with PayPal's Agentic Commerce merchant-cart API, send the buyer to PayPal to approve, and complete the checkout.
Money only moves with a say-so. The buyer approves the payment in PayPal, and each shop's Guard re-checks stock and the owner's rules before anything is captured. If an order can't go through, the PayPal hold is released and the buyer is not charged.
The flow
- Find shops with
GET /api/shopsand search one withGET /api/shops/{slug}/products. - Price a cart with
POST /api/shops/{slug}/merchant-cart. Shipping, tax and stock come from the shop. Problems come back asvalidation_issues, each withresolution_optionsyour agent can apply beforePUTting the cart again. - Get the buyer's OK: send them to
payment_method.approval_url, a PayPal page. - Complete with
POST /api/shops/{slug}/merchant-cart/{cartId}/checkout. A big order may wait for the shop owner, thenpayment_statusisAUTHORIZED_PENDING_MERCHANT_REVIEW. Calling it again never charges twice.
Start with the TypeScript guide, or pick your language under SDKs.
Prefer MCP?
Assistants that speak MCP (ChatGPT, Claude or any MCP client) can connect to
https://sayso-ovph.onrender.com/api/shopping/mcp instead, with no key: the same operations as tools, plus
saved PayPal with the buyer's own spending limits.