Skip to content
/ tpos Public

Secure, mobile-ready, instant and shareable point of sale

License

Notifications You must be signed in to change notification settings

lnbits/tpos

Repository files navigation

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.

  • Tax Exclusive means tax is applied on top of the unit price.
  • Tax Inclusive means the unit price includes tax.

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