Universal Commerce Protocol (UCP) Samples

This directory contains sample implementations and client scripts for the Universal Commerce Protocol (UCP).

Sample Implementations

Python

A reference implementation of a UCP Merchant Server using Python and FastAPI.

• Server: Documentation

  • Located in rest/python/server/.
  • Demonstrates capability discovery, checkout session management, payment processing, and order lifecycle.
  • Includes simulation endpoints for testing.

• Client: Happy Path Script

  • Located in rest/python/client/.
  • A script demonstrating a full "happy path" user journey (discovery -> checkout -> payment).

Node.js

A reference implementation of a UCP Merchant Server using Node.js, Hono, and Zod.

• Server: Documentation
  • Located in rest/nodejs/.
  • Demonstrates implementation of UCP specifications for shopping, checkout, and order management using a Node.js stack.

Getting Started

Please refer to the specific README files linked above for detailed instructions on how to set up, run, and test each sample.