WooCommerce Plugin Documentation - AI Merchant Pro

Overview

AI Merchant Pro for WooCommerce is a powerful plugin that generates AI-ready product feeds for ChatGPT Shopping and Google Merchant Center. It creates dual-format feeds (XML + JSON) from your WooCommerce catalog, making your products discoverable by 300M+ ChatGPT users and traditional shopping platforms.

NEW: UCP v7.0 Support

Version 7.0 introduces the Universal Commerce Protocol, enabling:

Google AI Mode - Direct checkout from Gemini conversations
AI Agent Checkout - Complete purchases via API
Google Pay - One-tap payment integration
REST API - 12 endpoints for full commerce automation

Learn more about UCP →

Dual Feed Generation

Generate both XML (Google) and JSON ACP (ChatGPT) feeds simultaneously from your catalog.

Learn more

ACP Validator

Scan your entire catalog for ChatGPT compatibility issues before submission.

Learn more

Shipping Rules

Visual builder for complex shipping rules by country and service type.

Learn more

UCP Protocol

Full UCP v7.0 support for Google AI Mode and AI assistants with native checkout.

Learn more

AI Agent Checkout

Let AI agents create checkout sessions and complete purchases via REST API.

Learn more

Google Pay

One-tap checkout with Google Pay integration for seamless AI commerce.

Learn more

System Requirements

Minimum Requirements

WordPress 5.8 or higher
WooCommerce 5.0 or higher
PHP 7.4 or higher (8.0+ recommended)
MySQL 5.6 or higher
Memory Limit 256MB minimum (512MB recommended)

For Large Catalogs (50K+ products)

PHP 8.0 or higher
1024MB memory limit
600 seconds max execution time
OPcache enabled
Redis or Memcached (object cache) recommended

For UCP / Google AI Mode

All standard requirements plus:

HTTPS required (valid SSL certificate)
WooCommerce payment gateway configured
(Optional) Stripe, Adyen, or Square for Google Pay
(Optional) Google Pay Merchant ID for one-tap checkout

Quick Start Checklist

WordPress & WooCommerce installed and active
Products with images, prices, and descriptions
SSL certificate installed (HTTPS required for UCP)
License key from shop.aimerchantpro.com purchase
(Optional) Google Pay Merchant ID for one-tap checkout
(Optional) UCP enabled for Google AI Mode support

Installation

Download the Plugin

Purchase and download AI Merchant Pro from shop.aimerchantpro.com. You'll receive a ZIP file named ai-merchant-pro-woocommerce-v7.0.0.zip.

Upload to WordPress

In your WordPress admin, navigate to Plugins → Add New → Upload Plugin. Click "Choose File" and select the ZIP file, then click "Install Now".

Activate the Plugin

After installation completes, click "Activate Plugin". You'll see a new "AI Merchant Pro" menu in your WordPress sidebar.

Flush Permalinks

Critical step: Go to Settings → Permalinks and click "Save Changes" without changing anything. This registers the feed URLs with WordPress.

Skipping this step will cause your feeds to return 404 errors!

Activate Your License

Navigate to AI Merchant Pro → License, enter your license key from shop.aimerchantpro.com, and click "Activate License". This unlocks all premium features including UCP support.

Installation Complete!

Your feeds are now available at:

XML Feed: https://yoursite.com/?feed=googlemerchant
JSON Feed: https://yoursite.com/?feed=chatgpt_json

Feed Configuration

Your Feed URLs

After installation, your product feeds are dynamically generated at these endpoints:

Feed Type	URL Parameter	Use Case
XML Feed	`?feed=googlemerchant`	Google Merchant Center, traditional platforms
JSON ACP	`?feed=chatgpt_json`	ChatGPT Shopping, AI assistants
Sample Feed	`?feed=chatgpt_json&sample=1`	First 5 products for testing

XML vs JSON: Which Should I Use?

XML Feed (Google Merchant)

RSS 2.0 with Google namespace
Standard product attributes
Compatible with Google Shopping
No shipping rules included
Limited variant support
No 3D models

Best for: Traditional shopping platforms, Google Merchant Center campaigns

Recommended for AI

JSON ACP Feed (ChatGPT)

AI Commerce Protocol format
Rich metadata structure
Shipping rules included
Full variant support
Video & 3D model URLs
Optimized for AI understanding

Best for: ChatGPT Shopping, AI assistants, conversational commerce

Pro Tip

You can (and should!) enable both feed formats. Use XML for Google Merchant Center and JSON ACP for ChatGPT simultaneously.

Optional Fields Configuration

Configure which optional fields to include in your feeds from AI Merchant Pro → Settings → Feed Options:

Field	Description	Default
`include_variants`	Include all product variations as separate items	Enabled
`include_out_of_stock`	Include products with zero inventory	Disabled
`include_hidden`	Include products hidden from catalog	Disabled
`include_reviews`	Include product review data and ratings	Enabled
`include_videos`	Include video URLs from product gallery	Enabled

