๐Ÿ“– Tronsell Wiki

BTCPay Server: Complete Guide

Everything you need to know about BTCPay Server โ€“ the free, open-source, self-hosted cryptocurrency payment processor. Features, setup, fees, supported coins, plugins, and comparisons.

๐Ÿ”“ BTCPay Server at a Glance
License MIT (Open Source)
Supported Coins BTC, LTC, XMR, DOGE, DASH, + plugins
Transaction Fee 0% (self-hosted)
Platforms WooCommerce, Shopify, Magento, + custom API
Lightning Network โœ… Native Support
Type Self-Custodial ยท Self-Hosted

๐Ÿ”“ What is BTCPay Server?

BTCPay Server is a free, open-source, self-hosted cryptocurrency payment processor. It allows merchants to accept Bitcoin and other cryptocurrencies directly to their own wallets without any third-party custodian. Created in 2017 as a response to the shutdown of BitPay's free tier, BTCPay Server has become the gold standard for merchants who value financial sovereignty, privacy, and zero processing fees.

Unlike centralized payment gateways, BTCPay Server gives merchants complete control over their payment infrastructure. Payments go directly to the merchant's wallet, and the server can be hosted on any VPS, cloud instance, or even a Raspberry Pi. With native Lightning Network support, BTCPay Server enables instant, low-cost Bitcoin payments.

๐Ÿ’ก Why Merchants Choose BTCPay Server

BTCPay Server is trusted by thousands of merchants worldwide. Its zero-fee model, self-custodial nature, Lightning Network support, and open-source transparency make it the ultimate payment solution for businesses that prioritize sovereignty and cost savings.

๐Ÿช™ Supported Cryptocurrencies

BTCPay Server natively supports Bitcoin (BTC) and Bitcoin testnet. Through plugins and community integrations, it also supports several other cryptocurrencies:

โ‚ฟ
Bitcoin & Lightning

BTC (on-chain & Lightning Network) with full support for SegWit, Taproot, and more.

๐Ÿ”ท
Altcoin Support (Plugins)

Litecoin, Monero, Dogecoin, Dash, and other coins via community-developed plugins.

๐Ÿ”Œ
Custom Assets

Support for custom tokens and assets can be added through the modular plugin system.

โšก
Lightning Network

Integrated Lightning Node (LND, CLN) for instant, low-fee Bitcoin payments.

BTCPay Server's native focus is Bitcoin and Lightning, but the plugin ecosystem allows merchants to accept a growing list of altcoins.

๐Ÿ’ฐ Fees & Pricing

BTCPay Server's fee structure is one of its most attractive features. There are no transaction fees โ€“ the software is entirely free and open-source. Costs include:

Cost Type Estimated Cost Notes
BTCPay Server Software $0 MIT licensed, completely free
Server Hosting (VPS) $5 โ€“ $50/month Depends on traffic and storage needs
Blockchain Network Fees Variable (network-determined) Paid by the merchant or passed to customers
Lightning Network Fees ~0.1% โ€“ 0.5% Dynamically adjusted based on network conditions
Third-Party Services (optional) Varies For exchange rate feeds, email notifications, etc.
๐Ÿ’ก Zero-Fee Advantage

BTCPay Server charges zero transaction fees. Merchants only pay blockchain network fees, which can be passed to customers or covered by the merchant. Over time, this can represent significant savings compared to 0.5%โ€“1% fee gateways.

โšก Lightning Network Integration

BTCPay Server offers native Lightning Network support, making it one of the most powerful self-hosted solutions for accepting Bitcoin Lightning payments.

โšก
Lightning Node Integration

Connect your own LND, Core Lightning (CLN), or Eclair node for full Lightning payment processing.

๐Ÿ”Œ
Lightning Invoices

Generate Lightning invoices automatically, with sub-second confirmation and near-zero fees.

๐Ÿ“Š
Lightning Dashboard

Monitor Lightning channel balance, transactions, and node health directly from BTCPay Server.

๐Ÿ”—
Lightning Address

Create human-readable Lightning Addresses for receiving payments without invoices.

โšก Lightning Advantage

BTCPay Server's Lightning integration gives merchants the ability to accept Bitcoin payments with settlement in seconds and fees often below $0.01. This is particularly valuable for high-volume, low-margin businesses.

๐Ÿ› ๏ธ Setup & Deployment

BTCPay Server can be deployed in several ways, ranging from one-click installations to fully manual setups:

  • 1
    Choose a deployment method

    Use one-click deploy on LunaNode (official partner), deploy on a VPS (DigitalOcean, AWS, etc.) with Docker, or run on a Raspberry Pi for small setups.

  • 2
    Set up your Bitcoin node

    BTCPay Server requires a Bitcoin full node. You can run your own node or connect to an external one (e.g., a public node with caution).

  • 3
    Configure your Lightning node (optional)

    For Lightning support, set up LND, CLN, or Eclair and connect it to BTCPay Server.

  • 4
    Set up store and payment methods

    Create your store, configure checkout settings, and choose which payment methods to accept (BTC on-chain, Lightning, altcoins).

  • 5
    Integrate with e-commerce

    Install plugins for WooCommerce, Shopify, Magento, or use the REST API for custom integrations.

