BTCPay Server

How to connect to BTCPay Server

BTCPay Server is a self-hosted, open-source cryptocurrency payment processor and it's free. 🏪

Who uses BTCPay Server today:

  • Merchants who sell products and services online or in person

  • Charities and non-profits looking to accept donations or crowdfund their dream project

  • Developers building on top of bitcoin and payment infrastructure

  • Members of local communities willing to onboard people to their BTCPay instance and offer payment processing as a service or for free, creating a circular economy.

To be able to receive payments you need to configure a wallet. There are several options available.

Your Alby Account with its integrated wallet is one of these options. It is convenient to use, because you do not have to care about node and liquidity management. It works out of the box. BUT it is custodial.

Let's have a look how you can connect your Alby Account to your BTCPay Server, there are two ways, the using LNDHUB (old way) or using NWC(we hightly recommend to use NWC):


1. NWC

(Recommended method to connect BTCPayserver + Alby Hub)

Connect your BTCPay Server to your Alby Hub using Nostr Wallet Connect (NWC), which we recommend for most users. This method requires installing the Nostr plugin in your BTCPay Server and then creating either a regular or isolated connection in the Connections section of your Alby Hub. The steps are similar to the the old method (LNDHub), the only difference is that you will be using a NWC connection secret obtained from inside your Alby Hub's connection section. For a full step-by-step guide, follow this article: https://blog.getalby.com/manage-btcpay-server-with-any-node-or-wallet-with-nwc/


2. LNDHub

(Deprecrated)

Warm-up step 1: Register an account on the demo app or on an hosted BTCPay Server instance.

Warm-up step 2: Create a store

_______________________________________________________________________________________________________

Now we are ready to configure a wallet in your BTCPay Server, so that you can start receiving payments.

Step 1: Click on 'Set up a Lightning node' or on 'Lightning'

Step 2: Insert your LNDhub credentials and click on 'Test connection'. You'll find them:

In your dashboard on getalby.com: Go to the "Connect" page and select 'LNDHub credentials'. Now you can create your LNDHub credentials.

Congrats. You successfully connected your Alby Account. 🎉

Click on 'Save' and you are done

Now you are ready to receive donations or sell goods and services for bitcoin.

To make the best out of BTCPay Server, check out this documentation about features, integrations into e-commerce platforms and plugins.

Last updated