Sardis

UCP Protocol

Universal Commerce Protocol (UCP) — standardized checkout flow for AI agents with cart management, discount application, session tracking, and fulfillment.

Checkout Flow

UCP defines a four-step commerce flow that any AI agent can follow:

1. Create Checkout    2. Update Cart     3. Complete
┌────────────────┐   ┌────────────────┐  ┌────────────────┐
│ Session + Items│──▶│ + Discount     │─▶│ Payment + Order│
└────────────────┘   └────────────────┘  └────────────────┘

4. Track Fulfillment
┌─────────────────────────────────────────────────────────┐
│ Shipping → In Transit → Delivered                        │
└─────────────────────────────────────────────────────────┘

Python

from sardis import SardisClient

async with SardisClient(api_key="sk_...") as client:
    # Create checkout
    session = await client.ucp.create_checkout(
        merchant_id="merchant_456",
        line_items=[
            {"name": "Widget", "quantity": 2, "unit_price_minor": 1500}
        ],
    )

    # Apply discount
    await client.ucp.apply_discount(session.id, code="SAVE10")

    # Complete
    result = await client.ucp.complete_checkout(
        session_id=session.id,
        chain="base",
        token="USDC",
    )
    print(f"Order: {result.order_id}")

MCP Tools

ToolDescription
sardis_create_checkoutStart session
sardis_update_checkoutModify items
sardis_complete_checkoutComplete and pay
sardis_apply_discountApply discount
sardis_track_fulfillmentTrack shipment