๐Ÿ’ก Deployment Tip

The official BTCPay Server documentation provides detailed guides for each deployment method. The LunaNode one-click deploy is the easiest way to get started in under 30 minutes.

๐Ÿ”Œ Plugins & Integrations

BTCPay Server has a rich ecosystem of plugins and integrations:

๐Ÿ›’
E-Commerce Plugins

WooCommerce, Shopify, Magento, PrestaShop, Drupal, and many more.

๐Ÿช™
Altcoin Plugins

Litecoin, Monero, Dogecoin, Dash, and other cryptocurrency support via plugins.

๐Ÿ“Š
Analytics & Reporting

Export transactions, generate reports, and integrate with accounting software.

๐Ÿ””
Notifications

Email alerts, webhooks, and Zapier integration for automated workflows.

๐ŸŒ
Exchange Rate Feeds

Real-time price feeds from multiple exchanges for accurate fiat conversion.

๐Ÿ”’
Security Plugins

2FA, IP whitelisting, and rate limiting for enhanced security.

๐Ÿ”’ Security & Self-Custody

BTCPay Server's security model is built around self-custody and transparency:

  • Self-custodial โ€“ private keys never leave your control. Funds go directly to your wallet.
  • Open source โ€“ the code is publicly auditable, and the community reviews all contributions.
  • Regular updates โ€“ active development with frequent security patches.
  • Secure by design โ€“ minimal attack surface, with optional 2FA and IP whitelisting.
  • Lightning security โ€“ Lightning nodes can be managed with watchtowers for additional protection.
๐Ÿ›ก๏ธ Self-Custody Advantage

BTCPay Server eliminates counterparty risk entirely. Since you run your own server and control your own keys, there is no third party that can freeze, seize, or censor your payments.

โš–๏ธ BTCPay Server vs Other Gateways

Feature BTCPay Server CoinPayments NOWPayments CoinGate
Supported Coins BTC (native), altcoins via plugins 100+ 100+ 70+
Transaction Fee 0% 0.5% 0.5% 1%
Lightning Network โœ… Native โŒ โŒ โœ… Native
Self-Custodial โœ… โŒ โœ… โŒ
Hosting Self-hosted Custodial Cloud Custodial
Open Source โœ… (MIT) โŒ โŒ โŒ
Fiat Settlement โŒ โœ… โœ… โœ…

๐ŸŒ Use Cases & Industries

๐Ÿ›๏ธ
E-commerce

Online stores using WooCommerce, Shopify, or custom platforms.

๐Ÿ’ป
SaaS & Subscriptions

Recurring billing for software, hosting, and membership sites.

๐ŸŽฎ
Gaming & iGaming

In-game purchases, casino payments, and virtual goods.

โค๏ธ
Nonprofits

Accept donations with zero fees and full transparency.

๐Ÿ”’
Privacy-Focused Businesses

Merchants who prioritize financial sovereignty and privacy.

๐Ÿ† Best Practices for BTCPay Server Merchants

  • Enable Lightning Network โ€“ offer Lightning payments to attract customers who prefer instant, low-cost Bitcoin transactions.
  • Use a reliable hosting provider โ€“ choose a VPS with good uptime and scalability for your transaction volume.
  • Set up proper backups โ€“ regularly back up your server configuration, wallet seeds, and Lightning node data.
  • Keep your server updated โ€“ regularly update BTCPay Server and your node software for security patches.
  • Monitor your Lightning channels โ€“ keep sufficient inbound and outbound liquidity for smooth Lightning payments.
  • Use 2FA and IP whitelisting โ€“ secure your admin interface against unauthorized access.

โ“ Frequently Asked Questions

What is BTCPay Server?

BTCPay Server is a free, open-source, self-hosted cryptocurrency payment processor. It allows merchants to accept Bitcoin and other cryptocurrencies directly to their own wallets without any third-party custodian.

How much does BTCPay Server cost?

BTCPay Server is completely free and open-source. The only costs are server hosting fees (e.g., VPS, cloud hosting) and blockchain network transaction fees.

Which cryptocurrencies does BTCPay Server support?

BTCPay Server natively supports Bitcoin (BTC) and Bitcoin testnet. Through plugins and community integrations, it also supports Litecoin, Monero, Dogecoin, Dash, and other altcoins.

How do I set up BTCPay Server?

BTCPay Server can be deployed via one-click install on LunaNode, or manually on a VPS using Docker. The official documentation provides comprehensive setup guides for various hosting environments.

Does BTCPay Server support the Lightning Network?

Yes. BTCPay Server includes native Lightning Network integration through LND, Core Lightning (CLN), or other compatible Lightning nodes, enabling instant, low-cost Bitcoin payments.

Can I accept fiat settlement with BTCPay Server?

No. BTCPay Server is a self-hosted cryptocurrency payment processor and does not offer direct fiat settlement. Merchants can use third-party services or exchanges to convert crypto to fiat.

โšก Save on Every USDT Transfer with Tron Energy

Stop burning TRX on transaction fees. Buy or rent Tron Energy from Tronsell โ€” instant delivery, competitive rates, no TRX lockup required.