lnbits / tpos

Secure, mobile-ready, instant and shareable point of sale
MIT License
14 stars 13 forks source link

TPoS - LNbits extension

For more about LNBits extension check this tutorial

A Shareable PoS (Point of Sale) that doesn't need to be installed and can run in the browser!

An easy, fast and secure way to accept Bitcoin, over Lightning Network, at your business. The PoS is isolated from the wallet, so it's safe for any employee to use. You can create as many TPOS's as you need, for example one for each employee, or one for each branch of your business.

Usage

  1. Enable extension
  2. Create a TPOS\ create
  3. Open TPOS on the browser\ open
  4. Present invoice QR to customer\ pay

Receiving Tips

  1. Create or edit an existing TPOS and activate Enable tips\ tips
  2. Fill in the necessary fields:\
    • select a wallet to receive tips in
    • define the tip (percentage)
    • hit Enter after every option
    • if no values are defined, a default Rounding option will be available. Round the check to a defined value.
  3. When using the TPOS, set a value to receive as normal and hit OK\ tip amnt
  4. A new dialog will show to define a tip\ set tip 1
    • select the % or choose Round to to round the value\ set tip 2
  5. Present the invoice to the customer, with the updated amount with the tip\ pay tip
    • after payment, the tip amount is sent to the defined wallet (for example an employees wallet) and the rest to the main wallet\ paym 1

Add Items to PoS

You can add items to a TPoS and use it on a list.

  1. After creating a TPos, or on an existing TPoS, click the expand button\ items

    • you can add an item
    • delete all items
    • import/export items from a JSON
  2. Clicking the Add Item fill the Item details\ add item

    • title and price are mandatory
  3. Or you can import a JSON with your products, using the format:

[
    {
      "image": "https://image.url",
      "price": 1.99,
      "title": "Item 1",
      "tax": 3.5,
      "disabled": false
    },
    {
      "price": 0.99,
      "title": "Item 2",
      "description": "My cool Item #2",
    },
    ...
]

After adding your products, when launching your TPoS, if there are products, it will default to the items view (PoS view)\ pos

Click the items Add button, to add to a "cart" or a total. pos add

When done, click Pay to show the invoice for customer to pay, or choose the tip if you have it set. If you need the regular TPoS, click the button on the bottom.

There's also a + button on the regular TPoS On the regular TPoS you can also add value to a total. Enter a value and click the + button. Keep doing it until you're done. After that click OK as usual.\ plus

OTC ATM functionality

  1. Create or edit an existing TPOS and activate Enable selling bitcoin\ atm

  2. Fill in the necessary fields:

    • set a maximum withdrawable per day
    • define a PIN to access the functionality
    • define a cool down period between withdraws, to avoid exploitation (min. 1 minute)
  3. When using the TPOS, you'll see the ATM button, click and enter PIN\ atm pin

  4. Set amount to sell and click OK\ atm amount

  5. Show the LNURLw QR code to the buyer\ atm withdraw

  6. After successful withdraw, the green check will show and TPOS exists ATM mode\ atm success

Tax settings

For tax settings, by default tax is included in the price. You'll need to set a default tax rate in percentage (ex: 13). If items have a tax value, as some products may have different tax (VAT usually), it overides the default value.

When using the normal keypad PoS, the default tax value is used, and tax value is always included in the value.