Setting Up Lightning

Lightning Network support enables instant payments on your store pages. Buyers pay via Lightning and receive their games immediately — no waiting for block confirmations.

Prerequisites

You need a Lightning address from a compatible wallet or service. Popular options:

• Alby (you@getalby.com)
• Wallet of Satoshi (you@walletofsatoshi.com)
• Strike (you@strike.me)
• Zeus (self-hosted)
• Any LNURL-compatible service

Adding a Lightning Wallet

1. Go to Payment Destinations (/seller/payment-destinations)
2. Click Add Wallet
3. Select Lightning Address as the type
4. Enter your Lightning address (e.g. alice@getalby.com)
5. Save

Enabling Lightning on a Store Page

1. Go to Store Pages → Edit your page
2. Toggle Lightning Enabled
3. Select your Lightning payment destination
4. Save

How It Works

When a buyer pays via Lightning:

Buyer scans Lightning invoice
  → Payment settles on seller's Lightning node
  → Webhook notification sent to Ludilol
  → Order immediately fulfilled
  → Games unlock in buyer's library

Webhook

Lightning payments use a webhook to notify Ludilol of settlements. The webhook endpoint is:

POST /api/lightning/webhook/{webhookSecret}

Each payment destination has a unique webhookSecret for authentication. The webhook validates:

1. The secret matches the payment destination
2. The payment amount matches the order
3. The order exists and is in an open state

Lightning vs On-Chain

Lightning is optional — you can offer both payment methods on the same store page:

Feature	On-Chain	Lightning
Setup	xpub/descriptor	Lightning address
Speed	Minutes to hours	Seconds
Buyer experience	QR code + wait	QR code + instant
Fees	Mining fee	Routing fee