# (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 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.


When you input an extended public key starting with yPub or zPub as a derivation scheme, BTCPay Server automatically converts it to the xPub format. This has no incidence on how you receive or send funds.


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 a new one 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 recovery 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 (current AND future funds!), since a private key is derived from a recovery seed. 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 solely on your server for storing your recovery seed, 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?.