Accept Bitcoin with your Lightning Address
| 开发者 | magollo |
|---|---|
| 更新时间 | 2026年6月25日 03:31 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPL-3.0-or-later |
| 版权网址: | 版权信息 |
详情介绍:
Accept Bitcoin with your Lightning Address combines two Lightning features in one plugin:
- WooCommerce Lightning payments. A checkout gateway that pays to your merchant Lightning Address using LNURL-pay, verifies settlement server-side with LUD-21, optionally detects payment faster in the browser via NIP-57 zap receipts and WebLN, and converts fiat order totals to sats using Yadio exchange rates.
- Lightning Address / NIP-05 discovery. Keeps your root domain on WordPress while a separate
LaWallet instance serves wallet discovery: the plugin registers rewrite
rules for the relevant
/.well-known/routes and redirects them (HTTP 307) to the LaWallet gateway you configure.
- At checkout the plugin resolves your merchant Lightning Address (LNURL-pay) and requests an invoice for the order total.
- The customer pays by scanning a QR code, opening their wallet via a
lightning:link, or using WebLN. - Your server confirms settlement with the LUD-21
verifyURL before the order is marked paid. Zap receipts and WebLN only speed up detection in the browser - they never settle an order by themselves. - Pending Lightning orders are re-checked by WordPress cron; expired unpaid invoices cancel the order automatically.
- For non-BTC store currencies, order totals are converted using Yadio BTC exchange rates, or a manual sats-per-unit rate you set yourself.
/.well-known/ are touched (for example
/.well-known/lnurlp/... and /.well-known/nostr.json). They are redirected with HTTP 307
(method-preserving) to the LaWallet gateway endpoint you configure under
Settings -> LaWallet. The endpoint is verified before discovery is enabled.
安装:
- Upload the plugin ZIP from Plugins -> Add New -> Upload Plugin, or unzip it into
wp-content/plugins/. - Activate Accept Bitcoin with your Lightning Address.
- For payments: go to WooCommerce -> Settings -> Payments -> Lightning (LaWallet) and set your merchant Lightning Address. Saving creates a test invoice and requires a LUD-21 verify URL, so you know settlement verification works before going live.
- For discovery: go to Settings -> LaWallet, enter your LaWallet gateway endpoint and connect. The plugin verifies the endpoint before enabling the redirects.
常见问题:
Do I need WooCommerce?
Only for payments. Lightning Address / NIP-05 discovery works without WooCommerce.
Does the plugin custody funds?
No. Payments go directly to your own Lightning Address. The plugin only requests invoices and verifies settlement via LUD-21.
My wallet does not support LUD-21, can I still use this?
No. Server-side settlement verification (LUD-21 verify) is required so orders are only marked
paid when the invoice is actually settled.
Which currencies are supported?
Any WooCommerce currency supported by Yadio rates, plus a manual sats-per-unit rate as a fallback. BTC-denominated stores need no conversion.
更新日志:
0.2.2
- Update the bundled Spanish (es_AR, es_ES) translations to cover the new gateway, discovery, and NIP-57 strings.
- Document the Yadio exchange-rate service with links to its Terms of Service and Privacy Policy.
- Add live LUD-16, LUD-21 and NIP-57 checks beside the merchant Lightning Address field, each with a status icon.
- Accept Lightning Addresses that do not support LUD-21: settlement is confirmed from signed NIP-57 zap receipts (at checkout and via the cron re-check), with BIP-340 signature verification so only genuine receipts can settle an order.
- Show the connected gateway name and domain on the discovery settings page, and warn when the gateway domain does not match your site.
- Refresh the discovery settings copy and rename the Settings menu entry to "Lightning by LaWallet".
- Refresh the plugin directory icon (new lightning mark with a subtle Bitcoin watermark).
- Rename the plugin to "Accept Bitcoin with your Lightning Address" and update the short description.
- Set the Contributors field to the plugin owner's WordPress.org account (magollo).
- Expand the Yadio external-service disclosure: clarify the optional, currency-code-only request, the manual-rate opt-out, and the available Yadio documentation.
- Add a GitHub-based self-updater so installs distributed outside the WordPress.org directory can update from the project's GitHub Releases. Self-disables when the plugin is hosted on WordPress.org.
- Point the Plugin URI to the project site (wordpress.lawallet.io).
- Enqueue the settings-page CSS and JavaScript instead of printing them inline.
- Expand the Yadio external service documentation and load translations on the init hook.
- Set the plugin Contributors to agustinkassis.
- Improve Lightning payment page rate display with locked Yadio conversion snapshots and BTC/SAT display options.
- Polish checkout/payment controls, including WebLN loading states, paid-state disabling, and fallback wallet visibility.
- Add a Bitcoin icon to the WooCommerce LaWallet payment method option.
- Initial release: WooCommerce Lightning gateway (LNURL-pay + LUD-21 verification, WebLN and NIP-57 zap receipt detection, Yadio fiat conversion) and Lightning Address / NIP-05 discovery redirects to a LaWallet gateway.