- 2026-08-02
- by LethaldiranMX
- Trends
- 0 Comments
LethaldiranMX Insight
This gateway represents a significant architectural shift for WooCommerce merchants, eliminating the traditional requirement of running a dedicated web server for a Lightning node by routing invoice generation entirely over Nostr relays via the CLINK protocol. By leveraging ephemeral keys and decentralized relays, it offers an incredibly elegant, non-custodial payment flow that respects user privacy while supporting complex WooCommerce features like subscriptions and block-based checkouts. For digital operations seeking sovereign, low-overhead Bitcoin integration, this plugin bridges the gap between modern decentralized protocols and established e-commerce infrastructure.
Best Fit & Operational Role: This plugin is best suited for privacy-focused merchants, independent creators, and tech-forward businesses already integrated into the Nostr and Bitcoin ecosystems who want to accept Lightning payments without the maintenance overhead of BTCPay Server or similar self-hosted nodes. Within the WordPress stack, it functions as a highly specialized, lightweight payment gateway that offloads the heavy lifting of invoice generation to the merchant’s external CLINK-compatible wallet. It solves the operational challenge of complex node configuration, allowing store owners to establish a secure, direct-to-wallet payment pipeline using only a CLINK Offer string.
Potential Limitations & Pitfalls: The primary operational risk lies in the dependency on external Nostr relays; any latency or downtime on the configured relays will directly impact checkout invoice generation times. Additionally, while the CoinGecko API integration is well-optimized using WordPress transients to cache exchange rates for five minutes, merchants must be prepared for manual administrative overhead when handling refunds, as automated reverse-path Lightning refunds are not supported.
Accept Bitcoin Lightning Network payments via the CLINK protocol. Customers pay with ShockWallet, ZEUS, Amethyst, or any CLINK-compatible wallet.
Accept Bitcoin Lightning Network payments on your WooCommerce store via the CLINK protocol. No web server required for your Lightning node — all communication flows over Nostr relays.
Customers can pay with ShockWallet, ZEUS, BXRD.app, Amethyst, or any CLINK-compatible Lightning wallet. Read the original public announcement to learn more.
How It Works
- Merchant generates a CLINK Offer string (
noffer1...) from their CLINK-compatible wallet - Customer checks out and selects “Lightning (CLINK)” as payment method
- The plugin uses the noffer to request a BOLT 11 Lightning invoice over Nostr
- Customer scans the QR code and pays with any Lightning wallet
- Payment is confirmed via CLINK receipt — order is marked complete
Features
- Supports simple, variable, digital, and subscription products
- Works with both classic checkout and WooCommerce Cart/Checkout Blocks
- Live BTC price via CoinGecko (5-minute cache) or optional fixed rate
- Display prices in sats, BTC, or ₿ (bip-0177) on product pages, cart, and checkout
- Configurable invoice timeout and poll interval
- Automatic sats conversion from your store currency
- QR code display on the order-received page
- Full refund support (manual Lightning refund)
- Compatible with Custom Price for WooCommerce Pro and other price-display plugins
- Client-side price conversion fallback for maximum plugin compatibility
Third Party Services
This plugin communicates with the following third-party services:
Nostr Relays (CLINK Protocol)
- Purpose: Request and receive Lightning invoices from the merchant’s CLINK-compatible wallet
- When: At checkout, when a customer places an order using the CLINK payment method
- Data sent: Merchant’s noffer offer data, payment amount in satoshis, order description, and ephemeral public keys
- Relay URL: Determined by the merchant’s noffer string (configured in the gateway settings)
- Privacy note: No personal customer data (name, email, address) is transmitted to Nostr relays. Only the payment amount and a short order description are shared. Customers choosing wallet-based auto-renewal (ndebit) authorize the merchant to pull future subscription payments; the ndebit string and subscription amount are known to the Nostr relay.
CoinGecko
- Purpose: Fetch the current BTC-to-fiat exchange rate for price display
- When: On checkout page load, every 5 minutes (result is cached in WordPress transients)
- Data sent: The store’s currency code (e.g.,
usd,eur) - Privacy policy: https://www.coingecko.com/en/privacy
- Note: If configured, a fixed exchange rate in the plugin settings bypasses this service entirely.
ShockWallet.app
- Purpose: Informational links for customers to generate CLINK noffer/ndebit strings
- When: When the customer clicks the link (no data sent by the plugin automatically)
- Privacy policy: https://docs.shock.network/privacy
Development
Source code for the built JavaScript bundles is included in the plugin:
assets/js/clink-checkout.js— source for the order-received page bundleassets/js/clink-blocks.js— source for the blocks checkout registrationassets/js/clink-price-converter.js— source for the client-side price conversion fallbackbuild.mjs— esbuild configurationpackage.json— npm dependencies
Editorial note: This overview combines WordPress.org official plugin metadata with an AI-assisted LethaldiranMX editorial review. Plugin data should be verified on the official WordPress.org listing before installation.
