Skip to main content

Shopify Commerce

Subscription Required

Shopify L402 integration requires a paid plan: Agentic Commerce ($49/month) or Agentic Commerce — Business (contact us). The Free Producer Sandbox doesn't include it. 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 ──────────────────►│──── Admin API products ────────────►│
│◄──── product list ──────────────┤◄──── products + prices ─────────────┤
│ │ │
├─ POST /checkout ────────────────►│ │
│ (items + buyer location) │── create Lightning invoice ──► │
│◄──── 402 + invoice ─────────────┤ (via Strike/OpenNode) │
│ │ │
├─ pay invoice ───────────────────►│ │
│◄──── preimage (proof) ──────────┤ │
│ │ │
├─ POST /checkout (retry) ────────►│ │
│ (L402 payment proof) │ │
│◄──── claim URL + token ─────────┤ │
│ │ │
├─ POST /claim ───────────────────►│ │
│ (claim token + shipping) │── POST /admin/api/orders.json ────►│
│◄──── order confirmation ────────┤◄──── Shopify order created ────────┤
│ │ (paid, inventory decremented) │
  1. Browse — Agent fetches your product catalog, which Lightning Enable pulls from the Shopify Admin API and caches.
  2. Checkout — Agent submits a cart with the buyer's location (required for tax), receives a Lightning invoice
  3. Pay — Agent pays the invoice, receives cryptographic proof of payment (preimage)
  4. Retry — Agent re-POSTs the same checkout endpoint with the L402 proof and receives the claim URL carrying the claim token (withheld before payment so nobody can race the buyer to claim)
  5. Claim — Agent or human provides shipping details with the claim token, 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
  • Automatic tax calculation — tax computed via Shopify's Draft Order API using buyer location, included in the Lightning invoice total
  • 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 — products you sell via L402 need Active status (Online Store publishing isn't required)
  2. Shopify app credentials with write_orders, write_draft_orders, and read_products scopes
  3. A claim page on your store where buyers submit shipping details (templates provided; see Setup Step 7)
  4. Lightning Enable paid plan — Agentic Commerce ($49/mo) or Agentic Commerce — Business (contact us)
  5. Payment provider account — Strike (recommended; it returns the preimage L402 needs)

Agent Flow vs Human Flow​

The Shopify L402 integration supports a two-phase flow:

PhaseWhoWhat Happens
PurchaseAI AgentBrowses catalog, creates checkout, pays Lightning invoice
ClaimAI Agent or HumanProvides shipping address and email, triggers Shopify order creation

The claim token bridges the two phases. It is issued only after payment is proven: in the claim URL returned by the checkout retry, or emailed to the buyer when an email was given at checkout. Shipping details must be submitted within the claim window (default 30 days). After the claim, the same token works for order-status tracking.

Order Lifecycle​

StatusMeaning
PendingPaymentCheckout created, waiting for Lightning payment
PaidAwaitingDetailsPayment confirmed, waiting for shipping details
PaidWithDetailsShipping details provided, Shopify order created
FulfilledShopify fulfillment started
ShippedTracking info available

Next Steps​