Agents API Overview

The Agents API enables autonomous agents to interact with Walta Checkout.
Agents can search for products, manage their cart, create sessions for authentication, and securely complete purchases.

Endpoints Overview

Endpoint	Description
`/agents/browse`	Browse products across all merchants globally without domain restrictions.
`/{domain}/agents/cart`	Add, update, and remove products from the agent’s cart.
`/{domain}/agents/checkout`	Complete purchases using Stripe-based payment flow.
`/{domain}/agents/session`	Create and manage short-lived session keys for agent authentication.

Key Concepts

Domain-independent browsing – /agent/browse allows searching products from all stores.
Session authentication – Agents must create a session key to interact with domain-specific routes.
Scoped security – Every action is tied to the agent identity and logged for auditing.
Seamless checkout – Payments are processed securely via Stripe with tokenized credentials.

Example Flow

Create a session using /{domain}/agents/session/create with your X-User-Key.
Browse products globally or per domain using /agents/browse.
Add products to your cart with /{domain}/agents/cart/add.
Pay securely using /{domain}/agents/checkout/pay.

Start with Browse