> ## Documentation Index
> Fetch the complete documentation index at: https://learn.orbexa.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ORBEXA WooCommerce integration guide

> ORBEXA WooCommerce integration — plugin installation, API connection, three-way product/order/inventory sync, and Webhook configuration.

# WooCommerce Integration

## Overview

WooCommerce integration is implemented through REST APIs, providing complete three-way synchronization of products, orders, and inventory. Unlike Shopify's OAuth authorization, WooCommerce requires the merchant to provide API keys to establish a connection.

## API Endpoints

ORBEXA provides the following endpoints for WooCommerce integration:

### Connection Management

| Endpoint                                | Method | Function                               |
| --------------------------------------- | ------ | -------------------------------------- |
| `/api/integrations/woocommerce/connect` | POST   | Connect a WooCommerce store            |
| `/api/integrations/woocommerce/test`    | POST   | Test whether the connection is working |

### Data Sync

| Endpoint                                       | Method | Function            |
| ---------------------------------------------- | ------ | ------------------- |
| `/api/integrations/woocommerce/sync/products`  | POST   | Sync product data   |
| `/api/integrations/woocommerce/sync/orders`    | POST   | Sync order data     |
| `/api/integrations/woocommerce/sync/inventory` | POST   | Sync inventory data |

### Webhook Management

| Endpoint                                        | Method | Function               |
| ----------------------------------------------- | ------ | ---------------------- |
| `/api/integrations/woocommerce/webhooks/setup`  | POST   | Register Webhooks      |
| `/api/integrations/woocommerce/webhooks/handle` | POST   | Receive Webhook events |

## Connection Flow

### Step 1: Generate WooCommerce API Keys

The merchant creates API keys in the WooCommerce admin panel (Settings -- Advanced -- REST API) to obtain a Consumer Key and Consumer Secret.

### Step 2: Connect the Store

Submit the following via the `/api/integrations/woocommerce/connect` endpoint:

* WooCommerce store URL
* Consumer Key
* Consumer Secret

### Step 3: Test the Connection

Call the `/api/integrations/woocommerce/test` endpoint to verify the connection is successful. ORBEXA will attempt to access the WooCommerce REST API to confirm the credentials are valid.

### Step 4: Sync Data

After a successful connection, call the three sync endpoints to pull product, order, and inventory data respectively.

## Three-Way Sync

### Product Sync

* Pulls all product data from WooCommerce
* Includes name, description, price, images, variants, and categories
* Enters the AI Refinery Pipeline for automatic cleaning
* Synced to all protocol endpoints

### Order Sync

* Syncs WooCommerce orders to ORBEXA
* Supports ACP `commerce.order_status` queries
* Order status changes are reflected in real time

### Inventory Sync

* Syncs inventory quantities in real time
* Inventory queries across UCP/ACP/MCP endpoints always reflect the latest state
* AI agents receive accurate information when inventory is low

## Webhook Configuration

Use the `/api/integrations/woocommerce/webhooks/setup` endpoint to register all Webhooks with a single call. Once registered, WooCommerce automatically notifies ORBEXA when the following events occur:

* Product created/updated/deleted
* Order created/updated
* Inventory changes

All Webhook events are processed through the unified `/api/integrations/woocommerce/webhooks/handle` endpoint.

## Platform-Side Rate Limiting

ORBEXA limits calls to the WooCommerce API to **5 requests/second**, ensuring it does not exceed the WooCommerce server's capacity. This is a platform-side rate limit and does not affect AI agent access to ORBEXA endpoints.

## Comparison with Shopify Integration

| Feature              | Shopify                  | WooCommerce                   |
| -------------------- | ------------------------ | ----------------------------- |
| Authorization method | Automatic OAuth          | Manual API key configuration  |
| Initial setup        | Zero code                | Requires generating API keys  |
| Webhooks             | Automatically registered | Registered via setup endpoint |
| Platform rate limit  | 2 req/s                  | 5 req/s                       |
| Data sync            | Auto-triggered           | Manual or Webhook-triggered   |

## Summary

WooCommerce integration provides complete three-way product/order/inventory sync, with 7 API endpoints covering the full flow of connection, synchronization, and Webhooks. Once configured, data flows automatically into ORBEXA's protocol endpoint stack.

***

Next chapter: [WordPress Plugin Integration](/en/book-7/ch4-wordpress) -- One-click connection, automatic merchant account and API key creation