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

# Agentic Discovery Studio

> Let ChatGPT, Claude and other AI assistants recommend your products, with checkout on HitPay

**Agentic Discovery Studio** makes your products readable by AI shopping assistants such as ChatGPT, Claude, Gemini and Perplexity. You paste your store's website, and the Studio reads your products, gives each one a HitPay checkout, and publishes them where assistants look. When a shopper buys, they pay on HitPay's checkout and the money lands in your HitPay account.

The Studio is free for HitPay merchants. You pay HitPay's usual fees only when a shopper pays.

> [!NOTE]
>
> Inside the app, Agentic Discovery Studio is called **AI Commerce by HitPay**. They're the same thing.

![A shopper asks an AI assistant for a gift box, gets a product recommendation, and pays on a HitPay checkout](https://mintcdn.com/hitpay/9kZjX1ymZGpu0gbT/images/labs/agentic-discovery-hero.png?fit=max\&auto=format\&n=9kZjX1ymZGpu0gbT\&q=85\&s=147d5b21a44aa63d0351549d958fe964)

## Before you begin

You need:

* A **verified** HitPay account. If your business verification isn't complete, the Studio won't let you log in. If you don't have an account yet, [create one](https://docs.hitpayapp.com/setup/account-creation.md).
* Somewhere your products are listed. Either:
  * your own website, on Shopify, WooCommerce, Wix or a custom site, or
  * a HitPay Online Store with published products.

You don't need to install anything or change your website.

## Set up the Studio

**1. Open the Studio**

In your HitPay dashboard, go to **Labs** in the sidebar and click **Agentic Discovery Studio**. You can also go straight to [ai-commerce.hitpay.dev](https://ai-commerce.hitpay.dev).

**2. Log in with HitPay**

Click **Log in with HitPay** and approve access on HitPay's own screen. The Studio never sees your password and you never paste an API key.

**3. Add your website**

Paste your store's website and click **Make my store AI-ready**. The Studio reads every product, price and photo, and gives each product a HitPay checkout.

Keep the page open while it works. Large catalogues can take a few minutes, and products already done are kept if anything stops.

> [!TIP]
>
> No website? Click **Use my HitPay online store instead** to make the published products on your HitPay Online Store AI-readable.

**4. Check your products**

Open **Products** and look at the **Needs a fix** filter. Fix anything listed there so assistants have what they need to recommend each product. See [Manage what AI reads](#manage-what-ai-reads).

**5. Share your AI link**

On **Overview**, copy **Your store's AI link** and share it with your customers. See [Share your store with shoppers](#share-your-store-with-shoppers).

Once your products are in, **Overview** shows how many are live, how many are ready for AI, and how many visits and orders have come from assistants.

![The Overview page of Agentic Discovery Studio, showing products live, visits and orders from AI, the store's AI link, and where AI can find the store](https://mintcdn.com/hitpay/9kZjX1ymZGpu0gbT/images/labs/agentic-discovery-overview.png?fit=max\&auto=format\&n=9kZjX1ymZGpu0gbT\&q=85\&s=1afc6a6e769a99d6ba8b36f8cd94f0e3)

## How shoppers find you

There are three ways in, and they all end at the same HitPay checkout.

| Way in | How it works |
| - | - |
| **Your own AI link** | Customers add your link to their assistant once, then shop your store by chatting. |
| **HitPay Global Catalog** | One AI connection to the products of every listed HitPay store, so shoppers who have never heard of you can find you. |
| **Product feeds** | ChatGPT shopping, Google and AI crawlers read your catalogue as feeds that the Studio keeps up to date. |

The **Where AI can find you** section of **Overview** shows the status of each place.

> [!NOTE]
>
> Being readable by AI assistants doesn't guarantee that your products appear inside ChatGPT's or Google's own shopping results. Those platforms decide what they show.

### How shoppers add your AI link

Your customers add the AI link to their assistant once:

> [tab] Claude
>
> 1. Open Claude and go to **Settings** > **Connectors**.
> 2. Choose **Add custom connector**.
> 3. Give it a name and paste the AI link.
> 4. Start a new chat and ask for what they want.

> [tab] ChatGPT
>
> 1. Open ChatGPT and go to **Settings** > **Apps & Connectors**.
> 2. Under **Advanced**, turn on **Developer mode**.
> 3. Choose **Create**, give it a name and paste the AI link.
> 4. In a new chat, pick it from the tools menu and ask.
>
> This needs a ChatGPT plan that allows custom connectors.

> [tab] Other assistants
>
> Any app that supports remote MCP servers over HTTP works the same way: add a new server and paste the AI link.

The assistant can then search your products, compare them and create a HitPay checkout link for the one the shopper chooses.

## How you get paid

Shoppers pay on a HitPay checkout page with the payment methods turned on for your HitPay account. The assistant never sees their card.

Orders from AI are ordinary HitPay orders. You find them, and ship them, from your HitPay dashboard.

> [!WARNING]
>
> If your products come from your own website, orders from AI **don't** appear in Shopify, WooCommerce or Wix, and they don't change the stock on your website. Fulfil them from your HitPay dashboard and update your website's stock after you ship.

## Manage what AI reads

The **Products** page shows what assistants read about each product. Use the filters to find products that need attention:

![The Products page, filtered to products that need a fix, with the Fix for AI panel open for one product](https://mintcdn.com/hitpay/9kZjX1ymZGpu0gbT/images/labs/agentic-discovery-products.png?fit=max\&auto=format\&n=9kZjX1ymZGpu0gbT\&q=85\&s=a0009b98d7c387133667f8ed3e79aa4e)

| Filter | What it shows |
| - | - |
| **Needs a fix** | Products missing something assistants need. |
| **Hidden from AI** | Products you've chosen not to show. |
| **Held by HitPay** | Products that are being checked, or that HitPay's Acceptable Use Policy doesn't allow. |
| **Fixed by you** | Products where you've changed what AI reads. |

### Fix a product

A product needs a fix when it has:

* **No price.** Assistants can't sell it and send shoppers to your website to ask.
* **A short or missing description.** Assistants see only the name and price, so they rarely recommend it.
* **A short name.** A name that says what the product is, such as "Teak Side Table, 50 cm", is what assistants match a shopper's question against.
* **No category.** Shoppers often ask for a kind of thing, such as "outdoor tables". A category puts the product in those answers.
* **No photo.**

Select the product, edit its name, description or category, and save. Assistants read the new version within a minute, and your fix stays in place when your website is read again.

Your fixes change only what AI reads. Your website and your HitPay checkout page stay as they are. Price and photo always come from your website: change them there, then click **Update now** on **Overview**.

### Hide a product from AI

To keep a product away from assistants, for example packaging or an add-on, select it and turn off **Show to AI assistants**. It's removed from your AI link, the feeds, the HitPay Global Catalog and the store directory. It stays on your website and in HitPay.

### Products held by HitPay

Every product is checked against HitPay's Acceptable Use Policy before it's shown to assistants. A product marked **Being checked** usually clears within the hour. A product marked **Held** isn't shown to assistants and gets no HitPay checkout. If you think a product was held by mistake, contact [support@hit-pay.com](mailto:support@hit-pay.com).

## Keep your catalogue up to date

The Studio reads your website again once a day, so assistants see your latest prices, stock and new products. To update sooner, click **Update now** on **Overview**.

To turn the daily update off, go to **Share & settings** and switch off **Update from my website every day**. Your products then change only when you click **Update now**.

> [!NOTE]
>
> Assistants see the prices and stock from your last update. If something sells out on your website between updates, it can still be bought on HitPay until the next update.

## Track results

### AI insights

**AI insights** shows what assistants asked your store and what happened next: searches, product views, checkout links, shoppers at checkout and paid orders. You can also see which assistants asked and how shoppers reached checkout.

![The AI insights page, showing the funnel from searches to paid orders, which assistants asked, and the top searches](https://mintcdn.com/hitpay/9kZjX1ymZGpu0gbT/images/labs/agentic-discovery-ai-insights.png?fit=max\&auto=format\&n=9kZjX1ymZGpu0gbT\&q=85\&s=f648bd6feac230f286d7119e12c7d6d0)

Two lists tell you what shoppers are looking for:

* **Top searches**: what assistants asked your store most often, and how many products each search found.
* **Searches that found nothing**: questions your catalogue had no answer for. Mention these words in your product descriptions, or consider stocking the items.

### Orders from AI

**Orders from AI** lists each HitPay payment that started from an AI assistant, with what was bought, where the shopper came from and the HitPay payment.

![The Orders from AI page, showing sales from AI, visits that paid, and a list of recent orders with the assistant each came from](https://mintcdn.com/hitpay/9kZjX1ymZGpu0gbT/images/labs/agentic-discovery-orders-from-ai.png?fit=max\&auto=format\&n=9kZjX1ymZGpu0gbT\&q=85\&s=259822d8ac9dbb838a6d6e2198af1a7d)

An order counts as from AI when the shopper reached the HitPay checkout from an assistant, the HitPay Global Catalog or an AI feed. A shopper who opens your HitPay page some other way still pays you as normal, but the order isn't counted here.

## Share your store with shoppers

**Share & settings** gives you ready-made ways to tell customers they can shop with their assistant:

* **Your AI link**, to send to customers directly.
* **Your shoppers' page**, with setup steps for each assistant.
* **A social post**, ready to copy.
* **A website link**, as a button you can paste into your site.
* **A QR code**, for your counter, packaging and receipts. It opens your shoppers' page.

![The Share and settings page, showing the store's AI link, UCP links, and a share kit with a social post, website link and QR code](https://mintcdn.com/hitpay/9kZjX1ymZGpu0gbT/images/labs/agentic-discovery-share.png?fit=max\&auto=format\&n=9kZjX1ymZGpu0gbT\&q=85\&s=ddcbce710a7a6fe6f875dd4098ab1844)

## Settings

The settings are further down the **Share & settings** page.

![Settings for daily updates, listing in the HitPay Global Catalog, letting assistants build a cart, the order permission key, and removing the store](https://mintcdn.com/hitpay/9kZjX1ymZGpu0gbT/images/labs/agentic-discovery-settings.png?fit=max\&auto=format\&n=9kZjX1ymZGpu0gbT\&q=85\&s=1502d1b973111cc47ce9b17b438fa94f)

| Setting | What it does |
| - | - |
| **Update from my website every day** | Reads your website again once a day. On by default. |
| **List my store in the HitPay Global Catalog** | Lists your products in the HitPay Global Catalog and shows your store in the store directory. Only your store name, country, main category, number of products, lowest price and AI link are shown, never your sales or customers. |
| **Let assistants build a cart** | Lets any shopper's assistant put several of your products in one HitPay checkout, up to the largest order amount you set. When it's off, single-product checkout links still work. |
| **Order permission key** | Lets an assistant you trust build a cart of any size, even with the setting above off. Treat it like a password. If you get a new key, assistants using the old one can no longer place orders. |
| **Remove this store** | Stops AI shoppers finding your store and deletes what the Studio holds for it. Your products and orders stay in HitPay. |

## For developers

You never need these to use the Studio. On **Overview**, open **Advanced, for developers** to find:

* The store's **MCP endpoint**, which is the same as the AI link. Its discovery tools are public and read-only.
* Feeds for the **Agentic Commerce Protocol (ACP)**, the **Universal Commerce Protocol (UCP)** and Google Merchant Center.
* A **schema.org snippet** to paste into your own product pages so AI crawlers can read your website directly.

## Troubleshooting

> [accordion] "Your HitPay account isn't verified yet"
>
> The Studio is only open to verified HitPay businesses. Finish your business verification in your HitPay dashboard, then log in again. If your account loses its verification later, your store is paused and your products aren't shown to assistants until you're verified again.

> [accordion] "We couldn't read your site directly"
>
> Your website had no product data the Studio could read, so it searched the web for your products instead. Prices may be wrong and some products may be missing. Paste the page that lists your products, such as your Shop, Menu or Products page, and run the update again. Check your products before you share your AI link.
>
> The daily update isn't available for your store until the Studio can read your website directly.

> [accordion] The HitPay connection was revoked or expired
>
> Your products stay live, but updates and orders are paused. Click **Reconnect with HitPay** and log in again.

> [accordion] The daily update didn't finish
>
> The Studio tries again the next day. To update straight away, click **Update now** on **Overview**.

> [accordion] Some products didn't make it into HitPay
>
> Click **Update now** on **Overview** to try again.

> [accordion] I have no orders from AI yet
>
> That's normal for a new store. Your shop is live to assistants, and orders appear in **Orders from AI** automatically when a shopper pays. Share your AI link with your customers to get started.

Need help? Contact [support@hit-pay.com](mailto:support@hit-pay.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.