Wix + Google UCP Integration

Enabling AI-Powered Commerce for Wix Stores

📌 What We Built

A bridge between AI Agents and Wix Stores

Enabling Claude, GPT, and Gemini to shop and buy through conversation

🔴 The Problem

User: "Hey Claude, buy me those running shoes"

AI: "I can't actually make purchases. 
     You'll need to visit the store yourself..."

AI can recommend, but can't transact.

🔴 Why This Happens

Challenge	Impact
No Standard Protocol	Every platform is different
Security Concerns	AI can't handle payments
Platform Silos	Custom integration per store

🔴 Business Impact

🛒 Users want to buy, but friction stops them
🤖 AI assistants limited to recommendations
🏪 Merchants lose sales
🔗 Massive integration effort per platform

🟢 The Solution: UCP

Universal Commerce Protocol — A standard language for AI commerce

Before:  Claude → ❓ → Wix
         GPT    → ❓ → Shopify

After:   Claude ─┐
         GPT    ─┼─→ UCP → Any Store
         Gemini ─┘

🟢 What We Built

Capability	Description
🔍 Discovery	Stores discoverable to AI
📦 Catalog	Products in UCP format
🛒 Checkout	Cart-to-order via API
👤 Identity	Link AI to user accounts
💳 Payments	Secure Wix checkout
📋 Orders	History & tracking

🏗️ Architecture Overview

        AI Agents (Claude, GPT, Gemini)
                    │
                    │ MCP Protocol
                    ▼
        ┌───────────────────────┐
        │  Wix UCP Integration  │
        │     (16 MCP Tools)    │
        └───────────────────────┘
                    │
                    │ Wix REST APIs
                    ▼
        ┌───────────────────────┐
        │     Wix Platform      │
        └───────────────────────┘

🏗️ Integration Modules

┌──────────┬──────────┬──────────┐
│ Discovery│  Catalog │ Checkout │
├──────────┼──────────┼──────────┤
│ Identity │  Orders  │ Payments │
└──────────┴──────────┴──────────┘

🛠️ MCP Tools: Catalog

Tool	Purpose
`getBusinessProfile`	Merchant info
`searchProducts`	Search catalog
`getProduct`	Product details

🛠️ MCP Tools: Checkout

Tool	Purpose
`createCheckout`	Create cart
`updateCheckout`	Add buyer info
`getShippingOptions`	Shipping methods
`completeCheckout`	Place order

🛠️ MCP Tools: Orders & Identity

Tool	Purpose
`getOrder`	Order details
`listOrders`	Order history
`getOrderTracking`	Shipment tracking
`createVisitorSession`	Anonymous session
`linkIdentity`	Link to account

🛠️ Tech Stack

Layer	Technology
Runtime	Node.js + TypeScript
Framework	Fastify
Database	PostgreSQL + Prisma
Validation	Zod
Auth	JWT
Tests	493+ passing

🛤️ User Journey

Phase 1: Discovery

👤 "I need running shoes"

🤖 "Let me search..." 
   [searchProducts]
   
   "Found 12 options:
    1. Nike Air Zoom - $129
    2. Adidas Ultra - $149"

🛤️ User Journey

Phase 2: Selection

👤 "Tell me about the Nike"

🤖 [getProduct]

   "Nike Air Zoom features...
    Want to buy them?"

👤 "Yes, size 10"

🛤️ User Journey

Phase 3: Checkout

🤖 [createCheckout]

   "Added! What's your address?"

👤 "123 Main St, NYC 10001"

🤖 [updateCheckout]
   [getShippingOptions]
   
   "Shipping options:
    • Standard (5-7 days): $6
    • Express (2-3 days): $13"

🛤️ User Journey

Phase 4: Payment Handoff

👤 "Express please"

🤖 [updateCheckout]

   "Total: $142
    Click here to pay securely:"
    
   [🔗 Secure Checkout Link]

💳 Checkout: The Handoff Model

AI handles conversation → Wix handles payment

┌─────────────────────────┐
│   AI Agent Zone         │
│   • Products            │
│   • Cart                │
│   • Shipping            │
└───────────┬─────────────┘
            │ Click link
            ▼
┌─────────────────────────┐
│   Wix Checkout          │
│   • Payment form        │
│   • Card processing     │
│   • PCI compliant       │
└─────────────────────────┘

💳 Wix Hosted Checkout

┌─────────────────────────────┐
│  🛒 Order Summary           │
│  Nike Air Zoom      $129.00 │
│  Express Shipping    $13.00 │
│  ─────────────────────────  │
│  Total             $142.00  │
│                             │
│  💳 Card Number             │
│  [____  ____  ____  ____]   │
│                             │
│  [  Complete Purchase  ]    │
│                             │
│  🔒 Secured by Wix          │
└─────────────────────────────┘

💳 Why Handoff to Wix?

Benefit	Description
🔒 PCI Compliant	No card data in AI
💳 All Methods	Cards, PayPal, Apple Pay
🛡️ Fraud Protection	Built-in detection
👤 Trusted UX	Familiar checkout

🔐 Security: Trust Boundaries

┌─────────────────────────┐
│  AI Zone (Safe)         │
│  • Products             │
│  • Addresses            │
│  • Order history        │
└─────────────────────────┘
═══════════════════════════
┌─────────────────────────┐
│  Wix Zone (PCI)         │
│  • Card numbers         │
│  • Payment tokens       │
│  • CVV codes            │
└─────────────────────────┘

🔐 Security Features

Feature	Implementation
Auth	JWT tokens
Validation	Zod schemas
Rate Limiting	Per session
Encryption	Tokens at rest
Audit	Full logging

📊 API Endpoints

Endpoint	Purpose
`/.well-known/ucp/profile`	Discovery
`/mcp/tools/list`	List tools
`/mcp/tools/call`	Execute tool
`/test-ui/console`	Test console
`/test-ui/wizard`	Demo wizard

🚀 Live Demo

API Base https://wix-ucp-api.onrender.com

MCP Console https://wix-ucp-api.onrender.com/test-ui/console

Flow Wizard https://wix-ucp-api.onrender.com/test-ui/wizard

📈 Roadmap

Phase	Status
Core UCP Integration	✅ Done
MCP Bridge (16 tools)	✅ Done
Checkout Flow	✅ Done
Webhooks	🔜 Next
Multi-store	🔜 Planned
Voice Commerce	🔜 Planned

🙏 Summary

✅ Conversational Commerce — Shop via dialogue

✅ Secure Payments — Wix handles PCI

✅ Universal Access — Any UCP-compatible AI

✅ Fast Integration — Standard protocol

🙏 Thank You

The future of shopping is conversational.

We're making it possible on Wix.

📚 Resources

Resource	Link
GitHub	github.com/itayshmool/wix-ucp
API Docs	wix-ucp-api.onrender.com/docs
UCP Spec	ucp.dev