​

Agentic Commerce Protocol (ACP)

​

How ACP Works

User (chat/voice) → AI Agent → ACP Handler → Order Created
                        │                         │
                        ├── Collects intent        ├── Validates order
                        ├── Confirms items         ├── Authorizes payment
                        └── Gets authorization     └── Syncs to commerce platform

1. Agent collects intent — The AI agent gathers order details and payment authorization through natural conversation.
2. ACP handler validates — The handler validates the order against your catalog, pricing rules, and inventory.
3. Payment authorized — Scoped payment authorization ensures the agent can only charge approved amounts.
4. Order created — The order is created in your commerce platform via the Sync Server.

​

Key Concepts

​

Why This Design

• Deterministic checkout — Orders are validated server-side, never by the LLM.
• Scoped payments — Agents can only charge amounts the customer explicitly authorizes.
• Auditable — Every step is logged with full traceability.
• Platform-agnostic — Works with any commerce backend through bindings.

​

When to Use ACP

• Conversational checkout — Let customers buy through chat or voice interfaces.
• Delegated payments — Authorize agents to make purchases on behalf of users with spending limits.
• Unified agent workflows — Single protocol for multiple AI assistants (ChatGPT, custom agents, voice bots).
• B2B ordering — Streamline wholesale and recurring orders through conversational interfaces.

​

Quickstart

import { ACPHandler } from '@stateset/acp';

const handler = new ACPHandler({
  apiKey: process.env.STATESET_API_KEY,
  catalogBinding: 'shopify',
  paymentBinding: 'stripe',
});

// Process an agent's checkout request
const order = await handler.processCheckout({
  items: [
    { sku: 'WIDGET-001', quantity: 2 },
    { sku: 'GADGET-005', quantity: 1 },
  ],
  payment: {
    method: 'authorized_token',
    token: 'pay_auth_abc123',
  },
  shipping: {
    address: '123 Main St, New York, NY 10001',
    method: 'standard',
  },
});

​

Further Reading

• ACP Overview
• ACP Quickstart
• ACP Endpoints
• ACP Async Processing
• ACP Routing
• ACP Schemas
• Agentic Commerce Checkout Guide