Woo-CLINK - Woocommerce Bitcoin Payment Gateway using CLINK protocol
Enable Bitcoin Lightning Payments -supports recurring payments and subscriptions

Bitcoin Lightning payments for WooCommerce via CLINK protocol

Accept Bitcoin Lightning payments on your WooCommerce store via the CLINK protocol (clinkme.dev). Support subscriptions Auto-Renew!

Get your nOffer string from my.ShockWallet.app/offers

Customers pay with ShockWallet.app, ZEUS, Amethyst, or any other CLINK-compatible Lightning wallet. All transmitted privately and anonymously via relays of the Nostr protocol.

supports recurring payments
See on WordPress.org
Download from GitHub

Bitcoin Mobile Apps compatible with Auto-Renew subscriptions

Here below a list of bitcoin and nostr applications that support nDebit and enable the payment of subscriptions automatically, without further manual payments.

SHOCKWALLET

SHOCKWALLET

ShockWallet is a self-custody Lightning wallet that uses Nostr to securely connect, share, and manage remote nodes—enabling powerful multi-user and multi-device workflows.

Downloand SHOCKWALLET

ZEUS Wallet

ZEUS Wallet

ZEUS is an open-source, self-custodial Bitcoin wallet that gives you full control over how you make payments. Make lightning fast payments in the palm of your hand.

Download ZEUS Wallet

Amethyst social

Amethyst Social

Amethyst brings the best decentralized social network to your Android phone. Just insert your Nostr private key and start posting.

Download Amethyst

Finally: Auto-Renew Subscriptions on Bitcoin Lightning

Recurring payments on the Lightning Network have been the holy grail for Bitcoin merchants. Lightning is inherently push-only — someone has to send sats. There’s no “pull” mechanism, no way to auto-charge a customer. Until now.

Read more

1. First invoice request as a BOLT11 invoice.

Customer payt the first instalment immediately
Customer payt the first instalment immediately as a BOLT11 Lightning invoice.

2. Scheduled renewal request for nDebit string.

Activate Auto-Renewal pasting nDebit string from any CLINK-enabled wallet
After first instalment is paid, customers can now activate Auto-Renewal simply by pasting their nDebit string from any CLINK-enabled wallet.

3. Automatic Auto-Renewal payments activated.

Confirmation of Auto-Renewal activation for future payments
Confirmation of Auto-Renewal activation for future payments. From now on, any future payment instalment will be deducted from the linked CLINK-enabled wallet.

4. Done. The renewal order is marked complete.

When Auto-Renewal is activated, the customer has the option to pay next instalment enytime
When Auto-Renewal is activated, the customer has the option to pay next instalment anytime in advance.

Try it yourself…

Simply
Donate

Contribute with one-time donation to support future Woo-CLINK payment gateway development. Any amount helps!

Try One-time Donation

Auto-Renew Subscription

Select your preferred amount and try the magic of paying subscriptions with Bitcoin Lightning, via CLINK nDebit string.

Try Auto-Renew

Recurring
Support

Join this subscription to support future Woo-CLINK payment gateway future development.
Every sat count!

Sponsor Woo-CLINK

Supported plugins

WooCommerce Subscriptions

by Woo

Subscriptions for WooCommerce

By WP Swings

YITH WooCommerce Subscription

By YITHEMES

Subscriptions with Recurring Payments

By Convers Lab

Flexible Subscriptions

By wpdesk

Custom Price for WooCommerce

By wpdesk

How It Works

  1. Merchant generates a CLINK Offer string (noffer1...) from their CLINK-compatible Lightning node (ShockWallet, Lightning.Pub, etc.)
  2. Customer checks out and selects “Lightning (CLINK)” as payment method
  3. The plugin uses the noffer to request a BOLT 11 Lightning invoice from the merchant’s node over Nostr
  4. Customer scans the QR code and pays with any Lightning wallet
  5. Payment is confirmed via CLINK protocol receipt — order is marked complete

No web server required for the Lightning node. All communication flows over Nostr relays.

Requirements

  • WordPress 5.8+
  • WooCommerce 6.0+
  • PHP 7.4+
  • A CLINK-compatible Lightning wallet/node (ShockWallet, Lightning.Pub, ZEUS, Amethyst)

Installation

From WordPress Admin

  1. Download the latest release .zip from the releases page
  2. Go to Plugins > Add New > Upload Plugin
  3. Upload the .zip and activate
  4. Go to WooCommerce > Settings > Payments > CLINK (Lightning) to configure

Manual

# Navigate to your WordPress plugins directory
cd wp-content/plugins/

