Enabling Bitcoin Lightning Payments for Vendure eCommerce framework with 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

• GitHub
• npm
• Vendure Plugin Hub

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