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

# WooCommerce bridge

> Have the agent search your catalog and drive the visitor to checkout

The WooCommerce bridge lets the agent search the tenant's catalog, surface product cards in the chat, and drive the visitor to the **native WooCommerce checkout**. The agent never owns the cart or processes payment — it just fills the cart and hands off.

## How it works

1. The agent calls `wc_search_products` (filterable by category, tag, price range, in-stock flag) to surface candidates.
2. After the visitor confirms intent, the agent calls `wc_add_to_cart` with the product variation + quantity.
3. The agent returns a CTA to `https://your-site.com/checkout` — the visitor completes payment on the standard WooCommerce checkout (Stripe, PayPal, Klarna — whatever the tenant has configured).

## Why checkout stays native

|                      | Animam-owned cart | WooCommerce bridge                        |
| -------------------- | ----------------- | ----------------------------------------- |
| Coupon engine        | re-implement      | ✅ runs your existing coupons              |
| Tax / shipping       | re-implement      | ✅ runs your existing tax + shipping rules |
| Payment gateways     | re-implement      | ✅ Stripe / PayPal / Klarna / etc. as-is   |
| Refund / fulfillment | re-implement      | ✅ standard WooCommerce admin              |
| Reporting            | parallel store    | ✅ standard WC reports + Analytics         |
| Migration risk       | high              | zero                                      |

## Recommended pairing

For agent-driven purchases that the visitor finalizes outside the chat, the bridge is enough. For agent-initiated checkouts (e.g. one-click upsell during a conversation), pair the bridge with the [`COLLECT_PAYMENT`](/guides/tools#collect-payment) tool backed by Stripe Connect — the agent generates a Checkout Session, the visitor pays, the order lands in WooCommerce via webhook.

## Plan

Bridges require the **Bundle** plan (`mcp_tools` capability). See [WordPress pricing](https://animam.ai/wordpress#plans).