Flx Commerce

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.

AI agent / machine client
Flx Commerce API
WooCommerce

The verified workflow, in order:

  1. Discover merchant
  2. Discover capabilities
  3. Browse products
  4. Add / manage cart
  5. Checkout preview
  6. Shipping / address
  7. 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
MethodRoutePurpose
GET/wp-json/flx-commerce/v1/merchantMerchant identity
GET/wp-json/flx-commerce/v1/productsProduct catalog
GET/wp-json/flx-commerce/v1/capabilitiesWhat this store supports
POST/GET/PUT/DELETE/wp-json/flx-commerce/v1/cartCart mutation and retrieval
POST/wp-json/flx-commerce/v1/cart/addressSet billing/shipping address
POST/wp-json/flx-commerce/v1/cart/shipping-rateSelect a shipping rate
POST/wp-json/flx-commerce/v1/checkoutCheckout preview (no order created)
POST/wp-json/flx-commerce/v1/orderReal order creation (Cash on Delivery)
GET/.well-known/ucpUCP 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.