Installing the plugin
Two ways to install: from the WordPress.org plugin directory once we’re approved (recommended), or by uploading the zip from install.xpay.sh (works today).
From WordPress.org
Open the Plugins page
In your WordPress admin, in the left sidebar, hover Plugins → click Add New Plugin.
Search for the plugin
In the search box on the top right, type Agentic Commerce for WooCommerce.
Install
Click Install Now on the card that shows our banner + icon.
Activate
Click Activate. You’ll be redirected to Settings → xpay.
Connect store
System requirements
| Component | Minimum | Tested up to |
|---|---|---|
| WordPress | 6.2 | 6.7 |
| WooCommerce | 7.0 | 9.4 |
| PHP | 7.4 | 8.3 |
SSL (https://) | required | — |
What happens on activation
In order:
- The plugin registers two rewrite rules —
/llms.txtand/.well-known/agentic-commerce.json. - It schedules a one-time rewrite-rule flush on the next
inithook. - It marks itself as “ever activated” so the first-time-only welcome flow happens once.
- It surfaces the first-activation consent notice asking whether you want to share anonymous lifecycle telemetry. Default: off.
- It redirects you to Settings → xpay (skipped if you bulk-activated multiple plugins together).
The plugin does not contact xpay’s servers at activation. The first network call only happens when you click Connect store.
Verifying the install
After activation, check these in any order:
| Check | What you should see |
|---|---|
| Plugins list | ”Agentic Commerce for WooCommerce” with version 0.1.7+ and status “Active” |
| Settings → xpay | Big “Connect your store” card + an “Audit readiness” table with some yellow ⚠ Pending rows |
curl https://yourstore.com/llms.txt | HTTP 200, plain text starting with # <your site name> |
curl https://yourstore.com/.well-known/agentic-commerce.json | HTTP 200, valid JSON |
If the curl checks fail with 404, go to Settings → Permalinks → Save Changes once (forces a rewrite flush) and retry.
What’s next
→ Generate your WooCommerce REST API keys (required for the connect step)