This page answers some of the common questions about alternative cryptocurrencies - altcoins.
- Which coins BTCPay Server supports?
- Can an XYZ coin be added in BTCPay?
- How to an altcoin in BTCPay?
- How to add an altcoin to an existing BTCPay deployment?
- How to remove a coin from BTCPay?
Besides, Bitcoin as the core focus of the project, BTCPay natively supports following alternative cryptocurrencies:
- Bitcoin Gold (BTG)
- Bitcoin Plus (XBC)
- Bitcore (BTX)
- Dash (DASH)
- Dogecoin (DOGE)
- Feathercoin (FTC)
- Groestlcoin (GRS)
- Litecoin (LTC)
- Monacoin (MONA)
- Polis (POLIS)
- Viacoin (VIA)
Native support means that these coins are using full nodes and that the payments are direct. There are certain third-party providers integrated which enable merchants to accept a more significant number of coins. Alternative coins are maintained by their respective communities.
No. BTCPay developers can't add alternative coins on request. Adding a new coin explicitly depends on the community and developers of those coins. Furthermore, BTCPay developers do not spend excessive time testing nor maintaining the altcoins. If you're submitting a PR for a new coin, make sure that it works. If the altcoin integration is not actively maintained it will be removed.
To add a new coin to BTCPay, please follow the instructions here.
If you want to expand the number of coins in your existing BTCPayServer installation, make sure that you have enough storage space.
In this example, we only have Bitcoin, and we're adding Litecoin to our docker deployment.
The coin structure:
BTCPAYGEN_CRYPTO1: First supported cryptocurrency (e.g., BTC, LTC. Default: btc)
BTCPAYGEN_CRYPTO2: Second supported crypto currency (e.g. btc, ltc. Default: (empty))
BTCPAYGEN_CRYPTON: N'th supported crypto currency where N is 9 at maximum. (eg. btc, ltc. Default: (empty))
To add Litecoin, as your second coin (CRYPTO2) do this :
sudo su -
export BTCPAYGEN_CRYPTO2="ltc"
. ./btcpay-setup.sh -i
In the example above we've added Litecoin as the second coin. To remove a particular coin, use the following command:
sudo su -
export BTCPAYGEN_CRYPTO2=""
. ./btcpay-setup.sh -i
Where CRYPTO02 should be replaced with a coin number you wish to remove. If you have an XYZ coin as BTCPAYGEN_CRYPTO3
, and you want to remove it, you should use CRYPTO3.