Administer BTCPay Store

This post is also available in: German

BTCPay Shop administrieren


The BTCPay Shop or BTCPay Store manual is divided into four pages:

In Part 2 – BTCPay Shop Setup the general settings (General Settings) have been made.

Part 3 deals with the setting options for:


Within Rates, the exchange rate and currencies are configured.

To convert the currency used in an online store (for example Euro, USD or another Fiat currency) to Bitcoin, a conversion value must be used. The value should always correspond to the exchange rate valid at the time of payment. Therefore the BTCPay Store queries the current price at a stock exchange.

BTCPay Store Manage Store Rates

By default the course of Coin Gecko is set. You have the possibility to choose the stock exchange yourself.

In the field “Add a spread on exchange rate of … ” is set to 0. This means that one takes 1:1 the exchange rate of the exchange as a basis. You can also set a small mark-up to achieve a hidden margin over the exchange rate.

The “Default currency pairs” field determines which currencies to switch to. This depends on the currencies that are required in your store. If your shop shows the products in Euros, then you have to deposit the trading pair BTC_EUR. If your shop is in USD or in pounds, then all values: BTC_USD, BTC_EUR, BTC_GBP

Save the currency pairs required for your store and run a test. Then you will receive the respective courses, which will be used as the basis for calculation at this time.

Exchange rate pairs with Coin Gecko

Checkout Experience

In the Checkout Experience area the settings for the payment page or checkout page are made. This includes the settings and also the individual optical adjustment.

BTCPay Store Checkout Payment

Anyone who offers Bitcoin and Lightning as a payment method to their customers can specify at “Default payment method on checkout” which of the two payment methods should be displayed first.

In the area “Enable payment methods only when amount is…” you can define for which invoice amount, which payment method should be offered to the customer. Lightning (Off-Chain) is predestined for micro transactions and can be used for just a few cents. With Bitcoin payments (On-Chain), the transaction goes through the block chain and should therefore not necessarily be used for small amounts. It is recommended here rather only payments from an equivalent of two euros / USD.

However, since Lightning is not yet very widespread and one should not exclude any customers, it is recommended to choose the settings very liberally.

If the field “Requires a refund email” is activated, then within the payment page the email address of the payer is required. This can usually remain deactivated, because for example the Onlineshop software already asks for the email address.

One should not interrupt the customer request for payment by collecting unnecessary data.

If you sell a digital product which is delivered by email and should work without a separate Onlineshop software, it is recommended to activate the email input.

This would be the case, for example, with the application example “Deliver digital products by email”.

Display lightning payment amounts in Satoshis

The smallest unit of Bitcoin is Satoshi (like cents in euros or dollars). For very small amounts (micropayments), it makes sense if the price is displayed in Satoshi (sats) instead of Bitcoin. This can be specified here.

Add hop hints for private channels to the lightning invoice

With Add hop hints it is defined if the customer should be shown how far (number of hops) the own Lightning Node is from the Lightning Node of the merchant.

Redirect invoice to redirect url automatically after paid

After the successful payment the customer can either be redirected back to the store page or to the page with the payment / invoice details.

Show recommended fee

At this point, the customer can be given a recommendation on how much the transaction fee should be in order to be on the next block. The setting within the next block is already preset to 1. You can also enter a different number of blocks if you as a merchant can wait for payment.


The Appearance section defines the appearance of the payment page.

BTCPay Store Checkout Appearance

It can be specified which default language should be displayed to the payer.

In the Custom HTML section you should enter the name of the store again.

The payer is then shown the standard BTCPay payment page opposite.

BTCPay Checkout Page
Checkoutpage 1

However, this payment page can be individually designed and adapted in the look & feel of the shop page.

In das Feld Link to a custom logo kann man die URL zu dem eigenen Shop Logo eintragen.

In the field Link to a custom CSS stylesheet offers the possibility to adjust the colors according to your wishes.

Detailed instructions on how to customize the payment page can be found in the article: “Create checkout page”.

Access tokens

This area generates a token to enable communication between an external application and the BTCPay server.

This Access Token is required, for example, if you want to connect an Onlineshop to your BTCPay Store via Shopify or WooCommerce.

To establish a connection between an external application and the BTCPay Store, a token is created at BTCPay Store. This token is a legitimate proof that the external application is authorized to communicate with the BTCPay Store.

Accordingly, we create a token that we can later store in the external application.

Access Tokens

After clicking “Create a new token”, there is still the option to define a “label”.

Then click on Request Pairing and the following page appears

Administer BTCPay Store 1

The “Server initiated pairing code:” displayed at this point is then used to store this code with the external application.


In the Users section you can create additional users who should also have access to the BTCPay Store. Users can be created directly at this point and do not need to be registered via the start page of the BTCPay server.

The person who created the BTCPay Store is automatically Admin. You can give other users admin rights (Owner) or create them as Guest.

Administer BTCPay Store 2

No changes can be made as Guest, only read rights. This can be done for example be the person who will control the transactions for the accounting.

Users with Guest status cannot make any changes to the settings or make any payments.

Pay Button

The Pay Button is a kind of donation button, which you can embed on your website via HTML.

But the Pay button is also useful to test some settings. Once you have customized the payment page, you can use the pay button to test how the customer would see the payment page.

Otherwise, the pay button is the easiest and fastest way to accept Bitcoin payments as donations on its website.

Detailed instructions on how to use the Pay Button can be found in the article: “Bitcoin Pay Button

Set up paybutton


The Integration section manages external applications that can be connected to the BTCPay server.

Integrations Store Shopify

Currently the store software solution of Shopify is to be administered at this point.

Instructions for integrating Bitcoin with Shopify can be found in the article:“Accept Bitcoin with Shopify

The BTCPay Shop or BTCPay Store manual is divided into four pages:

So far all essential settings for a BTCPay store have been covered. You can start accepting the first Bitcoin payments.

If one has already taken the first turnovers successfully, the functions explained in the fourth part (part 4 – BTCPay Shop further attitude possibilities) can become interesting.

The fourth partcovers the settings of Apps, Wallets, Invoices and Payment Requests and how to use these applications for working with the BTCPay server.

This post is also available in: German