Flx Commerce

Description

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
  discovery/catalog interface at /.well-known/ucp and a
  catalog.search REST endpoint. UCP checkout, payment, order creation,
  and catalog.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
  catalog.search); UCP checkout, payment, order, and
  catalog.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.