內容簡介
Flx Commerce 外掛為現有的 WooCommerce 商店提供 AI 驅動的商務功能，透過可靠的機器可讀資訊，讓外部客戶能夠直接操作 WooCommerce 購物車、結帳及訂單，提升商店的互動性與效率。
【主要功能】
• 商家發現：提供公開的 REST 端點，描述商店資訊
• 產品發現：列出商店產品目錄，包括各類產品
• 商務能力發現：報告實際實作的商務功能
• 真實購物車操作：透過 WooCommerce API 操作購物車
• 運送支援：設定地址及選擇運費
• 真實結帳交接：啟動 WooCommerce 結帳流程
外掛標籤
開發者團隊
原文外掛簡介
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.
