{"id":363442,"date":"2026-09-06T15:53:17","date_gmt":"2026-09-06T15:53:17","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/flx-commerce\/"},"modified":"2026-09-06T15:52:44","modified_gmt":"2026-09-06T15:52:44","slug":"flx-commerce","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/flx-commerce\/","author":161177,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.1.0","stable_tag":"0.1.0","tested":"7.1","requires":"6.5","requires_php":"7.4","requires_plugins":null,"header_name":"Flx Commerce","header_author":"Rickey Gu","header_description":"Prepares a WooCommerce store to participate in AI-driven commerce by exposing reliable, machine-readable merchant, product, and commerce capability information, while keeping WooCommerce as the source of truth. Implements merchant\/product\/capability discovery plus real WooCommerce cart, checkout, shipping, and order creation (Cash on Delivery only -- no online payment processing yet).","assets_banners_color":"","last_updated":"2026-09-06 15:52:44","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/commerce.flexplat.com","header_author_uri":"https:\/\/github.com\/rickey29","rating":0,"author_block_rating":0,"active_installs":0,"downloads":32,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.1.0":{"tag":"0.1.0","author":"rickey29","date":"2026-09-06 15:52:44","revision":3683639}},"upgrade_notice":{"0.1.0":"<p>First public release.<\/p>"},"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.1.0"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[250436,271422,247962,23853,286],"plugin_category":[45],"plugin_contributors":[153307],"plugin_business_model":[],"class_list":["post-363442","plugin","type-plugin","status-publish","hentry","plugin_tags-agentic-commerce","plugin_tags-ai-commerce","plugin_tags-machine-readable","plugin_tags-rest-api","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-rickey29","plugin_committers-rickey29"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/flx-commerce.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Flx Commerce prepares an existing WooCommerce store to participate in\nAI-driven (\"agentic\") commerce by exposing reliable, machine-readable\ninformation about the merchant, its product catalog, and what the store\ncan actually do \u2014 and by letting an external client drive a <strong>real<\/strong>\nWooCommerce cart, checkout, and order through the store's own existing\nsetup.<\/p>\n\n<p>WooCommerce remains the source of truth for every commerce fact this\nplugin exposes. Flx Commerce stores no products, carts, checkouts,\norders, or customer data of its own; it reads from and acts through\nWooCommerce's own APIs (including its Store API) at the time each request\nis made.<\/p>\n\n<h4>What it does today<\/h4>\n\n<ul>\n<li><strong>Merchant discovery<\/strong> \u2014 a public, read-only REST endpoint describing\nthe store (name, URL, description), read live from WordPress's own\nSite Title\/Address\/Tagline settings.<\/li>\n<li><strong>Product discovery<\/strong> \u2014 a public, read-only REST endpoint listing the\nstore's catalog, including simple, external, and variable products with\ntheir variations represented correctly (a variable product is never\ngiven a single fabricated price). Supports pagination.<\/li>\n<li><strong>Commerce capability discovery<\/strong> \u2014 a public REST endpoint reporting,\ntruthfully, which of the capabilities below are actually implemented,\nso a client can check before attempting an operation instead of\nassuming.<\/li>\n<li><strong>Real WooCommerce cart mutation<\/strong> \u2014 add, view, update, and remove cart\nitems via WooCommerce's own Store API; no separate Flx cart exists.<\/li>\n<li><strong>Shipping support<\/strong> \u2014 set a billing\/shipping address and select a\nshipping rate on the cart, again entirely through WooCommerce's own\nStore API and shipping configuration.<\/li>\n<li><strong>Real WooCommerce checkout handoff<\/strong> \u2014 initiate WooCommerce checkout\nfor a cart and receive a live preview (payment methods, totals,\nshipping) without placing an order or attempting payment.<\/li>\n<li><strong>Real WooCommerce order creation, Cash on Delivery only<\/strong> \u2014 place an\nactual <code>WC_Order<\/code> for a cart. Payment is restricted to Cash on Delivery\n(<code>cod<\/code>) for this release; <strong>no online payment processing of any kind is\nimplemented.<\/strong><\/li>\n<li><strong>UCP discovery\/catalog adapter<\/strong> \u2014 exposes the same product catalog\nthrough the <a href=\"https:\/\/ucp.dev\/\">Universal Commerce Protocol<\/a>'s\ndiscovery\/catalog interface at <code>\/.well-known\/ucp<\/code> and a\n  catalog.search REST endpoint. UCP checkout, payment, order creation,\nand <code>catalog.lookup<\/code> are <strong>not<\/strong> implemented.<\/li>\n<\/ul>\n\n<h4>What it deliberately does not do (yet)<\/h4>\n\n<ul>\n<li>No online payment gateway integration. Cash on Delivery is the only\nsupported order-creation method.<\/li>\n<li>No support for <code>grouped<\/code> WooCommerce products.<\/li>\n<li>No UCP checkout\/payment\/order, no ACP, no MCP shopping surface, and no\nsearch or ranking beyond returning the full catalog.<\/li>\n<li>No analytics, tracking, telemetry, or calls to any external service.\nThis plugin talks only to your own WordPress\/WooCommerce install.<\/li>\n<li>No new payment infrastructure, no replacement for WooCommerce checkout,\nand no AI chatbot \u2014 Flx Commerce is an adapter in front of WooCommerce,\nnot a new commerce backend.<\/li>\n<\/ul>\n\n<h4>Who this is for<\/h4>\n\n<p>Store operators who want their existing WooCommerce store to be\ndiscoverable and machine-readable by AI shopping agents and other\ncommerce clients, while keeping WooCommerce as the single source of\ntruth for products, pricing, cart, checkout, and orders.<\/p>\n\n<h3>Features<\/h3>\n\n<ul>\n<li>Public REST API under <code>\/wp-json\/flx-commerce\/v1\/<\/code>:\n\n<ul>\n<li><code>GET \/merchant<\/code> \u2014 merchant identity<\/li>\n<li><code>GET \/products<\/code> \u2014 product\/variant catalog, with pagination<\/li>\n<li><code>GET \/capabilities<\/code> \u2014 truthful capability flags<\/li>\n<li><code>GET \/cart<\/code>, <code>POST \/cart<\/code>, <code>PUT \/cart<\/code>, <code>DELETE \/cart<\/code> \u2014 view\/add\/update\/remove cart items<\/li>\n<li><code>POST \/cart\/address<\/code> \u2014 set billing\/shipping address<\/li>\n<li><code>POST \/cart\/shipping-rate<\/code> \u2014 select a shipping rate<\/li>\n<li><code>POST \/checkout<\/code> \u2014 initiate checkout (preview only, no order)<\/li>\n<li><code>POST \/order<\/code> \u2014 place a real order (Cash on Delivery only)<\/li>\n<li><code>POST \/ucp\/catalog\/search<\/code> \u2014 UCP catalog search adapter<\/li>\n<\/ul><\/li>\n<li><code>GET \/.well-known\/ucp<\/code> \u2014 the UCP merchant profile document<\/li>\n<li>Session continuity via WooCommerce's own Store API <code>Cart-Token<\/code>\nmechanism \u2014 no cookies or session storage of Flx's own.<\/li>\n<\/ul>\n\n<h3>Requirements<\/h3>\n\n<ul>\n<li>WordPress 6.5 or later.<\/li>\n<li>PHP 7.4 or later.<\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/woocommerce\/\">WooCommerce<\/a>, installed\nand active. Flx Commerce does nothing on its own without it.<\/li>\n<\/ul>\n\n<h3>Usage \/ API overview<\/h3>\n\n<p>All endpoints are under your site's REST API namespace,\n    \/wp-json\/flx-commerce\/v1\/. Discovery endpoints (<code>\/merchant<\/code>,\n    \/products, <code>\/capabilities<\/code>, <code>\/ucp\/catalog\/search<\/code>, and\n    \/.well-known\/ucp) are public and read-only, matching a normal\nstorefront's own public product\/catalog visibility.<\/p>\n\n<p>Cart, checkout, and order endpoints are also public, matching the same\npublic\/customer-facing model WooCommerce's own Store API uses for\nstorefront visitors \u2014 placing an order still only does what WooCommerce\nitself would allow an anonymous customer to do. A first cart mutation\nreturns a <code>Cart-Token<\/code> response header; send it back as a <code>Cart-Token<\/code>\nrequest header on subsequent calls to keep acting on the same cart.\nOrder creation additionally validates that <code>Cart-Token<\/code> and rejects any\n    payment_method other than <code>cod<\/code>.<\/p>\n\n<h3>Limitations<\/h3>\n\n<ul>\n<li>Cash on Delivery is the only supported <code>payment_method<\/code> for order\ncreation. No other payment gateway can be used through this plugin's\n  \/order endpoint, regardless of what is enabled in WooCommerce.<\/li>\n<li><code>grouped<\/code> WooCommerce products are not represented in product\ndiscovery or cart operations.<\/li>\n<li>UCP support is limited to discovery\/catalog (<code>\/.well-known\/ucp<\/code> and\n  catalog.search); UCP checkout, payment, order, and\n  catalog.lookup are not implemented.<\/li>\n<li>No other AI-commerce protocol (ACP, MCP as a shopping surface, or\nsimilar) is implemented.<\/li>\n<li>No search, filtering, or ranking is performed \u2014 <code>\/products<\/code> and\n  \/ucp\/catalog\/search return the store's current catalog as-is.<\/li>\n<li>There is no admin settings screen in this release.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Ensure WooCommerce is installed and active.<\/li>\n<li>Upload the <code>flx-commerce<\/code> folder to <code>\/wp-content\/plugins\/<\/code>, or install\nthe plugin ZIP through <strong>Plugins \u2192 Add New \u2192 Upload Plugin<\/strong> in\nwp-admin.<\/li>\n<li>Activate <strong>Flx Commerce<\/strong> through the <strong>Plugins<\/strong> screen.<\/li>\n<li>No configuration screen is required. Confirm the REST API responds by\nvisiting <code>\/wp-json\/flx-commerce\/v1\/capabilities<\/code> on your site.<\/li>\n<\/ol>\n\n<p>Activation registers the <code>\/.well-known\/ucp<\/code> route and flushes rewrite\nrules once; no other setup step is needed.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20plugin%20process%20payments%3F\"><h3>Does this plugin process payments?<\/h3><\/dt>\n<dd><p>No. <code>POST \/order<\/code> can only create an order using Cash on Delivery\n(<code>cod<\/code>), which contacts no payment processor and moves no money. No\nonline payment gateway integration exists in this release.<\/p><\/dd>\n<dt id=\"does%20this%20replace%20woocommerce%20checkout%3F\"><h3>Does this replace WooCommerce checkout?<\/h3><\/dt>\n<dd><p>No. Flx Commerce delegates every cart, checkout, and order operation to\nWooCommerce's own Store API and order-creation code. It adds a\nmachine-readable REST surface in front of WooCommerce; it does not\nreimplement or replace any part of WooCommerce.<\/p><\/dd>\n<dt id=\"does%20this%20plugin%20store%20any%20of%20my%20store%27s%20data%3F\"><h3>Does this plugin store any of my store's data?<\/h3><\/dt>\n<dd><p>No. Merchant, product, cart, checkout, and order data are all read from\nor acted through WooCommerce's own APIs at request time. The only data\nthis plugin persists is a small internal option tracking its own\ninstalled version, used to manage its <code>\/.well-known\/ucp<\/code> rewrite rule\nsafely \u2014 no store, product, customer, or order data.<\/p><\/dd>\n<dt id=\"does%20this%20plugin%20send%20data%20to%20any%20external%20service%3F\"><h3>Does this plugin send data to any external service?<\/h3><\/dt>\n<dd><p>No. Flx Commerce makes no outbound calls to any third-party or Flx-owned\nservice. Its REST endpoints only ever talk to your own\nWordPress\/WooCommerce install (via WordPress's own internal REST\ndispatch and, for checkout\/order, a loopback HTTP request to your own\nsite's REST API).<\/p><\/dd>\n<dt id=\"what%20is%20ucp%2C%20and%20is%20it%20fully%20supported%3F\"><h3>What is UCP, and is it fully supported?<\/h3><\/dt>\n<dd><p>UCP (Universal Commerce Protocol) is an open protocol for AI commerce\ndiscovery. This plugin implements only its discovery\/catalog interface \u2014\na merchant profile document and a catalog-search endpoint. UCP checkout,\npayment, order creation, and product lookup are not implemented.<\/p><\/dd>\n<dt id=\"which%20product%20types%20are%20supported%3F\"><h3>Which product types are supported?<\/h3><\/dt>\n<dd><p>Simple, external, and variable products (including their variations).\nGrouped products are not currently supported.<\/p><\/dd>\n<dt id=\"is%20there%20a%20settings%20page%3F\"><h3>Is there a settings page?<\/h3><\/dt>\n<dd><p>No. This release has no configuration UI; behavior is either automatic\n(discovery endpoints) or governed by WooCommerce's own store\nconfiguration (shipping, available payment methods, etc.).<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>First public release. Merchant discovery, product\/variant discovery,\ncommerce capability discovery, real WooCommerce cart mutation,\nshipping address\/rate support, checkout handoff, real order creation\n(Cash on Delivery only), and a UCP discovery\/catalog adapter.<\/li>\n<\/ul>","raw_excerpt":"Exposes machine-readable merchant, product, and commerce capability data from WooCommerce, with real cart, checkout, and Cash-on-Delivery order APIs.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/363442","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=363442"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/rickey29"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=363442"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=363442"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=363442"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=363442"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=363442"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=363442"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}