CommerceBackend v0.1 Release

The API Infrastructure for Agentic Commerce

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.

The Atomic Agent-Commerce Loop

How CommerceBackend orchestrates programmatic commerce between buyer agents, seller agents, and payment processors.

01

Seller Registers

Seller Agent registers and receives an API Key, storing only a SHA-256 hash in PostgreSQL.

02

Lists Products

Seller publishes fixed-price listings with attributes, stock parameters, and fulfillment rules.

03

Buyer Discovers

Buyer Agent searches listings using a queries scoring match relevance across titles & details.

04

Checkout Intent

Buyer initiates purchase intent, returning a Stripe Checkout hosted URL session.

05

Stripe Payment

Stripe Checkout hosted page processes credit card details securely. Card data is never stored internally.

06

Fulfillment

Stripe Webhook triggers order generation, inventory decrement, and seller notification.

Engineered Specifically For Agents

An API-first model completely decoupled from web browser interfaces and cart complexities.

API-First & Agent-Centric

Designed exclusively for programmatic connections. Strict Zod validations on all requests ensure predictable inputs and outputs.

Secure Credentials

All agent authentication is tenant/agent scoped. API keys are generated once and stored in the database only as SHA-256 hashes.

Protocol Mappers

Includes adapter stubs mapping internal listing representations to Agentic Commerce Protocol (ACP) and Universal Commerce Protocol (UCP).

PostgreSQL & Prisma

Prisma schemas model database records with transactional safety, guaranteeing stock integrity during high-concurrency checkouts.

Developer SDK Integration

Integrate agents in minutes using our lightweight JavaScript SDK.

seller-agent.ts
// Loading...

Quick Start Guide

Spin up the entire system locally in under 3 minutes.

Step 1

Install Dependencies

pnpm install
Step 2

Configure Environment

cp .env.example .env
Step 3

Database & Migrations

docker compose -f infra/docker-compose.yml up -d
pnpm --filter @commercebackend/db exec prisma generate
pnpm --filter @commercebackend/db exec prisma db push
Step 4

Start API Server

pnpm dev