Title: Accept Bitcoin with your Lightning Address Author: magollo Published: June 24, 2026 Last modified: June 24, 2026 --- Search plugins ![](https://ps.w.org/lawallet-lightning-address/assets/banner-772x250.png?rev=3585298) ![](https://ps.w.org/lawallet-lightning-address/assets/icon.svg?rev=3585298) # Accept Bitcoin with your Lightning Address By [magollo](https://profiles.wordpress.org/magollo/) [Download](https://downloads.wordpress.org/plugin/lawallet-lightning-address.0.2.2.zip) * [Details](https://wordpress.org/plugins/lawallet-lightning-address/#description) * [Reviews](https://wordpress.org/plugins/lawallet-lightning-address/#reviews) * [Installation](https://wordpress.org/plugins/lawallet-lightning-address/#installation) * [Development](https://wordpress.org/plugins/lawallet-lightning-address/#developers) [Support](https://wordpress.org/support/plugin/lawallet-lightning-address/) ## Description **Accept Bitcoin with your Lightning Address** combines two Lightning features in one plugin: 1. **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. 2. **Lightning Address / NIP-05 discovery.** Keeps your root domain on WordPress while a separate [LaWallet](https://lawallet.io) 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. #### Payments: how an order is processed * 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 `verify` URL 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. #### Discovery: which requests are redirected Only the wallet discovery routes under `/.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. ### External services This plugin talks to the following external services. No data is sent anywhere until you configure the related feature. #### Your merchant Lightning Address endpoint (LNURL-pay) When a customer checks out, the plugin contacts the LNURL-pay endpoint of the Lightning Address you configured (the domain after the `@` of your own address) to request an invoice for the order amount, and later calls its LUD-21 `verify` URL to confirm settlement. Order amounts and invoice identifiers are sent. The terms of that service are the ones of your own wallet provider. #### LaWallet gateway If you enable discovery, requests to your site’s `/.well-known/` wallet discovery routes are redirected to the LaWallet gateway endpoint you configure, and the plugin probes /.well-known/lawallet.json on that endpoint to verify it. See the [LaWallet terms](https://lawallet.io/terms) and [privacy policy](https://lawallet.io/privacy). #### Yadio exchange rates For stores **not** priced in BTC, the plugin converts the order total to satoshis using a Bitcoin exchange rate from [Yadio](https://yadio.io), a free public rate API. It sends a single server-side GET request to `https://api.yadio.io/rate/{CURRENCY}/ BTC` whenever a fresh rate is needed, where {CURRENCY} is your WooCommerce store currency code (for example `USD` or `ARS`). Results are cached for 5 minutes. Only that three-letter currency code is sent – no customer, order, account, or site data ever leaves your server. This request is optional. Stores priced in BTC/SAT need no conversion, and any store can avoid Yadio entirely by setting a fixed “manual sats-per-unit” rate in the gateway settings. Yadio is a free, public, no-account API. Because the request is made from your server, Yadio receives your store server’s IP address (which, per its privacy policy, it logs to monitor for abuse) and the three-letter currency code – nothing else. This service is provided by Yadio; see the Yadio [terms of service](https://yadio.io/terms.html) and [privacy policy](https://yadio.io/privacy.html). Yadio’s role as the rate provider for the LaWallet ecosystem is also disclosed in the [LaWallet privacy policy](https://lawallet.io/privacy). #### Nostr relays (optional) If your wallet provider supports NIP-57 zap receipts, the customer’s browser subscribes to the Nostr relays advertised by the wallet to detect payment faster. Only the public invoice/zap request data is exchanged. Relays are operated by third parties chosen by your wallet provider. ## Installation 1. Upload the plugin ZIP from **Plugins -> Add New -> Upload Plugin**, or unzip it into wp-content/plugins/. 2. Activate **Accept Bitcoin with your Lightning Address**. 3. 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. 4. For discovery: go to **Settings -> LaWallet**, enter your LaWallet gateway endpoint and connect. The plugin verifies the endpoint before enabling the redirects. ## FAQ ### 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. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Accept Bitcoin with your Lightning Address” is open source software. The following people have contributed to this plugin. Contributors * [ magollo ](https://profiles.wordpress.org/magollo/) [Translate “Accept Bitcoin with your Lightning Address” into your language.](https://translate.wordpress.org/projects/wp-plugins/lawallet-lightning-address) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/lawallet-lightning-address/), check out the [SVN repository](https://plugins.svn.wordpress.org/lawallet-lightning-address/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/lawallet-lightning-address/) by [RSS](https://plugins.trac.wordpress.org/log/lawallet-lightning-address/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 0.2.2 * Update the bundled Spanish (es_AR, es_ES) translations to cover the new gateway, discovery, and NIP-57 strings. #### 0.2.1 * Document the Yadio exchange-rate service with links to its Terms of Service and Privacy Policy. #### 0.2.0 * 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”. #### 0.1.7 * Refresh the plugin directory icon (new lightning mark with a subtle Bitcoin watermark). #### 0.1.6 * Rename the plugin to “Accept Bitcoin with your Lightning Address” and update the short description. #### 0.1.5 * 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. #### 0.1.4 * 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. #### 0.1.3 * Point the Plugin URI to the project site (wordpress.lawallet.io). #### 0.1.2 * 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. #### 0.1.1 * 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. #### 0.1.0 * 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. ## Meta * Version **0.2.2** * Last updated **23 hours ago** * Active installations **Fewer than 10** * WordPress version ** 6.0 or higher ** * Tested up to **7.0** * PHP version ** 7.4 or higher ** * Tags * [bitcoin](https://wordpress.org/plugins/tags/bitcoin/)[Lightning](https://wordpress.org/plugins/tags/lightning/) [LNURL](https://wordpress.org/plugins/tags/lnurl/)[nostr](https://wordpress.org/plugins/tags/nostr/) [payments](https://wordpress.org/plugins/tags/payments/) * [Advanced View](https://wordpress.org/plugins/lawallet-lightning-address/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/lawallet-lightning-address/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/lawallet-lightning-address/reviews/) ## Contributors * [ magollo ](https://profiles.wordpress.org/magollo/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/lawallet-lightning-address/)