StateSet API Docs

StateSet Deploy builds the ACP handler from its repo and runs it on managed Kubernetes — TLS, health checks, and autoscaling included.

1 — Add a deploy button

[![Deploy to Stateset](https://deploy.stateset.com/button.svg)](https://deploy.stateset.com/deploy?repo=stateset/stateset-acp-handler)

2 — Add `stateset.yaml`

Optional but recommended — it makes the deployment reproducible instead of click-configured:

name: stateset-acp-handler
description: ACP handler service

build:
  dockerfile: Dockerfile
  context: .

runtime:
  port: 8080
  health_check: /health
  readiness_check: /ready

3 — Set environment variables

Set these in stateset.yaml or the deploy UI:

Variable	Purpose
`ACP_API_KEY`	Authenticates callers of the handler
`STRIPE_SECRET_KEY`	Only if using the Stripe PaymentIntent integration
`REDIS_URL`	Session store; omit to fall back to in-memory
`COMMERCE_BACKEND`	`icommerce` for real order execution, else stub

In-memory sessions do not survive a restart or a scale-out. A deployment with more than one replica, or any deployment you care about, needs REDIS_URL set — otherwise a checkout session created on one pod is invisible to the next request.

4 — Deploy

Click the button, authenticate with GitHub, and wait for the build. The app lands at:

https://{app-name}.{slug}.cloud.stateset.com

5 — Verify

curl https://{app-name}.{slug}.cloud.stateset.com/health
curl https://{app-name}.{slug}.cloud.stateset.com/openapi.json | head

The handler serves Swagger UI at /docs — a quick way to confirm the surface is up before pointing ChatGPT at it.

ACP handler guide — what you just deployed
ACP — the protocol itself
StateSet Deploy — deployment types, storage, custom domains

Get started

Build your first integration

Operate and improve

Resources and support

Platform

Using the APIs

StateSet Response

StateSet ResponseCX

Temporal Engine

StateSet iCommerce Engine

StateSet Warehouse (WMS)

StateSet Freight (TMS)

StateSet EDI

StateSet Mail

StateSet iCommerce Voice Engine

StateSet iCommerce NSR Engine

AI Agents

StateSet Agents

StateSet Sandbox

StateSet ACP

StateSet UCP

StateSet ICP

StateSet Sequencer

StateSet Set L2

StateSet Cloud

Apps & Consoles

Tools

Deploy the ACP Handler

1 — Add a deploy button

2 — Add `stateset.yaml`

3 — Set environment variables

4 — Deploy

5 — Verify

​1 — Add a deploy button

​2 — Add stateset.yaml

​3 — Set environment variables

​4 — Deploy

​5 — Verify

​Related

1 — Add a deploy button

2 — Add `stateset.yaml`

3 — Set environment variables

4 — Deploy

5 — Verify

Related