# (3) Wallet Setup

After account registration and store creation, it's time to configure a wallet in your BTCPay Server, so that you can start receiving payments into it.

There are two ways to set up a wallet in BTCPay Server:

# Use an existing wallet

Using an existing wallet assumes that you already have an external wallet created and backed up.

When using an existing wallet with BTCPay Server, you're providing an extended public key (xpub) from an externally generated wallet. Extended public key is a watch-only wallet token. Providing this public key allows BTCPay Server to generate a new address each time a new invoice is created.


By using an existing wallet, you can receive payments to the external wallet, without BTCPay Server knowing the wallet's private key. If a malicious attacker hacked your server and obtained the xpub, they could observe your transaction history, but cannot access the funds.

Externally generated wallet can be used as:

# Use an existing hardware wallet

Hardware wallets provide a good balance between security and ease of use. If you already have a hardware wallet set up, you can easily use it with your BTCPay Server. Thanks to built-in hardware wallet integration the xpub key from the hardware wallet is automatically added to your BTCPay Server. The integration further allows you to spend funds received to your store within BTCPay's internal wallet


If you own a hardware wallet, follow the instructions on how to use a an existing hardware wallet with your BTCPay Server

# Use an existing software wallet

Using an existing software wallet assumes that you already have an external wallet created and backed up. In theory, any mobile/desktop wallet that provides an extended public key should work, however, most wallets have technical limitations (gap-limit) that may cause serious user-experience problems for you later on.

For that reason, we recommend that you only use software wallets listed below.

Click on the link above you will be redirected to a step by step tutorial on how to set up particular software wallet with BTCPay Server.

To spend and manage the funds received to your external software wallet, you can use an internal BTCPay Wallet and sign a transaction with your private key or simply manage the funds in that external wallet itself.

# Create a new wallet

If you do not have an existing wallet, you can generate it within your BTCPay Server. If are using a third-party host, this option needs to be explicitly enabled by the server admin. Generating a new wallet in an environment you are not sure is trustworthy, is discouraged.


When a new wallet is generated, BTCPay Server will show you a twelve word recovery seed. After the initial display, the seed is wiped from the server, unless a hot wallet option is enabled.

Anyone with access to your recovery seed can also access and steal all your funds. Securely back up your seed by writing it down and keep it in a safe place. Do not photograph it or store it in a digital format. Do not rely on your server for storing your private keys, even if you're using a hot wallet.

Follow the instructions here to learn how to generate a new wallet.

# Summary

There are many options on how set up a wallet with your BTCPay Server. It's up to you to decide what works best for your use-case. Once you configure a wallet, you're all set. The next step, is to start exploring the features.

Proceed to the next step - What's Next?.