Currency Settings

The plugin automatically uses your WooCommerce currency settings. For multi-currency stores, you can generate feeds in different currencies by adding a currency parameter to your feed URL (e.g., adding ¤cy=EUR to the feed URL).

The plugin is compatible with popular multi-currency plugins like WPML, WooCommerce Multi-Currency, and Currency Switcher.

Shipping Rules

The Shipping Rules Builder allows you to define complex shipping costs that are included in your JSON ACP feed. ChatGPT uses this data to provide accurate shipping estimates to shoppers.

Using the Shipping Builder

Navigate to AI Merchant Pro → Shipping Rules to access the visual shipping builder.

Add a Shipping Rule

Click "Add Rule" and select a country from the dropdown. You can add multiple rules for different countries.

Configure Service Types

For each country, add shipping services (Standard, Express, Overnight) with their respective costs and delivery time ranges.

Set Free Shipping Thresholds

Optionally set a minimum order value for free shipping. Orders above this amount will show $0 shipping cost.

Save Rules

Click "Save Rules" to apply your configuration. The changes will be reflected in your next feed generation.

Service Types Reference

Service Type	ACP Code	Typical Delivery
Standard Shipping	`standard`	5-7 business days
Express Shipping	`express`	2-3 business days
Overnight/Next Day	`overnight`	1 business day
Store Pickup	`pickup`	Same day
Freight/Heavy Items	`freight`	7-14 business days

Example: US Shipping Rules

Here's an example of how you might configure shipping for the United States:

Standard Shipping: $5.99, 5-7 business days, free over $50
Express Shipping: $12.99, 2-3 business days

You can add as many countries and service types as you need. The shipping data is automatically included in your JSON ACP feed so ChatGPT can provide accurate shipping estimates to customers.

ACP Validator

The ACP Validator scans your entire product catalog to identify issues that could prevent products from appearing in ChatGPT Shopping or cause disapprovals.

Running a Validation Scan

Navigate to AI Merchant Pro → ACP Validator
Click "Start Validation" to begin scanning
Wait for the scan to complete (progress shown in real-time)
Review the results dashboard with issues grouped by severity

Understanding Issue Severity

Critical Blocks submission

Product will not appear in ChatGPT Shopping. Must fix before submission.

Missing product title
No product URL
Price is zero or negative
No images

Warning May cause issues

Product may have reduced visibility or accuracy issues.

Description too short (<50 chars)
Missing brand information
No GTIN/SKU
Low-quality images

Info Optimization suggestions

Recommendations to improve product discoverability.

Add more product images
Include video content
Add size/color attributes
Enable customer reviews

Fixing Common Issues

Missing GTIN/EAN/UPC

GTINs (Global Trade Item Numbers) help identify products uniquely. To add:

Edit the product in WooCommerce
Go to Product Data → Inventory
Enter the GTIN in the SKU field, or install a GTIN plugin
For custom GTIN field, map it in AI Merchant Pro → Field Mapping

Images Too Small

ChatGPT Shopping requires images at least 500x500 pixels. To fix:

Upload higher resolution product images
Regenerate thumbnails using a plugin like "Regenerate Thumbnails"
Check WooCommerce → Settings → Products → Display for image size settings

Description Too Short

Product descriptions should be at least 150 characters for optimal AI understanding:

Include key features and benefits
Describe materials, dimensions, and use cases
Avoid keyword stuffing - write naturally
Use the short description field for feeds if main description is too long

Price Mismatch

Feed price must match your website price exactly:

Ensure sale prices are correctly configured with dates
Clear any caching plugins after price changes
Check for currency conversion plugins that might affect prices
Regenerate your feed after making price updates

ChatGPT Integration

Connect your WooCommerce store directly to ChatGPT Shopping, making your products discoverable by millions of ChatGPT users.

Standard Submission Flow

For most merchants, the standard flow involves submitting your feed URL to OpenAI for crawling:

Generate Your Feed

Ensure your JSON ACP feed is accessible at:
https://yoursite.com/?feed=chatgpt_json

Validate Your Feed

Run the ACP Validator to check for any critical issues. Fix all critical errors before submission.

Submit to OpenAI

Visit the OpenAI Merchant Portal and submit your feed URL for review.

Await Approval

OpenAI will crawl and verify your feed. Approval typically takes 3-7 business days. You'll receive email notification.

Direct Push (Agency License)

Agency license holders can push feed updates directly to OpenAI's endpoint for faster updates without waiting for crawls.

Agency License Required

Direct Push requires an Agency license and OpenAI API credentials. Contact support for setup assistance.

Direct Push Benefits

Instant Updates - Changes reflect in minutes, not days
Real-time Inventory - Stock levels sync automatically
Price Sync - Sale prices update immediately
Selective Push - Update only changed products

Checking Submission Status

