We're excited to announce the release of BTCPay Server 2.2.0 (opens new window). This major update improves accounting and coin management workflows, simplifies Lightning node management with the new LSP plugin, and brings significant enhancements to the plugin builder. It includes numerous performance and security bugfixes, and we plan for it to be the stable release upon which further updates will be built. We strongly encourage you to update as soon as possible to take advantage of all the improvements.
# 🚨Breaking Changes
In this version, we've renamed and reordered columns in what was previously known as the Legacy Invoice Export (now simply called the Invoice Export). This change introduces clearer terminology and improved structure. We understand that it may affect existing automated workflows or integrations reliant on the old format. If you need to maintain compatibility, you can easily restore the legacy version by installing the Legacy Invoice Export plugin (opens new window). We encourage transitioning to the new export for its added benefits, but this option ensures a smooth upgrade path.
# ⭐Key Features
- Reporting & accounting improvements
- Bitcoin wallet improvements
- Plugin Builder Improvements
- LSP Plugin
- NGU to BTC plugin
- Miniscript Support
- GiveWP integration
# 🧾 Reporting improvements
Streamlining your accounting workflow was our focus in this release. We’ve redesigned several features from the grounds up, based on feedback we’ve received:
- New Invoice Report: The redesigned invoice report presents data in a clearer and more structured way.
- It’s finally possible to see all Invoice Metadata associated with your invoices directly into the report. Whether you're capturing item codes from a point-of-sale, custom fields from Forms (opens new window) (such as customer emails, product sizes, or variations), or any other complex data, it now appears as a dedicated column in the invoice report!
- Transaction Fee and Rate. The Transaction Fee column displays the cost of the transaction, while the Rate column shows the exchange rate at the time the transaction occurred. Both of these new columns are visible in the “Wallet report”.
- Automatic Exchange Rate Tracking for Transactions: Exchange rates are now captured automatically when a transaction is detected. If the transaction is linked to an invoice, it uses the invoice's rate. Otherwise, it records the rate at the moment of receipt, ensuring precise historical data. Exchange rate details are now available in the wallet transaction list, wallet report and invoice report, providing a unified view that complements the new metadata exports.
- Multi-currency accounting: In your store settings, you can now specify additional currencies (e.g., USD or GBP) to track alongside your store’s default. These rates will be included as extra columns in both invoice and wallet reports.
- Improved UI allows easier access for different report types (Invoice, Payments, Payouts, Refunds, Sales, Wallet).
# 🔨 Bitcoin wallet improvements
Since our last major release, we've made significant strides in improving the Bitcoin wallet experience in BTCPay Server - specifically around coin selection and address reservation.
Coin selection has long been a core feature, but with the latest updates, it's now optimized for speed and scalability. Even users managing thousands of UTXOs can quickly filter, sort, and select the exact coins they want to use for a transaction with minimal friction.
Another major improvement is in address reservation. Previously, it was difficult to track which addresses were in use. Thanks to contributions from Thgoo, you can now clearly see addresses that have been labeled, along with when that happened. This is especially useful if you're managing a Bitcoin wallet as a team.
Combined with the multisig signing features highlighted in earlier blog posts (opens new window), these enhancements make BTCPay Server 2.2 a powerful tool for managing your Bitcoin. If you haven't already, we highly encourage you to try the built-in wallet - we think you'll find it useful!
# 🏪 Plugins
Plugins remain central to our roadmap (opens new window). Aligned with the BTCPay Server 2.2.0 release, we're also finally releasing the public 1.0 of Plugin Builder.
To view available BTCPay plugins, you'll be able to visit our Plugin Builder website (opens new window) and explore what's offered:
To improve clarity and reduce confusion, we've made changes to how plugins are displayed. When you now navigate to the Manage Plugins page of your BTCPay Server, by default, only high-quality, open-source plugins are shown. Specifically those that have been tested by many users, promoted publicly, and created by authors who have verified their contact emails. This helps users focus on well-maintained, production-ready options.
All other plugins are still available - just type their name into the search bar to find them. If you're a plugin author and your plugin isn't showing by default (and you'd like it to be), please ensure source code for your plugin is available on GitHub and your Plugin Builder email + GitHub is verified. Then reach out to us on chat.btcpayserver.org (opens new window).
Thanks to contributions from TChukwuleta (opens new window) and Thgoo (opens new window), we now have an automated CI system to support ongoing development of the Plugin Builder. This provides the foundation for continued UI/UX improvements - especially now that each author can manage the public page of their plugins.
Besides this, there are notable changes in existing, and a few new plugins.
# ⚡LSP Plugin
The new LSPS1 plugin, developed by Megalithic (opens new window) implements the client-side of the LSPS1 standard (BLIP 51 (opens new window)) to help Lightning Network nodes acquire inbound channels quickly. It's meant for BTCPay users needing inbound capacity to receive payments.
Plugin allows you to pick an LSP from the list of multiple LSPS1-compliant Lightning Service Providers (LSPs), choose a channel size and opt for public or private channels.
The plugin currently supports the following providers. Any LSP that is BLIP51 compliant can contribute and add themselves to the list.
Check out the details on GitHub (opens new window)
# 🇳🇬 BTCPay Naira Payment
This plugin (opens new window), built by TChukwuleta (opens new window), enables customers to pay merchants in Nigerian Naira (NGN) via bank transfer, while merchants receive Bitcoin, directly to their BTCPay lightning wallet. It helps merchants hedge against the inflation of the local currency. The plugin uses MavaPay (opens new window) as the offramp service.
# 🕹️ Bitcoin Switch
Bitcoin switch, by Kukks (opens new window), allows you to connect a BTCPay Server instance to the Bitcoin Switch (opens new window) hardware.
# 🔄 Plugin updates
- Satoshi ticket: (opens new window) Added check-in functionality, including: Manual check-in QR code scanning check-in plugin UI and tickets improvements.
- BigCommerce (opens new window): Now captures taxes and additional fees during payment.
# 🎁 GiveWP Integration
Our new GiveWP integration allows 100 000+ GiveWP users to accept Bitcoin donations to their website, directly to their wallet, without fees. GiveWP (opens new window) is a top-rated donation plugin for WordPress, used by nonprofits and creators to raise money online.
Check out our setup guide (opens new window) to get started.
# 🐛 Bug Fixes and Improvements
This release also addresses several issues to improve stability and user experience:
- Fixed line break rendering in dropdowns using html-translate (#6820 (opens new window)
- Fixed timezone mismatch in receipts #6832 (opens new window) #6756 (opens new window)
- Fixed problem that plugin could not use types provided by another plugin. #6851 (opens new window)
- Fixed crowdfund number formatting for non-English locales #6863 (opens new window) Improved responsiveness and UX of the Reporting page #6846 (opens new window)
- Added a "Reporting" button for easier access to reports from the invoice and wallet transactions lists #6841 (opens new window) #6835 (opens new window)
# 💚 Thank you
We’re excited to share this update with you. Huge thanks to our contributors for making it possible, and to our supporters for helping keep BTCPay Server sustainable, free, and open-source.
Most of all, thank you for using BTCPay, sharing feedback, and spreading the word. Join the conversation in our community channels to share your feedback and ideas and help us keep improving.
The BTCPay Server team 💚