# Clone the repository
git clone https://github.com/WoompaLoompa/woo-clink.git woocommerce-clink-gateway

# Install JS dependencies and build (optional — pre-built bundle included)
cd woocommerce-clink-gateway
npm install && npm run build

Then activate the plugin from the WordPress admin.

Configuration

Navigate to WooCommerce > Settings > Payments > CLINK (Lightning).

SettingDescription
Enable/DisableTurn the gateway on/off
TitlePayment method title shown at checkout
DescriptionPayment method description shown at checkout
CLINK Offer StringYour noffer1... string from ShockWallet / Lightning.Pub
Fixed BTC RateOptional — set a fixed BTC price in your currency instead of live CoinGecko rate
Invoice TimeoutSeconds before the Lightning invoice expires (default: 600)
Poll IntervalMilliseconds between payment status checks (default: 5000)

Product Support

Product TypeSupported
SimpleYes
VariableYes
Digital / VirtualYes
Subscription (initial)Yes
Subscription (auto-renewal)Manual — customer returns to pay
Bookings / AppointmentsYes (via WooCommerce core)

Generating a noffer

ShockWallet (mobile)

  1. Open ShockWallet
  2. Go to Receive > CLINK Offer
  3. Copy the noffer1... string
  4. Paste into the plugin settings

Lightning.Pub (self-hosted)

  1. Log into your Lightning.Pub dashboard
  2. Navigate to Offers
  3. Copy the generated noffer1... string

Development

# Install dependencies
npm install

# Build JS bundle
npm run build

# Watch for changes
npm run watch

Two JavaScript bundles are built with esbuild:

  • assets/js/clink-checkout.js — uses @shocknet/clink-sdk to request Lightning invoices via the CLINK protocol on the order-received page. Built to clink-checkout.min.js.
  • assets/js/clink-blocks.js — registers the gateway with WooCommerce Cart/Checkout Blocks via registerPaymentMethod(). Built to clink-blocks.min.js.

Architecture

Checkout Flow:
  Customer                    WooCommerce                  Nostr Relay          Merchant Node
     │                           │                           │                     │
     │── Place Order ───────────▶│                           │                     │
     │                           │── Create Order (pending)  │                     │
     │                           │── Redirect to thank-you   │                     │
     │                           │                           │                     │
     │── Page Load ─────────────▶│                           │                     │
     │                           │── Localize noffer + sats  │                     │
     │                           │                           │                     │
     │── JS: Decode noffer ──────┤                           │                     │
     │── JS: Generate ephemeral  │                           │                     │
     │     Nostr key             │                           │                     │
     │── JS: Send kind:21001 ────┼──────────────────────────▶│── Request Invoice ─▶│
     │                           │                           │                     │
     │                           │◀── BOLT 11 Invoice ───────│◀─ Response ─────────│
     │── Display QR code ◀───────┤                           │                     │
     │── Customer pays ◀─────────┼──────────────────────────▶│                     │
     │                           │                           │── Receipt ─────────▶│
     │◀── Receipt callback ──────┤◀──────────────────────────│                     │
     │── AJAX: mark_paid ───────▶│                           │                     │
     │                           │── Order complete ────────▶│                     │

Files

woocommerce-clink-gateway/
├── woocommerce-clink-gateway.php         # Plugin bootstrap, AJAX handlers, scripts
├── includes/
│   ├── class-wc-gateway-clink.php        # WC_Payment_Gateway implementation
│   ├── class-wc-clink-subscriptions.php  # WooCommerce Subscriptions integration
│   └── class-wc-clink-blocks-support.php # Cart/Checkout Blocks support
├── assets/
│   ├── js/
│   │   ├── clink-checkout.js             # Source — order-received page (ES module)
│   │   ├── clink-checkout.min.js         # Built bundle
│   │   ├── clink-blocks.js               # Source — blocks checkout registration
│   │   ├── clink-blocks.min.js           # Built bundle
│   │   └── clink-checkout.asset.php      # Asset metadata
│   ├── css/clink-checkout.css            # Checkout page styles
│   └── images/lightning-icon.svg         # Payment method icon
├── build.mjs                             # esbuild config
└── package.json                          # NPM dependencies

Security

  • Nonces: All AJAX endpoints use wp_create_nonce() / check_ajax_referer()
  • Escaping: All output uses WordPress escaping functions (esc_html, esc_url, esc_js, wp_kses_post)
  • Sanitization: All input uses sanitize_text_field() / absint()
  • No direct DB queries: All data access through WooCommerce APIs
  • Ephemeral keys: Each checkout generates a fresh Nostr key pair — never reuses keys

License

MIT — see LICENSE.