Monitor your feed status in AI Merchant Pro → ChatGPT Status:

Pending - Awaiting initial crawl

Processing - Feed being validated

Approved - Products live on ChatGPT

Rejected - Issues found, check validator

UCP Protocol

AI Merchant Pro v7.0 introduces full support for the Universal Commerce Protocol (UCP), enabling native checkout experiences in Google AI Mode, Gemini, and other AI assistants.

What is UCP?

UCP (Universal Commerce Protocol) is an open standard for AI commerce developed by Google in partnership with Shopify, Etsy, Target, Walmart, and 20+ other partners. It allows AI assistants to complete purchases directly within conversations.

First WordPress Plugin

AI Merchant Pro is the first WordPress plugin to implement UCP v7.0.

Benefit	Description
AI Discovery	AI agents automatically find your store via discovery endpoint
Native Checkout	Customers can purchase without leaving the AI conversation
Real-time Data	Product info, pricing, and stock always current
Secure Payments	Google Pay and standard gateways supported

Discovery Endpoint

Your store's UCP profile is automatically available at:

https://yoursite.com/.well-known/ucp

This endpoint is discovered automatically by AI agents - you don't need to submit it anywhere. Google and other AI platforms will find it through standard web discovery.

What the Discovery Endpoint Contains

The /.well-known/ucp endpoint returns a JSON profile with:

Store information (name, URL, currency, country)
Available capabilities (checkout, catalog, search, discounts, shipping)
API base URL for further interactions
Supported payment methods
Rate limit information

Testing Your Discovery Endpoint

Open your browser and visit: https://yoursite.com/.well-known/ucp
You should see a JSON response with your store profile
Verify all information is correct
Use the UCP Validator in the plugin to run a full check

REST API Endpoints

AI Merchant Pro exposes a complete REST API for AI agent interactions:

Catalog Endpoints (Public)

Endpoint	Method	Description
`/.well-known/ucp`	GET	UCP Discovery Profile
`/wp-json/ucp/v1/openapi.json`	GET	OpenAPI 3.1 Specification
`/wp-json/ucp/v1/profile`	GET	Store profile and capabilities
`/wp-json/ucp/v1/products`	GET	List products (paginated)
`/wp-json/ucp/v1/products/{id}`	GET	Get single product details
`/wp-json/ucp/v1/products/search`	GET	Search products
`/wp-json/ucp/v1/categories`	GET	List product categories

 Checkout Endpoints (May require API key)
     Endpoint  Method  Description  
 
   /wp-json/ucp/v1/checkout/sessions  POST  Create checkout session  
  /wp-json/ucp/v1/checkout/sessions/{id}  GET  Get session status  
  /wp-json/ucp/v1/checkout/sessions/{id}  PATCH  Update session  
  /wp-json/ucp/v1/checkout/sessions/{id}/complete  POST  Complete checkout  
  /wp-json/ucp/v1/shipping/rates  POST  Get shipping rates  
  /wp-json/ucp/v1/discounts/validate  POST  Validate discount code  
 
 
 Query Parameters for Products
     Parameter  Type  Description  
 
   limit  int  Results per page (default: 20, max: 100)  
  offset  int  Pagination offset  
  category  string  Filter by category slug  
  in_stock  boolean  Only show in-stock items  
  min_price  number  Minimum price filter  
  max_price  number  Maximum price filter  
 
 
 
 UCP Capabilities
 AI Merchant Pro declares these UCP capabilities to AI agents:
     Capability  Code  Description  Status  
 
   Catalog  dev.ucp.shopping.catalog  Browse products  Active  
  Search  dev.ucp.shopping.search  Search products  Active  
  Checkout  dev.ucp.shopping.checkout  Create checkout sessions  Active  
  Discounts  dev.ucp.shopping.discount  Apply coupon codes  Active  
  Fulfillment  dev.ucp.shopping.fulfillment  Calculate shipping  Active  
 
 
 
     
   Coming Soon 
    dev.ucp.shopping.loyalty - Loyalty program integration
 dev.ucp.shopping.identity - Customer identity management
 dev.ucp.shopping.subscriptions - Recurring orders
 dev.ucp.shopping.orders - Order history and tracking
 
  
 
 
 
 OpenAPI Specification
 A complete OpenAPI 3.1 specification is available at:
  https://yoursite.com/wp-json/ucp/v1/openapi.json 
 This specification can be used by:
  AI agents to understand your API structure
 Developers building custom integrations
 API testing tools (Postman, Insomnia)
 Documentation generators

Endpoint	Method	Description
`/wp-json/ucp/v1/checkout/sessions`	POST	Create checkout session
`/wp-json/ucp/v1/checkout/sessions/{id}`	GET	Get session status
`/wp-json/ucp/v1/checkout/sessions/{id}`	PATCH	Update session
`/wp-json/ucp/v1/checkout/sessions/{id}/complete`	POST	Complete checkout
`/wp-json/ucp/v1/shipping/rates`	POST	Get shipping rates
`/wp-json/ucp/v1/discounts/validate`	POST	Validate discount code

