Voltage
Search…
⌃K

Merchant Point of Sale Guide

Set up your BTCPayServer to accept payments for goods and services
This guide will show step by step how to configure your BTCPayServer to accept payments for goods and services from directly within the dashboard. After you have configured your store wallets either on-chain, Lightning, or both, you are ready to start your first app. First thing to do is to click on + New App under the Apps option.
After you click New App, you will be prompted to choose either Point of Sale, or Crowdfund. For this guide you will choose Point of Sale. And also name your app for your own organization. On Voltage you can have unlimited stores and apps without extra cost. Click Create.
After you click create you will be brought to your app configuration page. On this page you can change the name of your app, the title that your customers will see, the currency you want to be represented, along with a store description.
Below that, you will be able to add and remove items from your store. The Tea Shop is a default demo that you can just click the trashcan for or edit the items.
Below that you will see the Appearance option. You can choose from several styles here. You can choose from Item list only, Item list and cart, Keypad only, or Print. It's important to remember that you must click SAVE after every change. It is easy to forget so please don't forget to save!
You can also require an email on checkout if you wish to record your customer's email address for future correspondence.
You will most likely want to disable "User can input discount in %" and "User can input custom amount" in this situation, but it is up to you.
You can also choose if you want your customers to have the option to add a tip to their purchase.
The Additional Options menu will give you the ability to customize the look of your store with CSS, add redirects, embed the store onto your site with iframe, and much more.
When this is all done, click SAVE, and then click View.
Take note of the URL you are taken to, in this instance and bookmark it. This is a unique URL that will not change. Consider creating a subdomain on your main site such as shop.mainsite.com and point it towards your btcpayserver store URL from your site backend (such as cpanel). That way you can simply tell people that your store is at shop.mainsite.com and not the long URL that is provided.
Test it out by adding an item to cart and then clicking confirm.
Then you will be brought to your invoice page where your customer can pay you!
If you are happy with the order-flow, then you are done! If not, you can go back and change some settings around. That is the basic way to start a merchant shop on BTCPayServer! For further questions please join us on discord at https://voltage.cloud/discord or email us at [email protected]