Title: Shopping Agent with UCP
Author: rogerdeng
Published: <strong>3 maart 2026</strong>
Last modified: 3 maart 2026

---

Plugins zoeken

![](https://s.w.org/plugins/geopattern-icon/shopping-agent-with-ucp.svg)

# Shopping Agent with UCP

 Door [rogerdeng](https://profiles.wordpress.org/rogerdeng/)

[Download](https://downloads.wordpress.org/plugin/shopping-agent-with-ucp.1.0.11.zip)

 * [Details](https://nl.wordpress.org/plugins/shopping-agent-with-ucp/#description)
 * [Beoordelingen](https://nl.wordpress.org/plugins/shopping-agent-with-ucp/#reviews)
 *  [Installatie](https://nl.wordpress.org/plugins/shopping-agent-with-ucp/#installation)
 * [Ontwikkeling](https://nl.wordpress.org/plugins/shopping-agent-with-ucp/#developers)

 [Ondersteuning](https://wordpress.org/support/plugin/shopping-agent-with-ucp/)

## Beschrijving

**Shopping Agent with UCP** implements the Google Universal Commerce Protocol (UCP),
providing a standardized REST API that enables AI agents and automated systems to
interact with your online store.

This plugin requires WooCommerce to be installed and activated.

#### Key Features

 * **Store Discovery** – Standard `/.well-known/ucp` endpoint for AI agents to discover
   your store’s capabilities
 * **Product Catalog** – Browse, search, and filter products with full support for
   variations
 * **Category Navigation** – Full category hierarchy with nested subcategories
 * **Persistent Cart** – Create and manage shopping carts with automatic stock validation
 * **Checkout Sessions** – Complete checkout flow with address management and coupon
   support
 * **Order Management** – Retrieve order details, status, and event timeline
 * **Customer Profiles** – Create and manage customer accounts
 * **Shipping Rates** – Real-time shipping rate calculation
 * **Product Reviews** – Access and create product reviews
 * **Coupon Validation** – Discover and validate promotional codes
 * **Webhooks** – Real-time order event notifications with HMAC-SHA256 signatures,
   retry logic, and automatic failed webhook recovery
 * **Secure Authentication** – API key authentication with granular permission levels

#### Why Use Shopping Agent with UCP?

The Universal Commerce Protocol (UCP) is designed to enable AI assistants and automated
agents to help users discover products, compare options, and complete purchases.
By implementing UCP, your store becomes accessible to the next generation of AI-
powered shopping experiences.

#### API Endpoints

The plugin provides the following API endpoints:

 * `/wp-json/ucp/v1/discovery` – Store discovery and capabilities
 * `/wp-json/ucp/v1/products` – Product listing, search, and details
 * `/wp-json/ucp/v1/categories` – Category navigation
 * `/wp-json/ucp/v1/carts` – Cart management
 * `/wp-json/ucp/v1/checkout/sessions` – Checkout flow
 * `/wp-json/ucp/v1/orders` – Order information
 * `/wp-json/ucp/v1/customers` – Customer management
 * `/wp-json/ucp/v1/shipping/rates` – Shipping calculation
 * `/wp-json/ucp/v1/reviews` – Product reviews
 * `/wp-json/ucp/v1/coupons` – Coupon validation

#### Authentication

API keys can be created with three permission levels:

 * **Read** – Browse products, categories, reviews
 * **Write** – Create carts, checkout sessions, orders
 * **Admin** – Full access including API key management

#### Requirements

 * WordPress 5.8 or higher
 * WooCommerce 5.0 or higher
 * PHP 7.4 or higher

#### External Services

 1. **UCP Schema Registry**
 2.  * **Service URL:** `https://ucp.dev`
     * **Purpose:** Referenced as a protocol namespace identifier in JSON schemas and
       API responses.
     * **Data Sent:** None. This is a passive reference; the plugin does not connect
       to or send data to this service.
     * **Privacy Policy:** N/A (Static documentation site)
     * **Terms of Service:** N/A
 3. **Documentation Examples**
 4.  * **Service URLs:** `https://agent.example`, `https://your-store.com`
     * **Purpose:** Used as placeholder URLs in documentation examples and code comments
       to demonstrate link relations.
     * **Data Sent:** None.
     * **Privacy Policy:** N/A
     * **Terms of Service:** N/A
 5. **User-Configured Webhooks**
 6.  * **Service URL:** Varies (User configured)
     * **Purpose:** Sending real-time order event notifications.
     * **Data Sent:** Order details, customer information, and checkout status as JSON
       payloads.
     * **Timing:** Triggered immediately when specific events occur (e.g., order creation)
       or via WP-Cron for retries.
     * **Privacy Policy:** Please refer to the privacy policy of the specific service
       you configure as a webhook receiver.

#### Documentation

For full documentation, please visit our [GitHub repository](https://github.com/rogerdeng/shopping-agent-with-ucp).

### Privacy Policy

Shopping Agent with UCP stores the following data:

 * **API Keys** – Stored in a custom database table with hashed secrets
 * **Cart Sessions** – Temporary cart data stored until expiration or checkout
 * **Checkout Sessions** – Temporary checkout data stored until completion or expiration
 * **Webhook Configurations** – Webhook URLs and secrets for event notifications

No data is sent to external servers except:
 * Webhook payloads are sent to URLs
you configure for order event notifications

All data is stored locally in your WordPress database and can be deleted by deactivating
and removing the plugin.

### Third Party Services

This plugin does not connect to any third-party services by default. If you configure
webhooks, the plugin will send HTTP POST requests to the URLs you specify when order
events occur.

This plugin requires WooCommerce (https://woocommerce.com) to function, but does
not send any data to WooCommerce servers.

## Installatie

#### Automatic Installation

 1. Log in to your WordPress admin panel
 2. Go to Plugins > Add New
 3. Search for “Shopping Agent with UCP”
 4. Click “Install Now” and then “Activate”
 5. Ensure WooCommerce is installed and activated
 6. Go to WooCommerce > Shopping Agent to configure settings

#### Manual Installation

 1. Download the plugin zip file
 2. Log in to your WordPress admin panel
 3. Go to Plugins > Add New > Upload Plugin
 4. Upload the zip file and click “Install Now”
 5. Activate the plugin
 6. Ensure WooCommerce is installed and activated
 7. Go to WooCommerce > Shopping Agent to configure settings

## FAQ

### What is the Universal Commerce Protocol (UCP)?

UCP is a standardized protocol designed by Google to enable AI agents and automated
systems to interact with e-commerce stores. It provides a consistent API structure
for discovery, browsing, and transactions.

### Does this plugin require WooCommerce?

Yes, this plugin is an extension for WooCommerce and requires WooCommerce to be 
installed and activated.

### Do I need special hosting for this plugin?

No, the plugin works on any hosting that supports WordPress and WooCommerce. The
REST API endpoints are served through WordPress’s built-in REST API infrastructure.

### How do AI agents find my store?

AI agents can discover your store by accessing the `/.well-known/ucp` endpoint at
your site’s root URL. This returns a manifest of your store’s capabilities and available
API endpoints.

### Is this plugin secure?

Yes, the plugin implements secure API key authentication with hashed secrets stored
in the database. All inputs are sanitized and outputs are escaped following WordPress
security best practices. Webhook payloads are signed with HMAC-SHA256 for verification.

### Can I limit API access?

Yes, you can create API keys with different permission levels (read, write, admin)
and set rate limits to control API usage. You can also revoke API keys at any time.

### Does this work with product variations?

Yes, the plugin fully supports variable products, including listing all variations
with their attributes, prices, and stock status.

### How do I test if the API is working?

You can test the discovery endpoint directly in your browser by visiting `https://
your-site.com/.well-known/ucp`. For other endpoints, use a tool like cURL or Postman
with your API key.

### What happens to carts and checkout sessions?

Carts and checkout sessions have configurable expiration times (default: 24 hours
for carts, 30 minutes for checkout). Expired sessions are automatically cleaned 
up.

## Beoordelingen

Er zijn geen beoordelingen voor deze plugin.

## Bijdragers & ontwikkelaars

“Shopping Agent with UCP” is open source software. De volgende personen hebben bijgedragen
aan deze plugin.

Bijdragers

 *   [ rogerdeng ](https://profiles.wordpress.org/rogerdeng/)

[Vertaal “Shopping Agent with UCP” in je eigen taal.](https://translate.wordpress.org/projects/wp-plugins/shopping-agent-with-ucp)

### Interesse in ontwikkeling?

[Bekijk de code](https://plugins.trac.wordpress.org/browser/shopping-agent-with-ucp/),
haal de [SVN repository](https://plugins.svn.wordpress.org/shopping-agent-with-ucp/)
op, of abonneer je op het [ontwikkellog](https://plugins.trac.wordpress.org/log/shopping-agent-with-ucp/)
via [RSS](https://plugins.trac.wordpress.org/log/shopping-agent-with-ucp/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.11

 * Removed custom update checker (`plugins_api` filter and `plugin_row_meta` injection)
   to comply with WordPress.org guidelines.
 * Plugin now relies entirely on WordPress.org’s built-in update system.

#### 1.0.4

 * Fix: Resolved 403 Forbidden error on API key creation (fixed UI selector mismatches).
 * Update: Added detailed “External Services” declaration.
 * Update: Corrected file structure documentation.
 * Update: Renamed menu item to “Shopping Agent”.
 * Renamed plugin to “Shopping Agent with UCP” to avoid trademark issues.
 * Updated prefixes to avoid conflicts.
 * Security enhancements (direct file access checks).

#### 1.0.2

 * Webhook retry with exponential backoff (3 attempts)
 * Failed webhook storage and automatic recovery via WP-Cron
 * Signing keys generation and discovery endpoint exposure
 * API key caching for improved performance
 * Enhanced webhook signature format (t=timestamp,v1=hash)
 * Backward compatible signature verification

#### 1.0.0

 * Initial release
 * Store discovery endpoint (/.well-known/ucp)
 * Products API with search and filtering
 * Categories API with hierarchy support
 * Persistent cart management
 * Checkout session flow
 * Order retrieval and timeline
 * Customer profile management
 * Shipping rate calculation
 * Product reviews API
 * Coupon validation
 * Webhook support for order events
 * API key authentication with permissions
 * Admin settings interface
 * Rate limiting support
 * Internationalization ready

## Meta

 *  Versie **1.0.11**
 *  Laatst geüpdatet **7 maanden geleden**
 *  Actieve installaties **Minder dan 10**
 *  WordPress versie ** 5.8 of nieuwer **
 *  Getest t/m **6.9.10**
 *  PHP versie ** 7.4 of nieuwer **
 *  Taal
 * [English (US)](https://wordpress.org/plugins/shopping-agent-with-ucp/)
 * Tags
 * [agent](https://nl.wordpress.org/plugins/tags/agent/)[ecommerce](https://nl.wordpress.org/plugins/tags/ecommerce/)
   [shopping](https://nl.wordpress.org/plugins/tags/shopping/)[woocommerce](https://nl.wordpress.org/plugins/tags/woocommerce/)
 *  [Geavanceerde weergave](https://nl.wordpress.org/plugins/shopping-agent-with-ucp/advanced/)

## Waarderingen

Er zijn nog geen beoordelingen ingediend.

[Je beoordeling](https://wordpress.org/support/plugin/shopping-agent-with-ucp/reviews/#new-post)

[Bekijk alle beoordelingen](https://wordpress.org/support/plugin/shopping-agent-with-ucp/reviews/)

## Bijdragers

 *   [ rogerdeng ](https://profiles.wordpress.org/rogerdeng/)

## Ondersteuning

Iets te melden? Hulp nodig?

 [Het supportforum bekijken](https://wordpress.org/support/plugin/shopping-agent-with-ucp/)

## Doneren

Wil je de groei van deze plugin ondersteunen?

 [ Doneer aan deze plugin ](https://sites.google.com/view/shopping-agent-with-ucp)