Shopify Commerce

Subscription Required

Shopify L402 integration requires an Agentic Commerce subscription — either Individual ($99/month) or Business ($299/month). View pricing

Lightning Enable's Shopify integration lets AI agents purchase products from your Shopify store using Lightning Network payments. Your existing Shopify catalog, inventory management, and fulfillment workflows stay exactly as they are — Lightning Enable adds a new sales channel powered by the L402 protocol.

How It Works

AI Agent                        Lightning Enable                    Your Shopify Store
   │                                  │                                     │
   ├─ GET /catalog ──────────────────►│──── products.json ─────────────────►│
   │◄──── product list ──────────────┤◄──── products + prices ─────────────┤
   │                                  │                                     │
   ├─ POST /checkout ────────────────►│                                     │
   │  (items + quantities)            │── create Lightning invoice ──►      │
   │◄──── 402 + invoice + token ─────┤   (via Strike/OpenNode)             │
   │                                  │                                     │
   ├─ pay invoice ───────────────────►│                                     │
   │◄──── preimage (proof) ──────────┤                                     │
   │                                  │                                     │
   ├─ POST /claim ───────────────────►│                                     │
   │  (L402 proof + shipping)         │── POST /admin/api/orders.json ────►│
   │◄──── order confirmation ────────┤◄──── Shopify order created ────────┤
   │                                  │      (paid, inventory decremented)  │

1. Browse — Agent fetches your product catalog (cached from Shopify's public API)
2. Checkout — Agent submits a cart, receives a Lightning invoice and claim token
3. Pay — Agent pays the invoice, receives cryptographic proof of payment (preimage)
4. Claim — Agent or human provides shipping details with the payment proof, Shopify order is created

Key Features

• Zero changes to your Shopify store — products, inventory, and fulfillment stay in Shopify
• Auto-registered for agent discovery — your store appears in the L402 API registry so AI agents can find it via discover_api
• Server-side pricing — prices are always fetched from your Shopify catalog, never client-controlled
• Cryptographic payment proof — L402 verification (SHA256(preimage) == payment_hash) confirms payment without webhook dependencies
• Automatic Shopify orders — orders appear in your Shopify admin as "paid" with inventory decremented
• Flat-rate shipping — configurable domestic and international rates with optional free shipping threshold
• Catalog caching — products cached for configurable duration (default 15 minutes) to minimize API calls
• Claim tokens — configurable claim window (default 30 days) for providing shipping details after payment

What You Need

1. Active Shopify store with products published to the Online Store sales channel
2. Shopify Admin API access token with write_orders and read_products scopes
3. Lightning Enable subscription — Agentic Commerce Individual ($99/mo) or Business ($299/mo)
4. Payment provider account — Strike (recommended) or OpenNode

Agent Flow vs Human Flow

The Shopify L402 integration supports a two-phase flow:

Phase	Who	What Happens
Purchase	AI Agent	Browses catalog, creates checkout, pays Lightning invoice
Claim	AI Agent or Human	Provides shipping address and email, triggers Shopify order creation

The claim token bridges the two phases. After an agent pays, it (or a human) can provide shipping details using the claim token within the configured claim window (default 30 days).

Order Lifecycle

Status	Meaning
PendingPayment	Checkout created, waiting for Lightning payment
PaidAwaitingDetails	Payment confirmed, waiting for shipping details
PaidWithDetails	Shipping details provided, Shopify order created
Fulfilled	Shopify fulfillment started
Shipped	Tracking info available

Next Steps

• Setup Guide — Step-by-step integration setup
• API Reference — Full endpoint documentation
• Agent Discovery & Registry — Control how agents find your store