Parameter	Type	Description
`limit`	int	Results per page (default: 20, max: 100)
`offset`	int	Pagination offset
`category`	string	Filter by category slug
`in_stock`	boolean	Only show in-stock items
`min_price`	number	Minimum price filter
`max_price`	number	Maximum price filter

Capability	Code	Description	Status
Catalog	`dev.ucp.shopping.catalog`	Browse products	Active
Search	`dev.ucp.shopping.search`	Search products	Active
Checkout	`dev.ucp.shopping.checkout`	Create checkout sessions	Active
Discounts	`dev.ucp.shopping.discount`	Apply coupon codes	Active
Fulfillment	`dev.ucp.shopping.fulfillment`	Calculate shipping	Active

   Google AI Mode
 
Google AI Mode (powered by Gemini) uses UCP to enable shopping directly within AI conversations.
            With AI Merchant Pro v7.0, your store is ready for Google AI Mode from day one.
 Overview
 When users ask Google AI about products, it can:
  Discover your store via the /.well-known/ucp endpoint
 Browse your product catalog through the REST API
 Search for specific products
 Create checkout sessions
 Complete purchases with Google Pay
 
 All of this happens within the AI conversation - no need to visit your website.
 Setup Guide
     1 
  Enable UCP
   
Go to AI Merchant Pro → Settings → UCP,
                toggle "Enable UCP Protocol" to ON,
                and click Save Changes.
  
 
 
    2 
  Verify Discovery Endpoint
   
Visit https://yoursite.com/.well-known/ucp in your browser.
                Confirm you see a JSON response with your store information.
                Check that capabilities includes all expected values.
  
 
 
    3 
  Configure Payment Handlers
   
Go to AI Merchant Pro → Settings → Payment Handlers.
                Enable Google Pay for one-tap checkout,
                or rely on WooCommerce Gateways for redirect-based checkout.
  
 
 
    4 
  Test Your Setup
   
Go to AI Merchant Pro → UCP Validator.
                Click "Run Full Validation".
                Fix any issues marked as Critical.
  
 
 
   
  Google Pay Configuration
 For one-tap checkout in Google AI Mode, configure Google Pay:
 Prerequisites
  Stripe, Adyen, or Square for WooCommerce installed
 Google Pay enabled in your payment gateway
 Valid SSL certificate on your site
 
 Configuration Steps
  Go to AI Merchant Pro → Settings → Payment Handlers
 Enable "Google Pay"
 Enter your Google Pay Merchant ID
 Select Environment: TEST or PRODUCTION
 Configure Allowed Card Networks (Visa, Mastercard, American Express, Discover)
 Select Authentication Methods: PAN_ONLY and/or CRYPTOGRAM_3DS
 Click Save Changes
 
     Setting  Description  Recommended  
 
   Merchant ID  Your Google Pay merchant identifier  Required for production  
  Environment  TEST for development, PRODUCTION for live  Start with TEST  
  Card Networks  Which cards to accept  Enable all for best coverage  
  Auth Methods  How cards are authenticated  Enable both  
 
 
 
 WooCommerce Gateway Fallback
 If you don't configure Google Pay, AI agents will use redirect-based checkout:
  AI agent creates a checkout session
 Customer is redirected to your WooCommerce checkout page
 Customer completes payment using your standard gateways
 Order is created in WooCommerce
 
 Testing UCP
 Manual Testing
  Discovery: Visit /.well-known/ucp and verify response
 Products: Visit /wp-json/ucp/v1/products and check product data
 Search: Test /wp-json/ucp/v1/products/search?q=test
 Checkout: Use the UCP Validator's checkout tester
 
 Using the UCP Validator
  Go to AI Merchant Pro → UCP Validator
 Click "Run Full UCP Validation"
 The validator checks: Discovery endpoint accessibility, profile completeness, API endpoint responses, checkout flow functionality, and payment handler configuration
 
     Issue  Solution  
 
   Discovery returns 404  Flush permalinks (Settings → Permalinks → Save)  
  Missing capabilities  Ensure UCP is enabled in settings  
  Checkout fails  Check WooCommerce gateway configuration  
  Google Pay not working  Verify Merchant ID and environment settings  
 
 
 
 
   AI Agent Checkout
 
