Bitcoin Lightning Payment Gateway for WooCommerce (via CLINK)
| 开发者 | WooClink |
|---|---|
| 更新时间 | 2026年7月7日 23:30 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
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, Amethyst, or any CLINK-compatible Lightning wallet.
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
- 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
安装:
- Download the plugin
.zipfrom WordPress.org - Go to Plugins > Add New > Upload Plugin
- Upload the
.zipand activate - Go to WooCommerce > Settings > Payments > CLINK (Lightning)
- Enable the gateway and paste your
noffer1...string - Save changes
屏幕截图:
常见问题:
What is a "noffer"?
A noffer is a CLINK Offer string (noffer1...) that advertises your Lightning node's ability to receive payments. Generate one from ShockWallet, Lightning.Pub, or any CLINK-compatible wallet.
Which wallets can customers use?
Any CLINK-compatible Lightning wallet: ShockWallet, ZEUS, Amethyst, and others.
Does this need a Lightning node on my server?
No. All communication flows over Nostr relays. Your Lightning node only needs a Nostr connection.
Are subscriptions supported?
Yes. Subscriptions work with WooCommerce Subscriptions, Subscriptions for WooCommerce, YITH WooCommerce Subscription, Flexible Subscriptions, and others. After the first payment, customers can authorize auto-renewal via CLINK ndebit — future payments are processed automatically without scanning QR codes.
How is the BTC price determined?
The plugin fetches the live BTC price from CoinGecko with a 5-minute cache. You can optionally set a fixed rate in the settings.
Does this plugin work with Custom Price for WooCommerce Pro?
Yes. The plugin uses PHP_INT_MAX priority for all price filters and includes a client-side JavaScript fallback that converts prices in the browser, ensuring compatibility with Custom Price for WooCommerce Pro and similar price-display plugins.
更新日志:
1.0.7
- Stripped remote gist.github.com URL from built JavaScript bundle (WordPress.org review compliance)
- Fixed contributors list to match plugin owner's WordPress.org username
- Added Third Party Services section documenting Nostr relays, CoinGecko, and ShockWallet.app
- "Payment:" row on View Subscription page shows "Auto-Renewal" (ndebit saved) or "Activate Auto-Renewal" link pointing to the parent order's order-received page for ndebit setup
- Subscription "Payment:" row now shows "Via Auto-Renewal" or "Via Manual Renewal" based on ndebit status
- Added "Activate Auto-Renewal" action link on My Account subscription items for subscriptions without ndebit
- Added "Get your nDebit string" link pointing to my.shockwallet.app/lapps at checkout and on My Account
- QR codes now generated client-side with bundled qrcode-generator library (no remote API dependency)
- Fixed "Auto-Renewal" title changed to "Setup Auto-Renewal" on the order-received page
- Added ndebit auto-renewal for subscriptions — customers authorize recurring payments via CLINK
- Auto-renewal is active by default after first subscription payment; titled "Setup Auto-Renewal" on the order-received page
- Customers can disable auto-renewal from My Account > Subscriptions
- Added "Get your nDebit string" link at checkout and on My Account subscription items pointing to https://my.shockwallet.app/lapps
- QR codes are now generated client-side using the bundled qrcode-generator library (no remote API dependency)
- Added BTC / sats / ₿ (bip-0177) currency display option — overrides all frontend prices
- Price display runs at PHP_INT_MAX priority to avoid conflicts with other plugins
- Added client-side price conversion fallback for maximum compatibility with Custom Price for WooCommerce Pro and similar plugins
- Fixed BTC/bip-0177 price formatting — now correctly shows 8 decimal places
- Compatibility improvements for third-party subscription plugins
- Fixed PCP warnings (text domain, non-prefixed hook ignore)
- Removed redundant Store Currency setting (uses WooCommerce default)
- External links in description now open in new tabs with rel="noopener noreferrer"
- Fixed blocks checkout description rendering (HTML no longer escaped)
- Fixed blocks checkout icon (was passing HTML instead of URL)
- Added loading="lazy" to gateway icon
- Updated repo and author URLs
- Fixed blocks checkout support with dedicated JS bundle
- Fixed WPCS violations from audit
- Added SCRIPT_DEBUG conditional for .min suffix
- Added subscriptions support
- Improved error handling and logging
- Better mobile QR code layout
- Fixed classic checkout redirect flow
- Added i18n support
- Initial release