Set up a BTCPay Store

Within General Settings there is the General section.

In the ld field you can find the Store ID. The Store ID is assigned by the system and cannot be changed.

In the Store Name field you can give your store a name of your own. This store name will also be displayed later on the payment page.

The URL of the online store can be stored in the Store Website field.

The “Allow anyone to create invoice” field is disabled by default. Those who want to use one of the apps used by BTCPay Server can also leave this field unchecked. Those who want to use a Shopify online store with the BTCPay store can also leave the checkmark unchecked. For all other external applications it is necessary that the checkmark is set. This allows external applications (via API) to create invoices on the BTCPay server, which then ensure that a Bitcoin payment page is displayed.

Enable Payjoin/P2EP

Payjoin can increase the privacy of a Bitcoin payment between the payer and the payee (merchant). In case of doubt, this function should remain deactivated.

Add additional fee

The field “Add additional fee (network fee) to invoice” is about an additional fee that can be charged if an end customer sends the invoice amount in numerous partial amounts. Network fees for a payment are always borne by the payer. If a merchant wants to forward the incoming payment to another Bitcoin address later, he has to bear the network fee himself. The amount of this fee depends, among other things, on how many previous incoming transactions make up the new forwarding transaction. You can protect yourself from these more in fees by leaving the default setting as it is, and only charging an additional fee if a payment is made in multiple installments.

Invoice expires

The payer is shown a QR code on the payment page / checkout page for a certain time, through which the Bitcoin are sent. The requested Bitcoin amount has been calculated based on the exchange rate. Since the exchange rate is very volatile and can change permanently, the exchange rate should remain valid only for a limited time.

It is recommended that the exchange rate is guaranteed to the customer for 15 minutes. This is a period that is granted by almost all dealers. Accordingly, it is recommended to leave the value in the “Invoice expires if the full amount has not been paid after … minutes” field at 15 minutes.

Payment invalid if transactions fails to confirm

After the payment is made, it still takes time for the receipt to be credited to the merchant’s wallet. This may depend on how high the network fee the payer was willing to pay. If the payer has paid no network fee at all or only a very small one, a transaction may take a little longer. To protect yourself as a merchant from the Bitcoin price fluctuating too much in the meantime, you can set “Payment invalid if transactions fails to confirm … minutes after invoice expiration” to specify how long it may take until the payment is confirmed by the network. The default setting is one day (=1440 minutes).

Consider the invoice paid even if the paid amount is

The question “Consider the invoice paid even if the paid amount is … % less than expected” is about underpayments of the invoice amount. The system expects a certain amount of bitcoin. If fewer satoshi actually arrive, there is an underpayment.

This can happen if the payment is not made directly from the payer’s wallet, but from an exchange or currency exchange. In this case, the network fee is deducted from the credit balance when a withdrawal is made and correspondingly less is received.

What is the procedure to be followed? Should the payment be rejected or is there a tolerance at which you are still willing to accept the payment anyway? 0% tolerance is accepted as standard.

Regardless of whether you use the XPub key of an external Bitcoin wallet or the internal BTCPay Bitcoin wallet, you have to store the data via Modify.

Thus, customers’ Bitcoin payments are credited directly to the corresponding Bitcoin wallet.

If you use the internal Bitcoin wallet, then the Wallet link will appear later. The wallet link takes you to the administration area of the Bitcoin wallet.

To learn how to enable Lightning for the BTCPay store, see the “Setting up BTCPay Lightning payments in the BTCPay store” guide.

Additional Payments

In the Additional Payments section, there is an option to offer additional cryptocurrencies to its customers. Here, as a trader, an account with the provider CoinSwitch is required.

CoinSwitch offers more than 50 other cryptocurrencies for payment. The customer (payer) can use one of the cryptocurrencies listed there for payment. The cryptocurrency used by the customer will be exchanged into bitcoin by CoinSwitch. These bitcoin are then credited to the trader’s bitcoin account.

Services

Email settings can be stored in the Services area. As the operator of your own BTCPay server, the central email settings are made via the Server Settings. However, you can also store your own email settings for a BTCPay store. This is possible at this point.