AI Merchant Pro enables AI agents (ChatGPT, Google Gemini, Claude, etc.) to create
            and complete purchases on behalf of customers directly within conversations.
 How It Works
  Customer asks AI: "I want to buy the blue widget"
 AI agent searches your catalog via API
 AI agent creates a checkout session
 Customer confirms and provides payment
 AI agent completes the purchase
 Order is created in WooCommerce
 
 The entire flow happens via API - no website visit required.
 Checkout Sessions
 Checkout sessions are temporary carts that AI agents create and manage.
 Session Lifecycle
     Status  Description  
 
   pending  Session created, awaiting completion  
  processing  Payment being processed  
  completed  Order created successfully  
  expired  Session timed out (default: 1 hour)  
  cancelled  Session cancelled by agent or customer  
 
 
 
     
   Session IDs 
   Checkout sessions use unique IDs prefixed with ucp_ (e.g., ucp_abc123def456). These are used to track and manage the checkout flow.
  
 
 
 
 Shipping Rates API
 AI agents request shipping rates after setting the delivery address:
 Request Example
  POST /wp-json/ucp/v1/shipping/rates 
 The shipping rates come from your WooCommerce shipping configuration and the Shipping Rules you've set up in AI Merchant Pro.
 Response Fields
  id - Shipping method identifier
 label - Display name (e.g., "Standard Shipping")
 cost - Shipping cost with currency
 delivery_estimate - Estimated delivery time
 
 Discount Validation
 AI agents can validate and apply discount codes:
  POST /wp-json/ucp/v1/discounts/validate 
 Response (Valid Code)
  valid: true
 type - percent or fixed_cart
 amount - Discount value
 new_totals - Updated cart totals
 
 Discount Settings
 Control how AI agents can use discounts in AI Merchant Pro → Settings → Discounts:
     Setting  Description  Default  
 
   Allow Coupons  Let AI agents apply WooCommerce coupons  Enabled  
  Show Available  Expose public coupons to AI agents  Disabled  
  Excluded Coupons  Specific codes blocked from AI use  None  
 
 
 
 Payment Handlers
 When completing checkout, AI agents specify a payment method:
 Google Pay (Native)
 For one-tap checkout within AI interfaces. Requires Google Pay Merchant ID and supported payment gateway.
 WooCommerce Gateway (Redirect)
 Returns a payment_url for the customer to complete payment on your checkout page.
 Available Payment Handlers
 All active WooCommerce payment gateways are automatically available:
  Stripe
 PayPal
 Square
 Bank Transfer (BACS)
 Cash on Delivery
 Any other active gateway
 
 Configure which gateways are exposed in AI Merchant Pro → Settings → Payment Handlers.
     
   Order Creation 
   Completed checkouts create standard WooCommerce orders visible in WooCommerce → Orders like any other order.
  
 
 
 
 
   UCP Analytics
 Track how AI agents interact with your store through the UCP Analytics dashboard.
 Enabling Request Logging
 To collect analytics data, enable request logging:
  Go to AI Merchant Pro → Settings → Security
 Toggle "Request Logging" to ON
 Click Save Changes
 
     
   Privacy Note 
   Logs are automatically purged after 30 days for privacy compliance.
  
 
 
 
 Available Metrics
 View analytics in AI Merchant Pro → Analytics:
     Metric  Description  
 
   API Calls  Total requests to all UCP endpoints  
  Profile Views  Discovery endpoint (/.well-known/ucp) hits  
  Product Views  Requests to product catalog endpoints  
  Searches  Product search queries  
  Checkouts  Checkout sessions created  
  Completed  Successfully completed purchases  
 
 
 
 Dashboard Overview
 The Analytics dashboard shows:
 Summary Cards
  Total API calls (last 30 days)
 Unique AI agents
 Conversion rate (checkouts → completed)
 Revenue from AI purchases
 
 30-Day Chart
 Visual graph showing daily API requests, checkout sessions, and completed orders.
 Top Queries
 Most common search queries from AI agents, helping you understand what customers are looking for.
 Agent Breakdown
 Which AI platforms are accessing your store:
  Google AI Mode / Gemini
 ChatGPT
 Other agents
 
 Exporting Analytics Data
  Go to AI Merchant Pro → Analytics
 Click "Export Data"
 Choose format: CSV or JSON
 Select date range
 Download file
 
 
   Security
 
