ProductGraph Adapter for WooCommerce

Connect your WooCommerce store to AI shopping agents. This plugin enables AI agents like Google Shopping and ChatGPT to discover, browse, and purchase products from your store using industry-standard commerce protocols.

Why This Plugin?

AI agents are becoming a major shopping channel. Google, OpenAI, and other companies are building AI-powered shopping experiences that can browse products and complete purchases on behalf of users. To participate, your store needs to speak their protocols:

• Google's UCP (Universal Commerce Protocol) — backed by Google, Shopify, Walmart, Target, Stripe, Visa, Mastercard
• OpenAI's ACP (Agentic Commerce Protocol) — powers ChatGPT's instant checkout via Stripe

ProductGraph Adapter adds both protocols to any WooCommerce store with zero code changes.

How It Works

┌─────────────────────────────────────────┐
│         AI Agent (Google, ChatGPT)      │
└──────────────────┬──────────────────────┘
                   │
       ┌───────────┴───────────┐
       │                       │
  UCP Protocol           ACP Protocol
       │                       │
┌──────▼────────┐    ┌────────▼───────┐
│ Discovery     │    │ Product Feed   │
│ Manifest      │    │ for ChatGPT    │
│ + Checkout    │    │ + Checkout     │
└──────┬────────┘    └────────┬───────┘
       │                       │
       └───────────┬───────────┘
                   │
       ┌───────────▼───────────┐
       │   ProductGraph        │
       │   Adapter Plugin      │
       └───────────┬───────────┘
                   │
       ┌───────────▼───────────┐
       │   WooCommerce Store   │
       │  (Products, Orders,   │
       │   Payments)           │
       └───────────────────────┘

1. Discovery — AI agents find your store via UCP manifest (/.well-known/ucp) or ACP product feed
2. Session Creation — Agent creates a checkout session with selected products
3. Checkout — Agent provides shipping info, selects fulfillment, and submits payment
4. Order — A standard WooCommerce order is created and processed

Supported Protocols

UCP (Universal Commerce Protocol)

• Developed by Google with Shopify, Etsy, Wayfair, Target, Walmart
• Supported by Stripe, Visa, Mastercard, Adyen, American Express
• Discovery: /.well-known/ucp
• Checkout: /wp-json/productgraph/v1/checkout-sessions

ACP (Agentic Commerce Protocol)

• Developed by OpenAI with Stripe
• Used by ChatGPT for instant checkout
• Discovery: /wp-json/productgraph/v1/feed
• Checkout: /wp-json/productgraph/v1/checkout_sessions

Requirements

• WordPress 6.7+
• WooCommerce 9.0+
• PHP 8.0+
• HTTPS enabled
• Permalinks configured (not "Plain")

Installation

From ZIP

1. Download the latest release from Releases
2. In WordPress admin, go to Plugins > Add New > Upload Plugin
3. Upload the ZIP file and activate

Manual

1. Clone this repo into /wp-content/plugins/
2. Run composer install in the plugin directory
3. Activate through WordPress admin

After Installation

1. Go to WooCommerce > ProductGraph
2. Enable UCP and/or ACP protocols
3. Register your store with Google Merchant Center and/or OpenAI Commerce Program

Configuration

Enable/Disable Protocols

You can independently enable or disable each protocol:

• UCP Protocol: For Google, Shopify, and other UCP-compatible agents
• ACP Protocol: For OpenAI/ChatGPT and ACP-compatible agents

Store Settings

• Store Name: How your store appears to AI agents
• Payment Handlers: Automatically detected from WooCommerce payment gateways

API Endpoints

UCP Endpoints

ACP Endpoints

Payment Gateways

The plugin automatically detects and supports these WooCommerce payment gateways:

• Stripe (card, Google Pay, Apple Pay)
• PayPal
• Square

Session Lifecycle

Sessions expire after 30 minutes of inactivity. Expired sessions are automatically cleaned up.

UCP States

incomplete → ready_for_complete → complete

ACP States

not_ready_for_payment → ready_for_payment → completed

Security

• CSRF protection via WordPress nonces
• SQL injection prevention with $wpdb->prepare()
• Input sanitization and output escaping
• HTTPS required for all agent communication
• 30-minute session TTL with automatic cleanup

Documentation

• UCP Specification
• ACP Documentation
• ACP GitHub

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/my-feature)
3. Commit your changes (git commit -m 'Add my feature')
4. Push to the branch (git push origin feature/my-feature)
5. Open a Pull Request

License

GPL v2 or later. See LICENSE for details.

Support

For support, please visit productgraph.io or open an issue.