Flx Commerce

Àpèjúwe

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Ìtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’s own
  Site Title/Address/Tagline settings.
• Product discovery — a public, read-only REST endpoint listing the
  storeÌtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’s own Store API Cart-Token
  mechanism — no cookies or session storage of FlxÌtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’s own public product/catalog visibility.

Cart, checkout, and order endpoints are also public, matching the same
public/customer-facing model WooCommerceÌtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’s current catalog as-is.
• There is no admin settings screen in this release.