Configure security settings for your UCP API to protect against abuse
            while allowing legitimate AI agent access.
 Rate Limiting
 Prevent API abuse by limiting requests per IP address.
 Configuration
  Go to AI Merchant Pro → Settings → Security
 Set "Rate Limit" (requests per minute per IP)
 Default: 60 requests/minute
 Click Save Changes
 
 Rate Limit Headers
 API responses include rate limit headers:
  X-RateLimit-Limit: 60
 X-RateLimit-Remaining: 45
 X-RateLimit-Reset: 1705410000
 
     
   When Limit Exceeded 
   Returns HTTP 429 Too Many Requests with a retry_after value in seconds.
  
 
 
 
 API Key Authentication
 Optionally require API keys for sensitive endpoints.
 Enabling API Keys
  Go to AI Merchant Pro → Settings → Security
 Toggle "API Key Required" to ON
 Click Generate API Key to create keys
 Distribute keys to authorized integrations
 
 Using API Keys
 Include the key in request headers:
  X-UCP-API-Key: your_api_key_here 
 Which Endpoints Require Keys
 When API Key Required is enabled:
     Endpoint Type  Requires Key  
 
   Discovery (/.well-known/ucp)  No  
  Profile (/profile)  No  
  Products (read)  No  
  Search  No  
  Checkout (create/update)  Yes  
  Shipping rates  Yes  
  Discount validation  Yes  
 
 
 
 Public endpoints remain accessible for AI agent discovery.
 Managing API Keys
 In AI Merchant Pro → Settings → API Keys:
  Generate new keys
 Revoke existing keys
 View key usage statistics
 Set key expiration dates
 
 Request Logging
 Log all API requests for debugging and analytics.
 What's Logged
     Field  Description  
 
   Timestamp  When request occurred  
  Endpoint  Which API endpoint was called  
  Method  GET, POST, PATCH, etc.  
  Status  HTTP response code  
  IP Address  Requester IP (anonymized after 24h)  
  User Agent  AI agent identifier  
  Duration  Response time in ms  
 
 
 
     
   Privacy 
   Logging does NOT store: customer personal information, payment details, or full request/response bodies. Disable logging at any time in Settings → Security.
  
 
 
 
 Security Best Practices
     Setting  Development  Production  
 
   Rate Limit  120/min  60/min  
  API Key Required  Off  Consider for high-traffic  
  Request Logging  On  On (for analytics)  
 
 
 
 Additional Recommendations
  Use HTTPS - Required for UCP (enforced)
 Keep WordPress updated - Security patches
 Monitor logs - Watch for unusual patterns
 Review API keys - Revoke unused keys regularly
 
 
   Advanced Features
 Variable Products
 
AI Merchant Pro fully supports WooCommerce variable products,
            exporting each variation as a separate item with its own attributes
            such as color, size, and material. Each variation appears in the feed
            with its own price, stock status, and images.
     
    
Use clear attribute names (Color, Size, Material) rather than
            abbreviations for better AI understanding and product discoverability.
 
 
 
 
 Video & 3D Models
 
Enhance your product listings with rich media content to improve
            engagement and conversions. AI Merchant Pro adds a dedicated
"AI Merchant Pro Media" panel to the WooCommerce
            product editor where you can easily add videos and 3D models.
     
   New in WooCommerce Editor 
  
When editing any product in WooCommerce, you'll find a new
"AI Merchant Pro Media" metabox in the product
            data section. Use this panel to add video URLs and 3D model files
            directly - no coding required!
 
 
 
 
 Adding Product Videos
 
In the AI Merchant Pro Media panel, you can add video URLs from:
  YouTube - Paste any YouTube video URL
 Vimeo - Paste any Vimeo video URL
 Self-hosted MP4 - Use your own video file URLs
 
 
Videos will be included in your JSON ACP feed and displayed to
            ChatGPT users when they browse your products.
 Adding 3D Models
 
For products that benefit from 3D visualization (furniture, jewelry,
            electronics, etc.), you can add 3D model files in the same panel:
  GLB/GLTF files - Standard 3D web format
 USDZ files - For Apple AR Quick Look
 
 
Simply upload your 3D files to your media library or enter the URL
            in the AI Merchant Pro Media panel. The 3D model URL will be
            included in your feed for AI platforms that support AR/3D viewing.
     
   Pro Tip 
  
3D models significantly increase product engagement. Consider
            adding them for your best-selling or high-value products first.
 
 
 
 
 Custom Field Mapping
 
If you use other plugins that store product data in custom fields
            (like GTIN plugins, brand plugins, etc.), AI Merchant Pro can
            automatically pull that data into your feeds.
 
Go to AI Merchant Pro → Field Mapping to configure
            which fields to use for:
  Brand - The manufacturer or brand name
 GTIN/EAN/UPC - Product barcodes for identification
 MPN - Manufacturer Part Number
 Condition - New, refurbished, or used
 Energy Rating - For appliances (A+++, A++, etc.)
 
 
The plugin automatically detects popular GTIN and brand plugins
            and uses their data. For custom setups, you can manually specify
            which fields to use in the Field Mapping settings.
 Performance Optimization
 
