About this plugin
Flx Commerce prepares an existing WooCommerce store to participate in
AI-driven (“agentic”) commerce by exposing reliable, machine-readable
information about the merchant, its product catalog, and what the store
can actually do — and by letting an external client drive a real
WooCommerce cart, checkout, and order through the store’s own existing
setup.
WooCommerce remains the source of truth for every commerce fact this
plugin exposes. Flx Commerce stores no products, carts, checkouts,
orders, or customer data of its own; it reads from and acts through
WooCommerce’s own APIs (including its Store API) at the time each request
is made.
What it does today
- Merchant discovery — a public, read-only REST endpoint describing
the store (name, URL, description), read live from WordPress’s own
Site Title/Address/Tagline settings.
- Product discovery — a public, read-only REST endpoint listing the
store’s catalog, including simple, external, and variable products with
their variations represented correctly (a variable product is never
given a single fabricated price). Supports pagination.
- Commerce capability discovery — a public REST endpoint reporting,
truthfully, which of the capabilities below are actually implemented,
so a client can check before attempting an operation instead of
assuming.
- Real WooCommerce cart mutation — add, view, update, and remove cart
items via WooCommerce’s own Store API; no separate Flx cart exists.
- Shipping support — set a billing/shipping address and select a
shipping rate on the cart, again entirely through WooCommerce’s own
Store API and shipping configuration.
- Real WooCommerce checkout handoff — initiate WooCommerce checkout
for a cart and receive a live preview (payment methods, totals,
shipping) without placing an order or attempting payment.
- Real WooCommerce order creation, Cash on Delivery only — place an
actual WC_Order for a cart. Payment is restricted to Cash on Delivery
( cod ) for this release; no online payment processing of any kind is
implemented.
- UCP discovery/catalog adapter — exposes the same product catalog
through the Universal Commerce Protocol ‘s
well-known/ucp and a
search REST endpoint. UCP checkout, payment, order creation,
lookup are not implemented.
What it deliberately does not do (yet)
- No online payment gateway integration. Cash on Delivery is the only
supported order-creation method.
- No support for grouped WooCommerce products.
- No UCP checkout/payment/order, no ACP, no MCP shopping surface, and no
search or ranking beyond returning the full catalog.
- No analytics, tracking, telemetry, or calls to any external service.
This plugin talks only to your own WordPress/WooCommerce install.
- No new payment infrastructure, no replacement for WooCommerce checkout,
and no AI chatbot — Flx Commerce is an adapter in front of WooCommerce,
not a new commerce backend.
Who this is for
Store operators who want their existing WooCommerce store to be
discoverable and machine-readable by AI shopping agents and other
commerce clients, while keeping WooCommerce as the single source of
truth for products, pricing, cart, checkout, and orders.
Features
- Public REST API under /wp-json/flx-commerce/v1/:
- GET /merchant — merchant identity
- GET /products — product/variant catalog, with pagination
- GET /capabilities — truthful capability flags
- GET /cart, POST /cart, PUT /cart, DELETE /cart — view/add/update/remove cart items
- POST /cart/address — set billing/shipping address
- POST /cart/shipping-rate — select a shipping rate
- POST /checkout — initiate checkout (preview only, no order)
- POST /order — place a real order (Cash on Delivery only)
- POST /ucp/catalog/search — UCP catalog search adapter
- GET /.well-known/ucp — the UCP merchant profile document
- Session continuity via WooCommerce’s own Store API Cart-Token
mechanism — no cookies or session storage of Flx’s own.
Requirements
- WordPress 6.5 or later.
- PHP 7.4 or later.
- WooCommerce, installed
and active. Flx Commerce does nothing on its own without it.
Usage / API overview
All endpoints are under your site’s REST API namespace,
/wp-json/flx-commerce/v1/. Discovery endpoints ( /merchant,
/products, /capabilities, /ucp/catalog/search, and
well-known/ucp) are public and read-only, matching a normal
storefront’s own public product/catalog visibility.
Cart, checkout, and order endpoints are also public, matching the same
public/customer-facing model WooCommerce’s own Store API uses for
storefront visitors — placing an order still only does what WooCommerce
itself would allow an anonymous customer to do. A first cart mutation
returns a Cart-Token response header; send it back as a Cart-Token
request header on subsequent calls to keep acting on the same cart.
Order creation additionally validates that Cart-Token and rejects any
payment_method other than cod.
Limitations
- Cash on Delivery is the only supported payment_method for order
creation. No other payment gateway can be used through this plugin’s
/order endpoint, regardless of what is enabled in WooCommerce.
- grouped WooCommerce products are not represented in product
discovery or cart operations.
- UCP support is limited to discovery/catalog ( /.well-known/ucp and
search); UCP checkout, payment, order, and
lookup are not implemented.
- No other AI-commerce protocol (ACP, MCP as a shopping surface, or
similar) is implemented.
- No search, filtering, or ranking is performed — /products and
/ucp/catalog/search return the store’s current catalog as-is.
- There is no admin settings screen in this release.