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 |
Wix + Google UCP Integration
By Itay Shmool
Wix + Google UCP Integration
Discover the exciting integration of Wix and Google UCP, empowering AI-driven commerce for Wix stores. Explore innovative solutions, user journeys, and a robust architecture designed to enhance checkout experiences and business impact.
- 22
