TPoS — LNbits extension

A shareable Bitcoin Lightning Point of Sale that runs directly in your browser.
No installation required — simple, fast, and safe for any employee to use.

One Checkout · Two Payment Rails with the optional Stripe Tap-to-Pay Wrapper for Android.
Take card (fiat) via Stripe and Lightning payments side by side from a single TPoS flow.

For video content about the TPoS extension, watch the official demo.

---

Quick Links

• Overview
• Usage
• Receiving Tips
• Adding Items to PoS
• OTC ATM Functionality
• Tax Settings

Features

• Create invoices — instant Lightning QR invoices
• Tipping — percentages or rounding, split to a tip wallet
• Item management — products, cart, JSON import/export
• OTC ATM — LNURL withdraw limits and cooldown
• Stripe fiat payment integration — accept tap-to-pay via Stripe
• Tax settings — global/per-item, inclusive or exclusive

Overview

TPoS lets you take Lightning payments right from the browser. Every TPoS runs isolated from your main wallet for safer staff use and multi-branch setups, and you can create as many terminals as you need.

Usage

1. Enable the extension.

2. Create a TPoS.

   

3. Open TPoS in the browser.

   

4. Present the invoice QR to the customer.

   

Receiving Tips

1. Create or edit a TPoS and activate Enable tips.

   

2. Fill in:

   • Wallet to receive tips
   • Tip percentages (press Enter after each)
   • If no values are set, a default Rounding option is available

3. In TPoS, set an amount and click OK.

   

4. A tip dialog appears.

   

5. Select a percentage or Round to.

   

6. Present the updated invoice to the customer.

   

7. After payment the tip is sent to the defined wallet (e.g., employee wallet) and the rest to the main wallet.

   

Adding Items to PoS

You can add items to a TPoS and use an item list for sales.

1. After creating or opening a TPoS, click the expand button.

   

   Then you can:

   • Add items
   • Delete all items
   • Import or export items via JSON

2. Click Add Item and fill in details (title and price are mandatory).

   

3. Or import a JSON with your products using this 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 products, the TPoS defaults to the Items View (PoS view):

Click Add to add to a cart / total:

Click Pay to show the invoice for the customer. To use the regular keypad TPoS, switch via the bottom button.

Regular TPoS also supports adding to total: enter a value and click +, repeat as needed, then click OK.

OTC ATM Functionality

1. Create or edit a TPoS and activate Enable selling bitcoin. Configure:
   • Maximum withdrawable per day
   • Cooldown between withdrawals (min. 1 minute)

2. Open the TPoS, then tap the ATM button.

Warning

The red badge centered at the top indicates you are in ATM mode.

3. Set the amount to sell and present the LNURLw QR to the buyer.

4. After a successful withdrawal, a confirmation appears and TPoS exits ATM mode.

Note

OTC ATM requires a signed-in account. When sharing a TPoS, be signed in or have the login details ready.

• Today: If you are not signed in, you will see a Not logged in error.
• Coming soon: A feedback dialog will appear and prompt you to sign in.

Tax Settings

By default, tax is included in price. Set a default tax rate (%) (e.g., 13). Items can override this with their own tax value.

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

In the keypad PoS, the default tax is used and is always included in the value.

---

Powered by LNbits

LNbits empowers developers and merchants with modular, open-source tools for building Bitcoin-based systems — fast, free, and extendable.