Enabling Bitcoin Lightning Payments for Vendure eCommerce framework with CLINK Protocol

The e-commerce platform market is dominated by Shopify, WooCommerce, and Magento. Bitcoin Lightning payments represent <0.1% of checkout volume across these platforms. Merchants are ready, buyers are there. The barrier is simply integration friction and trust. Here is a Vendure plugin that accepts Bitcoin Lightning payments via the CLINK protocol.

Here is a Vendure plugin that accepts Bitcoin Lightning payments via the CLINK protocol (Nostr-native static payment codes).

GitHub: https://github.com/WoompaLoompa/vendure-clink
npm: vendure-plugin-bitcoin-lightning-via-clink

What it does#

Accepts BTC Lightning payments in any Vendure e-commerce store
Real-time BTC/USD price oracle (CoinGecko, Kraken, custom)
Per-channel Nostr keypair and relay configuration
HTTP webhook fallback for wallets without Nostr support
Storefront React component with relay info display
Payment verification: preimage hash check, BOLT11 amount validation, HMAC webhook auth

Why this matters for Bitcoin payments in e-commerce#

The e-commerce platform market is dominated by Shopify (~$200B GMV), WooCommerce (~$200B), and Magento (~$100B). Bitcoin Lightning payments represent <0.1% of checkout volume across these platforms. Merchants are ready, buyers are there. The barrier is simply integration friction and trust.

Vendure is positioned differently: it's headless, open-source, and developer-first. Unlike WooCommerce or Shopify, Vendure gives full control over the payment stack integration. This is where a Bitcoin-native payment method actually makes sense, and currently there's no option for merchants or buyers to buy or sell products and services for bitcoin, P2P. Third parties are always there to get a cut.

With this plugin merchants can accept Lightning payments without running a node (optionally, when choosing Bootstrap in ShockWallet.app), managing channels, or trusting a third-party processor. Its integration with Lightning.pub makes this process much easier and intuitive for merchants willing to accept bitcoin P2P. The payment code is static, its called nOffer. Reuse the same code across orders and settlement happens via Nostr relays. No HTTP/HTTPS calls. It's simpler than BTCPay Server, cheaper than OpenNode.

As merchant

Signup to Shockwallet.app to het your multiplatform Bitcoin wallet
Optionally, install Lightning.pub node in your computer or VPS

As customer

Use any CLINK-aware wallets as Bitcoin Wallet
Find your nDebit to pay lightning invoices and activate subscriptions auto-renew

Market context#

Lightning Network capacity: ~~5,000 BTC (~~$325M) — growing 40% YoY
Global e-commerce: $6.3T (2024), projected $8T by 2027
Bitcoin payment processors: BitPay, BTCPay, Strike, OpenNode — all serve their niche
Headless commerce platforms: growing 25% CAGR as merchants ditch Shopify lock-in

The intersection of headless commerce + Bitcoin Lightning is underserved. Vendure has 8.3k GitHub stars and a growing plugin ecosystem. This plugin fills a gap that no other Vendure payment plugin addresses: Sovereign P2P Bitcoin Payments.

Security checks#

The plugin has gone through security review: HMAC webhook auth, preimage verification, Nostr signature checks, BOLT11 amount validation. 59 passing tests. Open for audit.

Links#

Happy to answer questions or hear feedback from anyone running a Vendure store or considering Bitcoin payments.