Bitcoin Lightning payments for MedusaJS eCommerce via CLINK

MedusaJS is one of the fastest-growing open-source eCommerce frameworks, but despite its explosive growth in headless commerce, no Bitcoin Lightning module existed for MedusaJS. Until now. Built a MedusaJS module that enables Bitcoin Lightning payments for online stores using the CLINK protocol. Available via npm and GitHub.

Built a MedusaJS plugin that enables Bitcoin Lightning payments for online stores using the CLINK protocol. Available via npm and GitHub.

The gap: MedusaJS is one of the fastest-growing open-source eCommerce frameworks (35K+ stars on GitHub, claimed $10B+ GMV global, ~150K monthly npm downloads). Despite explosive growth in headless commerce, no Bitcoin Lightning plugin existed for MedusaJS. Until now.

Market context:

Bitcoin payments ecosystem: $8.7B in 2026, projected $53.65B by 2035 (22.4% CAGR) — MarkWide Research
Lightning Network: $1.17B monthly volume, 266% YoY growth — River State of Lightning Report
Lightning avg transaction size doubled to $223 (up from $118) — River
Square opened Lightning to 4M US merchants with zero processing fees — Square
8/10 crypto holders hold for investment, only ~20% use for shopping — huge untapped merchant adoption potential

What it does:

Accept Lightning payments on any MedusaJS store
Self-custodial: merchant optionally runs their own Lightning.pub node, no third-party custody
Instant settlement via Lightning Network
QR code + one-click copy for invoices payments
Auto currency conversion (CoinGecko, Kraken, Fixed rate, or manual)
Subscriptions via nDebit recurring payments that activate automatic renewals.
Dual confirmation: Webhook (primary) + Polling (backup)

Why CLINK? CLINK (Common Lightning Interface for Nostr Keys) uses Nostr as transport layer with no web server required for your Lightning node if you chose Bootstrap on ShockWallet.app. Self-custodial by design when you opt-in running your Lightning.pub node. Ephemeral keys for payment requests = better privacy than traditional payment processors.

Quick start:

npm install medusa-plugin-bitcoin-lightning-via-clink

// medusa-config.ts
{
  resolve: "medusa-plugin-bitcoin-lightning-via-clink",
  id: "clink",
  options: {
    noffer: "noffer1...",  // Your CLINK offer
    currencySource: "coingecko"
  }
}

Advantages: Traditional card payments cost merchants 2-3% per transaction. Lightning costs a fraction of a cent. Let's not even consider all telemetry and tracking that can be done by third parties on all your fiat payments, done and received. CLINK offers zero traceability without any traceable HTTP/HTTPS calls. For a small business processing thousands of transactions/month, the savings are material. Plus: no chargebacks, instant settlement, no waiting for batch processing, it just works, 24/7, 365 days a year non stop.

Links:

Feedback welcome. Happy to answer any questions.

Bitcoin Lightning payments for MedusaJS eCommerce via CLINK

Written by

Comments