Mirror of a FOSS payment processor, alternative to Stripe, PayPal and more...
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
nicolas.dorier 575b6ca222 Improve error messages when the store has no payment method configured 13 hours ago
.circleci Remove volumes before running tests 1 month ago
BTCPayServer Improve error messages when the store has no payment method configured 13 hours ago
BTCPayServer.Tests Remove HangFire dependency 2 days ago
.dockerignore Remove launch profile from docker 1 year ago
.editorconfig Adopt dotnet core editorconfig, big reformating 1 year ago
.gitattributes shebang and fix line ending 10 months ago
.gitignore add .vscode to .gitignore 9 months ago
Dockerfile.linuxamd64 Use framework dependent build for ARM 1 month ago
Dockerfile.linuxarm32v7 Use framework dependent build for ARM 1 month ago
LICENSE new year 1 week ago
Nuget.Config Add Polis 9 months ago
README.md Update .NET Core SDK version in documentation 3 days ago
btcpayserver.sln CircleCI multiarch Docker images (#416) 1 month ago
build.ps1 chmod +x scripts 10 months ago
build.sh shebang and fix line ending 10 months ago
publish-docker.ps1 update publish-docker 9 months ago
run.ps1 chmod +x scripts 10 months ago
run.sh fix run.sh 8 months ago


BTCPay Server

Docker Automated build Deploy to Azure CircleCI

BTCPay Server


BTCPay Server is a free and open-source cryptocurrency payment processor which allows you to receive payments in Bitcoin and altcoins directly, with no fees, transaction cost or a middleman.

BTCPay is a non-custodial invoicing system which eliminates the involvement of a third-party. Payments with BTCPay go directly to your wallet, which increases the privacy and security. Your private keys are never uploaded to the server. There is no address re-use since each invoice generates a new address deriving from your xpubkey.

The software is built in C# and conforms to the invoice API of BitPay. It allows for your website to be easily migrated from BitPay and configured as a self-hosted payment processor.

You can run BTCPay as a self-hosted solution on your own server, or use a third-party host.

The self-hosted solution allows you not only to attach an unlimited number of stores and use the Lightning Network but also become the payment processor for others.

Thanks to the apps built on top of it, you can use BTCPay to receive donations or have an in-store POS system.


  • Direct, P2P Bitcoin payments
  • Lightning Network support (LND and c-lightning)
  • Altcoin support
  • Complete control over private keys
  • Full compatibility with BitPay API (easy migration)
  • Enhanced privacy
  • SegWit support
  • Process payments for others
  • Payment buttons
  • Point of sale
  • No transaction fees (other than those for the crypto networks)
  • No processing fees
  • No middleman
  • No KYC

Supported Altcoins

In addition to Bitcoin, BTCPay supports the following cryptocurrencies:

  • BGold
  • Bitcore
  • Dash
  • Dogecoin
  • Feathercoin
  • Groestlcoin
  • Litecoin
  • Monacoin
  • Polis
  • UFO
  • Viacoin


Please check out our complete documentation for more details.

You can also read the BTCPay Merchants Guide.

How to build

While the documentation advises to use docker-compose, you may want to build BTCPay yourself.

First install .NET Core SDK v2.1.6 as specified by Microsoft website.

On Powershell:


On linux:


How to run

Use the run scripts to run BTCPayServer, this example shows how to print the available command line arguments of BTCPayServer.

On Powershell:

.\run.ps1 --help

On linux:

./run.sh --help

How to debug

If you want to debug, use Visual Studio Code or Visual studio 2017.

You need to run the development time docker-compose as described in the test guide.

You can then run the debugger by using the Launch Profile Docker-Regtest on either Visual Studio Code or Visual studio 2017.

If you need to debug ledger wallet interaction, install the development time certificate with:

# Install development time certificate in the trust store
dotnet dev-certs https --trust

Then use the Docker-Regtest-https debug profile.

Other dependencies

For more information, see the documentation: How to deploy a BTCPay server instance.