AI Hub and your commercetools setup

AI Hub Add-On
Ask about this Page
Copy for LLM
View as Markdown

Understand how AI Hub reuses your existing commercetools Project setup for discovery and checkout.

AI Hub does not introduce a separate commerce system. It connects AI providers and checkout protocols to the same commercetools APIs your storefront already uses.

What you need in your Project

AI Hub relies on the following commercetools resources and settings:

  • Product data from Products and Product Variants
  • A dedicated Store for each agentic channel context
  • Optional Product Selections assigned to a Store to scope the available assortment
  • Optional Product Tailoring in the Store context for tailored titles, descriptions, images, and attributes
  • Optional Distribution Channels and Supply Channels assigned to the Store for price and inventory resolution
  • Shipping Methods that are available for the Store context
  • Pricing, tax, and promotion logic applied during Cart and Order processing
  • Order lifecycle management after checkout completion

The same APIs remain the source of truth. AI Hub adds channel integrations on top of them.

For the rationale behind dedicated Stores, Product Selections, Product Tailoring, Distribution Channels, Supply Channels, and Shipping Methods, see:

Learn more about how to prepare your Project for agentic commerce in the self-paced Prepare your Project for agentic commerce standalone learning module.

Discovery flow and catalog exposure

During discovery, AI Hub prepares and publishes catalog data to provider-specific formats.

In most implementations, the flow follows these steps:

  1. Create a Store that represents the agentic channel context.
  2. Assign Product Selections to that Store to scope the available assortment.
  3. Use Product Tailoring in that Store when the channel needs tailored Product data.
  4. Publish price and availability from the Store context using the configured Distribution Channels, Supply Channels, and Inventory data.
  5. Map Product and Product Variant fields to provider-specific feed attributes.
  6. AI Hub keeps updates in sync through scheduled jobs, event-driven updates, or both, depending on the integration.

For detailed setup guidance, see:

Checkout flow and protocol behavior

During checkout, AI Hub receives protocol requests from an AI channel and translates them to commercetools API operations.

For protocols such as the Universal Commerce Protocol (UCP) and other channel-specific flows, the flow generally includes:

  1. Create or update a Cart from buyer and Line Item input.
  2. Resolve shipping details and recalculate totals.
  3. Authorize payment through the configured Payment Service Provider.
  4. Create an Order in commercetools after successful authorization.
  5. Send Order lifecycle updates back to the AI channel when required.

All validations continue to come from your existing configuration, such as inventory constraints, pricing rules, and promotion applicability.

For the rationale behind checkout sequencing, extension points, and payment authorization flows, see:

Key setup decisions for merchants

To avoid configuration issues, agree on these decisions before launch:

  • Which Store keys represent each AI channel entry point.
  • Whether Product Selections should be assigned to each Store.
  • Which Products need Store-specific Product Tailoring, if you use Product Tailoring.
  • Which Distribution and Supply Channels should be used for pricing and availability.
  • Which Shipping Methods should be associated with each Store context.
  • Which locales, currencies, and countries are used for feed and checkout contexts.
  • Which API Client scopes are required for discovery and checkout components.
Before production rollout, validate your configuration and test flows using the Production readiness checklist.

What AI Hub does not do

  • AI Hub does not replace your existing commerce logic.
  • AI Hub does not maintain a separate source of truth for inventory.
  • AI Hub does not bypass Store and Product Selection constraints.