For stores with large catalogs, enable these performance features:
   Batch Processing
 Process products in chunks of 500 to prevent timeouts. Enable in Settings → Performance.
 
  Feed Caching
 Cache generated feeds for 1-24 hours. Reduces server load on repeated requests.
 
  Async Generation
 Generate feeds in background via WP-Cron. Prevents admin slowdowns.
 
  Selective Sync
 Only regenerate products that changed since last sync.
 
 
 Recommended Server Settings for Large Catalogs
     Setting  5K Products  25K Products  50K+ Products  
 
   memory_limit  256MB  512MB  1024MB  
  max_execution_time  120s  300s  600s  
  Batch Size  1000  500  250  
  Cache TTL  1 hour  6 hours  12 hours  
 
 
 
 
   Troubleshooting
   Feed URLs show 404 error  
  Solution: Flush your permalinks.
  Go to Settings → Permalinks
 Click "Save Changes" without making any changes
 Try accessing the feed URL again
 
 If the issue persists, ensure pretty permalinks are enabled (not "Plain").
 
 
   Some products are missing from the feed  
  Products may be excluded if they:
  Are out of stock (if configured to exclude)
 Are set to private or draft status
 Are in excluded categories
 Have validation errors preventing inclusion
 Have no price set
 
 Check your plugin settings and run the ACP Validator for details.
 
 
   Feed generation times out or crashes  
  For large catalogs:
  Enable Batch Processing in Settings → Performance
 Reduce batch size to 250-500 products
 Increase PHP memory_limit to 512MB+
 Increase max_execution_time to 300s+
 Enable Async Generation for background processing
 
 
 
   Images not appearing in feed  
  Check the following:
  Products have featured images set
 Image URLs are accessible (not protected)
 Your site uses HTTPS (required for images)
 Images are at least 100x100 pixels
 
 Test image URLs directly in browser to verify accessibility.
 
 
   License activation fails  
  Common causes and solutions:
  Invalid key: Copy the full key from shop.aimerchantpro.com without extra spaces
 Domain limit: Deactivate from previous domain first
 Firewall: Whitelist our license server (license.aimerchantpro.com)
 SSL issue: Ensure your site has a valid SSL certificate
 
 Contact support with your purchase code if issues persist.
 
 
   Google Merchant disapprovals  
  Run the ACP validation to identify issues:
  Missing identifiers: Add GTIN, MPN, or brand
 Invalid images: Use high-resolution, non-watermarked images
 Price mismatch: Ensure feed price matches landing page
 Incorrect categories: Map to Google's taxonomy
 
 Review Google's product data specification for detailed requirements.
 
 
     
   Enable Debug Mode 
   
For detailed troubleshooting, enable debug mode in
AI Merchant Pro → Settings → Advanced → Debug Mode.
              This logs feed generation details to wp-content/debug.log.
  
 
 
 
 
   Frequently Asked Questions
   What is UCP and do I need it?  
  
UCP (Universal Commerce Protocol) is an open standard developed by Google
                for AI commerce. It enables AI assistants like Google Gemini to browse your
                products and complete purchases directly in conversations.
 
If you want your products discoverable in Google AI Mode, you need UCP.
                AI Merchant Pro v7.0 includes full UCP support - just enable it in settings.
 
 
   How do I enable Google AI Mode support?  
   Update to AI Merchant Pro v7.0 or later
 Go to AI Merchant Pro → Settings → UCP
 Toggle "Enable UCP Protocol" to ON
 Save changes
 
 
Your store is now discoverable by Google AI Mode. The discovery endpoint
                at /.well-known/ucp is created automatically.
 
 
   Do customers need to visit my website to purchase?  
  
With UCP enabled, customers can complete purchases entirely within AI
                conversations (like Google Gemini). They don't need to visit your website
                unless they choose a redirect-based payment method.
 
For the smoothest experience, configure Google Pay to enable one-tap
                checkout within the AI interface.
 
 
   Is UCP secure?  
  Yes. UCP includes multiple security layers:
  HTTPS required for all endpoints
 Optional API key authentication
 Rate limiting to prevent abuse
 Request logging for monitoring
 Google Pay uses tokenized payments
 
 
Your customer data and payment information are protected by the same
                security standards as regular WooCommerce transactions.
 
 
   What AI platforms support UCP?  
  Currently:
  Google AI Mode / Gemini - Full UCP support
 ChatGPT - Uses ACP feeds (separate from UCP)
 Other AI agents - Can use UCP REST API
 
 UCP is an open standard, so more platforms are expected to adopt it.
 
 
   How often should I regenerate my feed?  
  
For most stores, daily regeneration is sufficient. If you have
                frequent inventory changes, consider enabling real-time sync
                or scheduling updates every 4-6 hours. Google typically crawls
                feeds once daily, while ChatGPT may crawl more frequently.
 
 
   Can I use this with other feed plugins?  
  
Yes! AI Merchant Pro works alongside other feed plugins. Our feeds
                use unique URLs (?feed=googlemerchant and ?feed=chatgpt_json)
                that won't conflict with other plugins.
 
 
   Does it work with multi-language sites (WPML/Polylang)?  
  
Yes, full compatibility with WPML and Polylang. Generate separate
                feeds per language by appending the language parameter:
  ?feed=chatgpt_json&lang=en
 ?feed=chatgpt_json&lang=es
 ?feed=chatgpt_json&lang=fr
 
 
 
   How do I exclude specific products or categories?  
  Two methods available:
   Category exclusion: Go to AI Merchant Pro → Settings →
                  Categories and uncheck categories to exclude.
  Product-level: Edit individual products and check
                  "Exclude from AI Merchant feeds" in the product data panel.
 
 
 
   What's the difference between Pro and Agency licenses?  
      Feature  Pro  Agency  
 
   Sites  1 site  Unlimited  
  Direct Push  -  Included  
  White Label  -  Included  
  Priority Support  Email  Email + Live Chat  
 
 
 
 
 
   Is my data sent to external servers?  
  
