# Luxe Glow - Agentic Commerce Reference Implementation
# https://demo.aido-labs.co

> Luxe Glow is a fully compliant beauty e-commerce store implementing ALL major
> 2026 agentic commerce standards. This is the Aido reference implementation.

## Standards Implemented

### Commerce Protocols
- **ACP v2026-01-30** - Agentic Commerce Protocol (OpenAI + Stripe)
- **UCP v2026-01-23** - Universal Commerce Protocol (Google + Shopify + 20 partners)

### Agent Interoperability
- **WebMCP** - W3C Draft for browser-based AI agent tools
- **A2A v0.3** - Agent-to-Agent Protocol (Google + 50 partners)
- **MCP** - Model Context Protocol (Anthropic)

### Payment Standards
- **Stripe SPT** - Shared Payment Tokens for delegated payments
- **AP2** - Agent Payments Protocol (Google + Mastercard + PayPal)
- **PayOS** - Card-native agent payments via Mastercard Agentic Tokens + Visa TAP (no merchant SDK required)
- **nekuda** - Agentic payment wallet with hosted iframe card collection and ACP checkout gateway

### Discovery
- **llms.txt** - AI discovery standard (Jeremy Howard)

## Protocol Endpoints

GET /.well-known/ucp - UCP merchant profile
GET /.well-known/agent.json - A2A agent card
GET /.well-known/mcp - MCP server info

## Agentic Commerce Protocol Endpoints

POST /agentic_commerce/create_checkout - Initiate checkout session
POST /agentic_commerce/update_checkout - Modify checkout details
POST /agentic_commerce/complete_checkout - Process payment with SPT
POST /agentic_commerce/cancel_checkout - Cancel and release inventory
POST /agentic_commerce/delegate_payment - Receive delegated payment token

## WebMCP Tools (navigator.modelContext)

### Discovery
- search_products - Search by query, category, or brand
- get_product_details - Get full product information
- check_inventory - Real-time stock availability

### Cart Management
- add_to_cart - Add product to cart (requires product_id, quantity)
- update_cart - Modify cart item quantity
- remove_from_cart - Remove item from cart
- get_cart - Retrieve current cart contents

### Checkout
- create_checkout - Initiate ACP checkout session
- apply_promo_code - Apply discount code

### Payment
- create_payment_method - Tokenize payment via Stripe.js
- process_payment - Complete payment with SPT

### Order Management
- get_order_status - Check order status
- track_shipment - Get tracking information
- initiate_return - Start return process

## Payment Methods

- Stripe.js (tokenized cards)
- Apple Pay (ApplePaySession)
- Google Pay (PaymentsClient)
- Klarna (BNPL)
- Clearpay/Afterpay (BNPL)
- PayOS (Mastercard Agentic Tokens + Visa TAP — network-level, no checkout changes required)
- nekuda (agentic wallet — collect.nekuda.ai hosted iframe)

## Delegated Payment Limits

Agents can complete purchases autonomously within:
- Per-transaction: €200 / $200
- Daily: €500 / $500
- Monthly: €2000 / $2000

## API Documentation

- /openapi.json - OpenAPI 3.1 specification
- /llms-full.txt - Complete documentation
- /api/products - Product catalog
- /api/webhooks - Webhook configuration

## Webhook Events

order.created, order.paid, order.shipped, order.delivered,
return.initiated, refund.processed

## Contact

Site: https://demo.aido-labs.co
Docs: https://aido-lighthouse.com
Standard: https://github.com/agentic-commerce-protocol/agentic-commerce-protocol