Flx Commerce
A WordPress/WooCommerce plugin that exposes a machine-readable commerce API, so external clients — including AI shopping agents — can discover a WooCommerce store and perform real commerce operations through it.
WooCommerce stays the source of truth for every fact this API exposes. Flx Commerce does not replace it, and does not keep its own copy of your catalog, cart, or orders.
What it does today
Every capability below runs against a real WooCommerce store, not a mock. Each one has been exercised end to end, including placing and independently verifying a real WooCommerce order.
- Merchant discovery. Read the store's identity — name, URL, description — live from WordPress.
- Product discovery. Browse the real WooCommerce catalog, including variable products represented as a price range plus individually priced variations — never a fabricated single price.
- Capability discovery. Check which commerce operations this store actually supports before attempting one, rather than assuming.
- Cart. Add, view, update, and remove items in a real WooCommerce cart — no separate cart storage.
- Checkout preview. Initiate real WooCommerce checkout and see totals, without placing an order or moving money.
- Shipping. Set a billing/shipping address and select a real shipping rate on a shippable cart.
- Order creation. Place a real WooCommerce order via Cash on Delivery. This proves an order can be created — it is deliberately not proof of payment processing.
How it works
An AI agent or any other machine client talks to Flx Commerce's REST API. Flx Commerce never stores or duplicates commerce data — every request is delegated directly to WooCommerce's own APIs, in real time.
The verified workflow, in order:
- Discover merchant
- ↓ Discover capabilities
- ↓ Browse products
- ↓ Add / manage cart
- ↓ Checkout preview
- ↓ Shipping / address
- ↓ Create real WooCommerce order
What it does not do
Flx Commerce is honest about its own limits — its own capability endpoint reports payment: false.
- Order creation today is proven only through Cash on Delivery, which moves no money and contacts no payment processor. Real online payment processing is not implemented.
- There is no merchant-facing admin dashboard — the plugin is an API layer, configured entirely through WooCommerce itself.
- The MVP is focused on a single WooCommerce store. It is not a multi-store SaaS platform.
- An initial UCP discovery/catalog adapter is implemented; broader AI-commerce protocol support (ACP, MCP as a shopping surface, etc.) is not.
See it live
woo.flexplat.com is a real WooCommerce store running Flx Commerce — the live Flx Commerce demo. It is not a mockup or a staging environment: it is the exact store the API examples below talk to.
For developers
The API is public and read endpoints need no authentication. Try it against the live demo store right now:
curl https://woo.flexplat.com/wp-json/flx-commerce/v1/capabilities curl https://woo.flexplat.com/wp-json/flx-commerce/v1/merchant curl https://woo.flexplat.com/wp-json/flx-commerce/v1/products
| Method | Route | Purpose |
|---|---|---|
| GET | /wp-json/flx-commerce/v1/merchant | Merchant identity |
| GET | /wp-json/flx-commerce/v1/products | Product catalog |
| GET | /wp-json/flx-commerce/v1/capabilities | What this store supports |
| POST/GET/PUT/DELETE | /wp-json/flx-commerce/v1/cart | Cart mutation and retrieval |
| POST | /wp-json/flx-commerce/v1/cart/address | Set billing/shipping address |
| POST | /wp-json/flx-commerce/v1/cart/shipping-rate | Select a shipping rate |
| POST | /wp-json/flx-commerce/v1/checkout | Checkout preview (no order created) |
| POST | /wp-json/flx-commerce/v1/order | Real order creation (Cash on Delivery) |
| GET | /.well-known/ucp | UCP merchant profile |
Full request/response contracts, error shapes, and the Cart-Token session mechanism are documented alongside the plugin. Source access is available on request.