Your product data stays on your server. The plugin only communicates externally for:
  License verification (your domain name only)
 Direct Push (if enabled, sends product data to OpenAI)
 Update checks (plugin version only)
 
 Feed URLs are public by design, as Google and ChatGPT need to crawl them.
 
 
 
   Changelog
    7.0.0 January 14, 2026 Major Release 
  Universal Commerce Protocol (UCP) v7.0
  Added Full UCP v7.0 specification support for Google AI Mode compatibility 
  Added Discovery endpoint (/.well-known/ucp) for automatic AI agent discovery 
  Added OpenAPI 3.1 specification (/wp-json/ucp/v1/openapi.json) 
  Added Complete REST API with 12 endpoints for AI commerce 
  Added Checkout sessions - AI agents can create and complete purchases 
  Added Shipping rates API - Real-time shipping calculations 
  Added Discount validation API - Coupon validation for AI agents 
  Added Google Pay integration for one-tap checkout 
  Added UCP Analytics dashboard with API tracking 
  Added Rate limiting and API key authentication 
  Added Request logging with auto-purge (30 days) 
  Improved Admin UI with capabilities cards and status indicators 
 
 
   6.2.2 December 9, 2025 
   Added Direct Push support for ChatGPT Shopping API 
  Added 3D model (GLB/GLTF) support in feeds 
  Improved Feed generation speed by 40% for large catalogs 
  Fixed Variable product price inheritance issue 
 
 
   6.2.1 November 15, 2025 
   Added Support for WooCommerce 8.3+ 
  Improved ACP Validator with new severity levels 
  Fixed Currency conversion for multi-currency stores 
  Fixed Memory leak in batch processing mode 
 
 
   6.2.0 October 20, 2025 
   Added Visual Shipping Rules Builder 
  Added Feed statistics dashboard with 30-day history 
  Added Video URL extraction from product galleries 
  Improved WPML/Polylang compatibility for multi-language feeds 
 
 
   6.1.0 September 5, 2025 
   Added ACP (AI Commerce Protocol) JSON feed format 
  Added ChatGPT Shopping submission workflow 
  Improved PHP 8.2 compatibility 
 
 
 
  View full changelog →

Setting	Description	Recommended
Merchant ID	Your Google Pay merchant identifier	Required for production
Environment	TEST for development, PRODUCTION for live	Start with TEST
Card Networks	Which cards to accept	Enable all for best coverage
Auth Methods	How cards are authenticated	Enable both

Issue	Solution
Discovery returns 404	Flush permalinks (Settings → Permalinks → Save)
Missing capabilities	Ensure UCP is enabled in settings
Checkout fails	Check WooCommerce gateway configuration
Google Pay not working	Verify Merchant ID and environment settings

Status	Description
`pending`	Session created, awaiting completion
`processing`	Payment being processed
`completed`	Order created successfully
`expired`	Session timed out (default: 1 hour)
`cancelled`	Session cancelled by agent or customer

Setting	Description	Default
Allow Coupons	Let AI agents apply WooCommerce coupons	Enabled
Show Available	Expose public coupons to AI agents	Disabled
Excluded Coupons	Specific codes blocked from AI use	None

Metric	Description
API Calls	Total requests to all UCP endpoints
Profile Views	Discovery endpoint (`/.well-known/ucp`) hits
Product Views	Requests to product catalog endpoints
Searches	Product search queries
Checkouts	Checkout sessions created
Completed	Successfully completed purchases

Endpoint Type	Requires Key
Discovery (`/.well-known/ucp`)	No
Profile (`/profile`)	No
Products (read)	No
Search	No
Checkout (create/update)	Yes
Shipping rates	Yes
Discount validation	Yes

Field	Description
Timestamp	When request occurred
Endpoint	Which API endpoint was called
Method	GET, POST, PATCH, etc.
Status	HTTP response code
IP Address	Requester IP (anonymized after 24h)
User Agent	AI agent identifier
Duration	Response time in ms

Setting	Development	Production
Rate Limit	120/min	60/min
API Key Required	Off	Consider for high-traffic
Request Logging	On	On (for analytics)

Setting	5K Products	25K Products	50K+ Products
memory_limit	256MB	512MB	1024MB
max_execution_time	120s	300s	600s
Batch Size	1000	500	250
Cache TTL	1 hour	6 hours	12 hours

Feature	Pro	Agency
Sites	1 site	Unlimited
Direct Push	-	Included
White Label	-	Included
Priority Support	Email	Email + Live Chat