CartAI FAQ: Getting started

API access, the CartAI portal, authentication, testing, and going live.

What does the CartAI API do?

The API has four products. Catalog searches products and returns variants, stock, and totals. Checkout places the order on the merchant’s own site. Payments collects a card on a secure hosted page and passes a payment session into checkout. Monetization preserves attribution so your platform earns commission on purchases. The API base URL is https://api.cartai.ai.

What does the CartAI portal do?

The portal is where you generate and revoke API keys, configure webhooks, and request to go live. Sign in at https://portal.cartai.ai/login. API keys are under API Keys in the left sidebar. Webhook endpoints are under Webhooks. When you finish testing, use the Request Go Live button in the dashboard. CartAI reviews the request and enables production features for your account.

How do I get a CartAI API key?

Create an account at https://portal.cartai.ai/signup, open API Keys, and click Generate New Key. Store the key in an environment variable or a secrets manager. If a key is compromised, revoke it in the portal and generate a new one.

How do I authenticate to the CartAI API?

Send your API key in the X-API-Key header on every request. Call the API from your backend only. Never put the key in client-side code or source control. A missing or invalid key returns 401 Unauthorized. A valid key without permission for the endpoint returns 403 Forbidden.

How do I make my first API call?

Generate an API key and call POST /product/search from your backend. To try a full order, run a test checkout with the payment provider set to test and the test card from the Getting Started guide at https://docs.cartai.ai/reference/getting-started-with-ease.

Is there a sandbox environment?

CartAI uses one environment for testing and production, at https://api.cartai.ai. New accounts start in testing mode, where you use the test payment provider and the test card. Do not use real card details in testing mode. Request go live from the portal when you are ready for production. The test provider is disabled on production keys.

Can I use CartAI through MCP?

Yes. CartAI publishes an open source MCP server under Apache 2.0. It works with Claude Desktop, Claude Code, Cursor, and VS Code.

Is Hosted Cart available?

Yes. Hosted Cart is available today for platforms that use the CartAI Catalog. It is a hosted shopping and checkout experience that covers product selection, variants, address, payment, and confirmation. Talk to Sales to set it up.

© 2026 CartAI · All rights reserved.