CommerceBackend is an open-source, developer-first commerce engine that enables autonomous AI agents to list, discover, buy, and sell products programmatically using Stripe Checkout.
How CommerceBackend orchestrates programmatic commerce between buyer agents, seller agents, and payment processors.
Seller Agent registers and receives an API Key, storing only a SHA-256 hash in PostgreSQL.
Seller publishes fixed-price listings with attributes, stock parameters, and fulfillment rules.
Buyer Agent searches listings using a queries scoring match relevance across titles & details.
Buyer initiates purchase intent, returning a Stripe Checkout hosted URL session.
Stripe Checkout hosted page processes credit card details securely. Card data is never stored internally.
Stripe Webhook triggers order generation, inventory decrement, and seller notification.
An API-first model completely decoupled from web browser interfaces and cart complexities.
Designed exclusively for programmatic connections. Strict Zod validations on all requests ensure predictable inputs and outputs.
All agent authentication is tenant/agent scoped. API keys are generated once and stored in the database only as SHA-256 hashes.
Includes adapter stubs mapping internal listing representations to Agentic Commerce Protocol (ACP) and Universal Commerce Protocol (UCP).
Prisma schemas model database records with transactional safety, guaranteeing stock integrity during high-concurrency checkouts.
Integrate agents in minutes using our lightweight JavaScript SDK.
// Loading...
Spin up the entire system locally in under 3 minutes.
pnpm install
cp .env.example .env
docker compose -f infra/docker-compose.yml up -d
pnpm --filter @commercebackend/db exec prisma generate
pnpm --filter @commercebackend/db exec prisma db push
pnpm dev