{"id":23888,"date":"2026-03-10T14:48:06","date_gmt":"2026-03-10T13:48:06","guid":{"rendered":"https:\/\/coincharge.io\/set-up-the-btcpay-boltz-plugin\/"},"modified":"2026-03-10T14:58:58","modified_gmt":"2026-03-10T13:58:58","slug":"set-up-the-btcpay-boltz-plugin","status":"publish","type":"post","link":"https:\/\/coincharge.io\/en\/set-up-the-btcpay-boltz-plugin\/","title":{"rendered":"Set up the BTCPay Boltz plugin"},"content":{"rendered":"
[vc_row][vc_column][vc_column_text css=”.vc_custom_1773061710981{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

Set up the BTCPay Boltz plugin<\/strong><\/span><\/h1>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1773060742539{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

Receive Lightning payments without Lightning Node directly to your own hardware wallet (BitBox example)<\/strong><\/h2>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=””]\n

Many BTCPay server operators want to offer their customers not only traditional Bitcoin onchain payments, but also Lightning payments. In practice, this often fails due to the additional complexity: if you want to operate Lightning with your own node, you have to take care of channels, liquidity, rebalancing, backups and ongoing operations. This is where the BTCPay Boltz plug<\/strong> in becomes interesting. The plugin makes it possible to accept Lightning payments in a non-custodial setup without having to operate a Lightning node yourself. According to the official Boltz documentation, the plugin supports two operating modes: rebalance mode for existing Lightning nodes and a nodeless mode for merchants without their own node.<\/p>\n

This is particularly exciting for merchants if all revenue is to end up on their own hardware wallet<\/strong>. In this article, I will show you step by step how to set up the Boltz BTCPay plugin<\/strong> so that your BTCPay server accepts both on-chain payments<\/strong> and lightning payments<\/strong> and the Bitcoin then ends up on the same hardware wallet<\/strong>. As an example, I use a BitBox wallet<\/strong> and the corresponding zpub key<\/strong>. BTCPay explicitly supports watch-only wallets, so the server can generate addresses and monitor payments without storing the private keys.<\/p>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_message message_box_color=”grey” css=””]Briefly explained:<\/strong>
With the BTCPay Boltz plugin<\/strong>, a BTCPay server can receive Lightning payments without operating its own Lightning node. In nodeless mode, a Lightning payment via Boltz is first converted into Liquid Bitcoin (L-BTC)<\/strong>. The balance can then be automatically swapped back into Bitcoin on the mainchain<\/strong>. This means that both on-chain and Lightning revenues can end up on the same hardware wallet.[\/vc_message][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1773062013746{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

Who is this setup intended for?<\/strong><\/h2>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=””]\n

This guide is aimed at anyone who already operates their own BTCPay server<\/strong> or is in the process of setting one up and does not<\/strong> want to<\/strong> operate their own Lightning Node<\/strong>. Typical use cases are merchants, freelancers, online stores or associations that want to accept Bitcoin as easily as possible, but still value self-custody<\/strong> and their own hardware wallet. BTCPay describes itself as a self-hosted and non-custodial payment gateway where payments go directly to your own wallet.<\/p>\n

The setup is particularly interesting if you want the following:
Onchain payments should go directly to your Bitcoin wallet. Lightning payments should also be accepted. And in the end, both payment types should converge in the same wallet, for example on a BitBox. This is possible with the BTCPay Boltz plugin<\/strong>, because BTCPay can work with a watch-only wallet for the Bitcoin side, while the Boltz plugin processes the Lightning payment via swap.<\/p>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1773062047132{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

What is the BTCPay Boltz plugin?<\/strong><\/h2>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=””]\n

The Boltz BTCPay plug<\/strong> in is a plugin for BTCPay Server that allows merchants to accept Lightning payments non-custodially. According to the official documentation, the plugin can either automatically manage the liquidity of an existing Lightning node or accept Lightning payments without a separate node. In the second case, the plugin works with Lightning-to-Liquid swaps<\/strong>.<\/p>\n

The technical logic is important here: in nodeless mode, a Lightning payment is not received directly on Bitcoin Mainchain. Instead, BTCPay creates a swap for the same amount via Boltz. After a successful Lightning payment, the amount is paid out to a Liquid Wallet<\/strong> minus fees. Boltz himself explains that Liquid is the only option in this mode because the network fees there are reliably low and even smaller Lightning payments remain economical.<\/p>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1773062083021{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

How does the setup work technically?<\/strong><\/h2>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=””]A quick look at the payment flow will help you to explain or document the setup properly later on.[\/vc_column_text][\/vc_column][\/vc_row][vc_row css=”.vc_custom_1738351904557{border-top-width: 3px !important;border-right-width: 3px !important;border-bottom-width: 3px !important;border-left-width: 3px !important;padding-top: 10px !important;padding-bottom: 10px !important;border-left-style: solid !important;border-right-style: solid !important;border-top-style: solid !important;border-bottom-style: solid !important;border-color: #6193C9 !important;}”][vc_column][vc_column_text css=””]\n

Onchain payment <\/strong><\/span><\/h3>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=””]With a normal Bitcoin onchain payment, everything works in the classic way:
BTCPay generates a new receiving address from the stored zpub\/xpub<\/strong>. The customer pays directly to this address. The Bitcoin ends up in the wallet that belongs to this zpub. Watch-only wallets in BTCPay can be used for precisely this purpose: Derive addresses, monitor payments, but not issue coins independently.[\/vc_column_text][\/vc_column][\/vc_row][vc_row css=”.vc_custom_1738351904557{border-top-width: 3px !important;border-right-width: 3px !important;border-bottom-width: 3px !important;border-left-width: 3px !important;padding-top: 10px !important;padding-bottom: 10px !important;border-left-style: solid !important;border-right-style: solid !important;border-top-style: solid !important;border-bottom-style: solid !important;border-color: #6193C9 !important;}”][vc_column][vc_column_text css=””]\n

Lightning payment <\/strong><\/span><\/h3>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=””]\n

The process is different for a Lightning payment in Boltz Nodeless Mode:
The customer pays via Lightning. Boltz executes a Lightning \u2192 Liquid Swap<\/strong>. The result initially ends up in a Liquid Wallet<\/strong>. The balance can then be automatically converted back into Bitcoin Mainchain<\/strong> via chain swap<\/strong>. The Bitcoin wallet already configured in the store then serves as the destination. BTCPay describes precisely this logic in its Lightning documentation for swapping services such as Boltz.<\/p>\n

The practical effect is crucial:
The merchant does not<\/strong> need its own Lightning Node<\/strong>, but can still accept Lightning payments. In the end, the same Bitcoin wallet target can be used for on-chain payments and for the BTC swapped back from Lightning.<\/p>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1773062495849{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

What you need for the setup<\/strong><\/h2>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=””]Before you start, you should have these things ready:[\/vc_column_text][vc_column_text css=”.vc_custom_1773062523667{margin-left: 50px !important;}”]\n
    \n
  • a running BTCPay server<\/strong><\/li>\n
  • Access to server settings<\/strong><\/li>\n
  • Access to Manage Plugins<\/strong><\/li>\n
  • a BitBox wallet<\/strong> or another hardware wallet<\/li>\n
  • the zpub or xpub<\/strong> of the wallet that is to serve as the Bitcoin target wallet<\/li>\n
  • optional Sparrow Wallet<\/strong>, if you want to conveniently read or check the zpub<\/li>\n<\/ul>\n[\/vc_column_text][vc_column_text css=””]BTCPay documents various ways to set up wallets, including watch-only wallets based on extended public keys. For hardware wallets, BTCPay recommends setups in which the private keys remain on the device.[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1773062607544{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

    Step 1: Set up the Bitcoin wallet in the BTCPay server<\/strong><\/h2>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_row_inner][vc_column_inner width=”1\/2″][vc_column_text css=””]\n

    The first step is to set up your normal Bitcoin wallet in the store. This wallet will later be used twice:
    firstly for direct on-chain payments and secondly as a target wallet for the automatically re-swapped Lightning earnings.<\/p>\n

    Open the Wallets<\/strong> section in your store and set up your Bitcoin wallet<\/strong> there. If you are working with a BitBox, the cleanest way is a watch-only wallet<\/strong> based on zpub\/xpub<\/strong>. BTCPay explicitly describes watch-only wallets as wallets where no private keys are stored on the server.<\/p>\n[\/vc_column_text][\/vc_column_inner][vc_column_inner width=”1\/2″][vc_single_image image=”23840″ img_size=”full” alignment=”center” onclick=”link_image” css=””][\/vc_column_inner][\/vc_row_inner][vc_column_text css=””]\n

    In practice, this means:
    You take the zpub<\/strong> of your BitBox wallet and store it in BTCPay. From this moment on, BTCPay can derive new Bitcoin receiving addresses. The coins still belong to your BitBox wallet. BTCPay cannot issue them as long as only the public key is stored.<\/p>\n

    Important for this setup:<\/strong>
    You do not<\/strong> need a second zpub<\/strong> for Lightning. The same zpub can also be used later for the Bitcoin target wallet of the Boltz Chain swaps. As long as BTCPay manages this wallet, the system can use addresses from the same wallet pool for on-chain payments and for the Bitcoin coming back from Lightning. This corresponds to the normal behavior of an HD\/watch-only wallet in BTCPay.<\/p>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1773062705182{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

    Step 2: Install the BTCPay Boltz plugin<\/strong><\/h2>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_row_inner][vc_column_inner width=”1\/2″][vc_column_text css=””]\n

    Next, install the plugin at server level.<\/p>\n

    To do this, go to Server Settings<\/strong> and then to Manage Plugins<\/strong>. There you install the Boltz plugin<\/strong>. After installation, a separate area for Boltz will appear in the navigation. Boltz explicitly documents this installation path for self-hosted BTCPay servers.<\/p>\n[\/vc_column_text][\/vc_column_inner][vc_column_inner width=”1\/2″][vc_single_image image=”23847″ img_size=”full” alignment=”center” onclick=”link_image” css=””][\/vc_column_inner][\/vc_row_inner][vc_column_text css=””]If you are running a shared BTCPay server or have multiple users on the server, you should also note that administrators can or must manually enable the plugin for tenants. The Boltz documentation calls the option Admin \u2192 Advanced \u2192 Allow Plugin for Tenants<\/strong>.[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1773062742988{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

    Step 3: Select the right mode<\/strong><\/h2>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=””]After installation, start the configuration in the Boltz area. There are two operating modes to choose from:[\/vc_column_text][vc_row_inner][vc_column_inner width=”1\/2″][vc_column_text css=”.vc_custom_1773062771586{margin-left: 50px !important;}”]\n
      \n
    • Rebalance existing Lightning node<\/strong><\/li>\n
    • Accept Lightning payments without running a node<\/strong><\/li>\n<\/ul>\n[\/vc_column_text][vc_column_text css=””]The second option is the right one for this tutorial:
      Accept Lightning payments without running a node.<\/strong>[\/vc_column_text][\/vc_column_inner][vc_column_inner width=”1\/2″][vc_single_image image=”23850″ img_size=”full” alignment=”center” onclick=”link_image” css=””][\/vc_column_inner][\/vc_row_inner][vc_column_text css=””]\n

      This is the so-called Nodeless Mode<\/strong>. It is intended precisely for operators who want to offer Lightning but do not operate their own Lightning Node. According to Boltz, the plugin is one of the solutions that allows merchants to accept Lightning payments non-custodially without having to operate a Lightning Node themselves.<\/p>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1773062807551{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

      Step 4: Check fees and swap model<\/strong><\/h2>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=””]\n

      In the next step, the plugin shows you an overview of fees, network fees and minimum and maximum amounts. At the same time, it explains that the nodeless mode works via Lightning \u2192 Liquid Swaps<\/strong>. This is exactly the core of the setup: Lightning does not become on-chain Bitcoin directly, but first becomes L-BTC<\/strong>.<\/p>\n[\/vc_column_text][vc_row_inner][vc_column_inner][vc_single_image image=”23854″ img_size=”full” alignment=”center” onclick=”link_image” css=””][\/vc_column_inner][\/vc_row_inner][vc_column_text css=””]The key information for merchants is:
      They do not receive lightning payments on a lightning node, but via a swap process. The advantage is the lower technical complexity. The disadvantage is that Liquid is used as an intermediate layer and additional swap fees may be incurred. BTCPay explicitly mentions swapping services such as Boltz as an option for automatically converting Lightning into on-chain Bitcoin or L-BTC.[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1773062867185{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

      Step 5: Create the internal Liquid Wallet<\/strong><\/h2>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=””]\n

      The plugin will now ask you for a wallet for the L-BTC inputs. For this setup, select :<\/p>\n

      Create a new wallet<\/strong><\/p>\n[\/vc_column_text][vc_row_inner][vc_column_inner][vc_single_image image=”23858″ img_size=”full” alignment=”center” onclick=”link_image” css=””][\/vc_column_inner][\/vc_row_inner][vc_column_text css=””]\n

      BTCPay then creates a new internal Liquid Wallet<\/strong>, which serves as the destination for the Lightning-to-Liquid swaps. Boltz describes exactly this step in his documentation: Merchants can create a new wallet or import an existing Liquid Wallet. The internal BTCPay Liquid Wallet is sufficient as an intermediate stage.<\/p>\n[\/vc_column_text][vc_single_image image=”23861″ img_size=”full” alignment=”center” onclick=”link_image” css=””][vc_row_inner][vc_column_inner width=”1\/2″][vc_column_text css=””]\n

      BTCPay will then show you a recovery phrase<\/strong>. You should make a secure note of this. At the same time, BTCPay points out that this wallet is stored as a hot wallet<\/strong> on the server. This is important when considering security: the internal liquid wallet is a practical intermediate station for the swaps, but it is not the same as a cold wallet.<\/p>\n[\/vc_column_text][vc_column_text css=””]\n

      You do not<\/strong> need an external Liquid Wallet<\/strong> if you only want to use the standard setup with the Boltz plugin. The internal BTCPay Liquid Wallet is sufficient as an intermediate stage.<\/p>\n[\/vc_column_text][\/vc_column_inner][vc_column_inner width=”1\/2″][vc_single_image image=”23863″ img_size=”full” alignment=”center” onclick=”link_image” css=””][\/vc_column_inner][\/vc_row_inner][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1773062911935{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

      Step 6: Set up chain swaps<\/strong><\/h2>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=””]\n

      In the next step, you configure the automatic reconversion from L-BTC<\/strong> to Bitcoin Mainchain<\/strong>. In the plugin, this section is called Set Up Chain Swaps<\/strong>.<\/p>\n[\/vc_column_text][vc_row_inner][vc_column_inner width=”1\/2″][vc_column_text css=””]\n

      Here you typically define two values:<\/p>\n[\/vc_column_text][vc_column_text css=”.vc_custom_1773062939849{margin-left: 50px !important;}”]\n

        \n
      • Max Balance<\/strong><\/li>\n
      • Reserve Balance<\/strong><\/li>\n<\/ul>\n[\/vc_column_text][\/vc_column_inner][vc_column_inner width=”1\/2″][vc_single_image image=”23869″ img_size=”full” alignment=”center” onclick=”link_image” css=””][\/vc_column_inner][\/vc_row_inner][vc_column_text css=””]\n

        The logic behind this is simple:
        The internal Liquid Wallet is allowed to hold credit up to a certain threshold value. If this value is exceeded, the plugin starts a chain swap<\/strong> back to the Bitcoin mainchain. A partial amount can remain in Liquid as a reserve. Boltz explicitly describes this function as an optional step to automatically convert L-BTC back into regular Bitcoin.<\/p>\n

        For traders who want to have as much as possible directly on their hardware wallet, a rather low max balance usually makes sense. This means that only a small amount of Liquid credit remains on the server and the majority is automatically converted back into normal BTC. This significantly improves the practicality of the setup, even if additional fees may be incurred.<\/p>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1773063129975{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

        Step 7: Select the same BitBox wallet as the BTC target wallet<\/strong><\/h2>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=””]\n

        Now comes the crucial part for your desired setup.<\/p>\n

        The plugin asks where the on-chain Bitcoin from the chain swaps<\/strong> should be sent. Here you select the Bitcoin wallet already set up in the store<\/strong>, i.e. BTCPay. The Bitcoin address created in step 1 is then used.
        \nIn our example, the stored xpub or zpub key.<\/p>\n[\/vc_column_text][vc_row_inner][vc_column_inner width=”1\/2″][vc_column_text css=””]\n

        This is exactly what makes the setup elegant:
        Both direct on-chain payments and the Lightning income swapped back via Boltz end up in the same wallet structure. The merchant therefore does not need two different Bitcoin wallets, but only a single watch-only Bitcoin wallet in the store<\/strong>.<\/p>\n[\/vc_column_text][\/vc_column_inner][vc_column_inner width=”1\/2″][vc_single_image image=”23872″ img_size=”full” alignment=”center” onclick=”link_image” css=””][\/vc_column_inner][\/vc_row_inner][vc_column_text css=””]\n

        This is also the answer to the frequent practical question:
        Is a single zpub of the BitBox sufficient?<\/strong>
        Yes, a single zpub\/xpub of the BitBox wallet is sufficient for this setup if it is already stored in the store for on-chain payments and the same wallet is selected as the destination of the chain swaps in the Boltz plugin. BTCPay can manage receiving addresses based on this public key without the merchant having to disclose their private keys.<\/p>\n

        Alternatively, you can also use another on-chain Bitcoin wallet to which the Lightning transactions are to be credited. You can either create a new wallet (create a new Wallet) or import another xpub or zpub key via Import a Wallet.<\/p>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1773063020752{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

        Step 8: Finalize the setup<\/strong><\/h2>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_row_inner][vc_column_inner width=”1\/2″][vc_column_text css=””]\n

        Now a message appears that refers to rebalancing. The other function of the Boltz plugin, which we do not use. Simply click on Continue.<\/p>\n[\/vc_column_text][\/vc_column_inner][vc_column_inner width=”1\/2″][vc_single_image image=”23876″ img_size=”full” alignment=”center” onclick=”link_image” css=””][\/vc_column_inner][\/vc_row_inner][vc_row_inner][vc_column_inner width=”1\/2″][vc_column_text css=””]\n

        Here we enable the autoswap. The automatic change of the incoming Lightning payment to Liquid and from Liquid to Onchain Bitcoin, which is then credited directly to our Onchain Wallet.<\/p>\n[\/vc_column_text][\/vc_column_inner][vc_column_inner width=”1\/2″][vc_single_image image=”23878″ img_size=”full” alignment=”center” onclick=”link_image” css=””][\/vc_column_inner][\/vc_row_inner][vc_row_inner][vc_column_inner width=”1\/2″][vc_column_text css=””]\n

        We then receive an overview of the settings we have made.<\/p>\n[\/vc_column_text][vc_column_text css=”.vc_custom_1773145337307{margin-left: 50px !important;}”]\n

          \n
        • Onchain payments go directly to the store’s Bitcoin wallet<\/li>\n
        • Lightning payments run via the Boltz plugin<\/li>\n
        • L-BTC ends up in the internal Liquid Wallet for a short time<\/li>\n
        • Chain swaps send the Bitcoin back to the hardware wallet (e.g. Bitbox)<\/li>\n<\/ul>\n[\/vc_column_text][\/vc_column_inner][vc_column_inner width=”1\/2″][vc_single_image image=”23880″ img_size=”full” alignment=”center” onclick=”link_image” css=””][\/vc_column_inner][\/vc_row_inner][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1773063070903{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

          Step 9: Make a test payment<\/strong><\/h2>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=””]\n

          Before you use the setup productively, you should definitely make a small test payment.<\/p>\n

          To do this, create an invoice in your store and check whether Bitcoin<\/strong> and Lightning<\/strong> are offered as payment methods. Pay the invoice with a Lightning wallet as a test. Then check in the Boltz \u2192 Swaps<\/strong> section whether the swap was created and processed correctly. Boltz itself recommends making a small test purchase after the setup.<\/p>\n

          Only once you have seen the complete process will you really understand how the setup behaves in everyday life. The first test in particular shows that Lightning payments do not end up on a Lightning node, but on the Liquid intermediate stage and only then go back into on-chain Bitcoin.<\/p>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1773145638572{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

          What data is required?<\/strong><\/h2>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=””]When you set up the setup, you only need very little information in the simplest case:[\/vc_column_text][vc_column_text css=”.vc_custom_1773063393718{margin-left: 50px !important;}”]\n
            \n
          • the zpub\/xpub<\/strong> of the hardware wallet, for example the BitBox<\/li>\n
          • Access to the BTCPay server<\/strong><\/li>\n
          • consent for the plugin to create an internal Liquid Wallet<\/strong> as a hot wallet<\/li>\n
          • the desired setting for Max Balance and Reserve Balance<\/li>\n<\/ul>\n[\/vc_column_text][vc_column_text css=””]What you don’t<\/strong> need:[\/vc_column_text][vc_column_text css=”.vc_custom_1773063429890{margin-left: 50px !important;}”]\n
              \n
            • no seed of the BitBox<\/li>\n
            • no private keys of the BitBox<\/li>\n
            • No own Lightning Node of the retailer<\/li>\n<\/ul>\n[\/vc_column_text][vc_column_text css=””]This is precisely what makes the setup attractive for many merchants: the cold storage wallet remains with the merchant, while BTCPay only works with public wallet data and Boltz enables Lightning reception via swap.[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1773063469889{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

              The advantages of this setup<\/strong><\/h2>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=””]\n

              The biggest advantage is the simple combination of self-custody<\/strong> and Lightning support<\/strong>. Merchants don’t have to learn the ins and outs of Lightning node operations, but can still accept Lightning payments. BTCPay lists Boltz as exactly one of the swapping service options for this purpose.<\/p>\n

              Another advantage is the clear target wallet:
              Both on-chain payments and the Bitcoin coming back from Lightning can converge in the same hardware wallet. This is often much easier for accounting and operational handling than several separate wallets or separate payment channels.<\/p>\n

              Last but not least, the setup remains non-custodial on the Bitcoin side of the merchant. The merchant does not pass on the seed or private keys of his hardware wallet to the server. The target wallet thus remains under his control.<\/p>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1773063503814{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

              The disadvantages and limitations<\/strong><\/h2>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=””]\n

              The setup is not entirely without trade-offs.<\/p>\n

              Firstly, the system always uses Liquid<\/strong> as an intermediate layer in nodeless mode. Boltz explicitly mentions Liquid as the only option in this mode. So if you don’t want any contact with liquid, you won’t be happy with this setup.<\/p>\n

              Secondly, the internal Liquid Wallet is a hot wallet<\/strong>. This is convenient, but in terms of security it is not the same as a watch-only wallet or a cold wallet. For this reason, the intermediate liquid balance should not be set unnecessarily high.<\/p>\n

              Thirdly, additional fees are incurred because the route can consist of two swaps:
              Lightning \u2192 Liquid and Liquid \u2192 Bitcoin Mainchain. For very small payments, it is therefore important to keep an eye on profitability. Boltz displays these fees transparently in the setup.<\/p>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1773063530005{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

              Conclusion<\/strong><\/h2>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=””]\n

              The BTCPay Boltz plug<\/strong> in is a very interesting solution for anyone who wants to accept Lightning payments with their BTCPay server<\/strong> without operating their own Lightning node. In nodeless mode, the plugin processes Lightning payments via atomic swaps<\/strong> and uses Liquid<\/strong> as an intermediate layer. The Bitcoin can then be automatically swapped back to the mainchain.<\/p>\n

              In practice, this means:
              A merchant can accept both on-chain bitcoin<\/strong> and lightning payments<\/strong> and ultimately collect everything on the same hardware wallet<\/strong>. In the example shown, a single zpub of the BitBox<\/strong>, which is already used in the store for the on-chain wallet, is sufficient. It is precisely this interaction that makes the Boltz BTCPay plugin<\/strong> one of the most exciting options for many BTCPay server operators to get started with Lightning without their own node.<\/p>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1773063582625{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

              FAQ: BTCPay Boltz Plugin, Lightning and Hardware Wallet<\/span><\/h1>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=””]\n

              What is the BTCPay Boltz plugin?<\/h3>\n

              The BTCPay Boltz Plugin<\/strong> is a plugin for BTCPay Server that allows merchants to manage Lightning payments either with an existing Lightning Node or in Nodeless Mode without their own Lightning Node.<\/p>\n

              Do I need a separate Lightning Node for the Boltz BTCPay plugin?<\/h3>\n

              No. In Nodeless Mode<\/strong> you can accept Lightning payments without operating your own Lightning Node.<\/p>\n

              Can I receive Lightning payments directly to my hardware wallet with the BTCPay Boltz plugin?<\/h3>\n

              Yes, indirectly. The payment is first converted to L-BTC on Liquid<\/strong> and can then be automatically swapped back to Bitcoin Mainchain<\/strong>. Your hardware wallet can serve as the destination.<\/p>\n

              Is a single zpub of the BitBox sufficient for Onchain and Lightning?<\/h3>\n

              Yes, if the same zpub is already used for the store’s Bitcoin wallet, this wallet can also serve as the target of the chain swaps.<\/p>\n

              Can BTCPay spend coins with a zpub?<\/h3>\n

              No. With a watch-only wallet, BTCPay does not store any private keys. The server can monitor payments and generate addresses, but cannot issue coins independently.<\/p>\n

              Why is Liquid used in nodeless mode?<\/h3>\n

              Boltz uses Liquid<\/strong> in nodeless mode because the network fees are low and the swaps for smaller lightning payments remain economical.<\/p>\n

              Is the setup custodial?<\/h3>\n

              Not on the part of the Bitcoin target wallet. The merchant retains control over their hardware wallet. BTCPay and Boltz describe the setup as non-custodial or based on atomic swaps.<\/p>\n

              Do I need an external Liquid Wallet?<\/h3>\n

              Not mandatory. You can create an internal Liquid Wallet<\/strong> in the Boltz plugin, which serves as an intermediate stage for the swaps.<\/p>\n

              Is the internal Liquid Wallet secure?<\/h3>\n

              It is practical, but it is a hot wallet<\/strong>. You should therefore save the recovery phrase and not keep the liquid balance unnecessarily high.<\/p>\n

              Can I use the Boltz plugin on a shared BTCPay server?<\/h3>\n

              Yes, basically yes. According to Boltz, the plugin is also intended for merchants on shared instances. Administrators may have to release it manually.<\/p>\n

              Does the Boltz plugin support BTCPay Server v1?<\/h3>\n

              No. According to Boltz, only BTCPay Server v2<\/strong> is supported.<\/p>\n

              Where do I install the plugin?<\/h3>\n

              Via Server Settings \u2192 Manage Plugins<\/strong>.<\/p>\n

              Can I also use other hardware wallets instead of BitBox?<\/h3>\n

              Yes, BTCPay generally supports hardware wallet integrations. For this setup, it is crucial that you can cleanly connect a wallet with public key\/watch-only import.<\/p>\n

              What fees are incurred?<\/h3>\n

              Depending on the payment, there are bolt service fees, network fees and, if applicable, fees for the chain swap back to Bitcoin Mainchain. The plugin displays these in the setup.<\/p>\n

              Where can I see whether a swap has worked?<\/h3>\n

              In the Boltz area of your BTCPay server, especially under Swaps<\/strong>. There you can check the history of payments processed via Boltz. Testing with a small payment is strongly recommended by Boltz.<\/p>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1767278511515{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”]\n

              Free initial consultation<\/strong><\/h2>\n[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column width=”1\/2″][vc_single_image image=”22926″ img_size=”medium” alignment=”center” css=””][\/vc_column][vc_column width=”1\/2″][vc_column_text css=””]If you would like to receive Bitcoin and Lightning payments with the help of a BTCpay server and use the BTCPay Boltz plugin for Lightning payments, then arrange your free initial consultation with us now.[\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][\/vc_column][\/vc_row]\n<\/div>","protected":false},"excerpt":{"rendered":"

              [vc_row][vc_column][vc_column_text css=”.vc_custom_1773061710981{padding-top: 30px !important;padding-bottom: 30px !important;background-color: #6193C9 !important;}”] Set up the BTCPay Boltz plugin [\/vc_column_text][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1773060742539{padding-top: 30px !important;padding-bottom: 30px !important;background-color: […]<\/p>\n","protected":false},"author":1,"featured_media":23893,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"content-type":"","footnotes":""},"categories":[58,52],"tags":[],"class_list":["post-23888","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-accept-bitcoin","category-btcpay-en"],"_links":{"self":[{"href":"https:\/\/coincharge.io\/en\/wp-json\/wp\/v2\/posts\/23888","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/coincharge.io\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/coincharge.io\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/coincharge.io\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/coincharge.io\/en\/wp-json\/wp\/v2\/comments?post=23888"}],"version-history":[{"count":4,"href":"https:\/\/coincharge.io\/en\/wp-json\/wp\/v2\/posts\/23888\/revisions"}],"predecessor-version":[{"id":23895,"href":"https:\/\/coincharge.io\/en\/wp-json\/wp\/v2\/posts\/23888\/revisions\/23895"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/coincharge.io\/en\/wp-json\/wp\/v2\/media\/23893"}],"wp:attachment":[{"href":"https:\/\/coincharge.io\/en\/wp-json\/wp\/v2\/media?parent=23888"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/coincharge.io\/en\/wp-json\/wp\/v2\/categories?post=23888"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/coincharge.io\/en\/wp-json\/wp\/v2\/tags?post=23888"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}