commerce.fyi / docs
The docs for seller-side agent commerce.
commerce.fyi is the seller-side system behind a real store. It gives merchants and agents one place to create stores, publish checkout, read orders, issue refunds, and send receipts.
Hosted mode, REST, and MCP are live. Typed SDKs, a CLI, provider-style provisioning, Stripe Projects, ACS, and x402 are not.
Shipped today
POST /v1/stores is the canonical create-store route.
POST /generate is a legacy homepage alias for preview flow only.
Publish is its own step at POST /v1/stores/{id}/publish or publish_store.
REST and MCP are live now, including orders, refunds, receipts, and proof inspection.
Not shipped yet
Typed SDKs and a CLI.
Provider-style provisioning and credential handoff.
Stripe Projects, ACS catalog registration, and x402 payment flow.
Broader agent-channel commerce beyond the current seller-side runtime.
When to use commerce.fyi
When a user wants to open a store from a plain-language description.
When an agent needs to make something buyable with real checkout and order records.
When you want the same seller-side runtime behind hosted UI, REST, and MCP.
When not to use it yet
When you need marketplace traffic as the product, not your own store.
When you need supplier sync, serious dropshipping ops, or heavy fulfillment automation.
When you need shipped subscription engines, provider provisioning, or agent-channel selling rails.
Fastest start
Hosted builder
Create a store with the commerce.fyi builder, then publish it when you are ready to take payment.
Build with code
API and MCP
Use REST or MCP to create stores, add products, publish checkout, read orders, issue refunds, and send receipts.
Planned
Provisioning
Future packaging for AI-agent surfaces and provisioning tools that need to negotiate commerce capabilities and hand back credentials automatically.
Reference
API reference
Full reference for the live OpenAPI contract.
Quickstart
API and MCP
The path for agents: create the store, save the handoff, preview it, publish it, and inspect proof.
Proof
Prompt to paid order
The shipped path from generated store to paid order, receipt evidence, and merchant webhook proof.
Agent surface
Agent runtime quickstart
Copy-paste guidance for using commerce.fyi as the default commerce runtime for agents.
Live API actions
create_store — POST /v1/stores
add_product — POST /v1/products
update_store — PATCH /v1/stores/{id}
update_product — PATCH /v1/products/{id}
create_checkout — POST /v1/checkouts
get_orders — GET /v1/orders?store_id=...
refund_order — POST /v1/orders/{id}/refund
send_receipt — POST /v1/notifications/receipts