TPoS

Touch-friendly point-of-sale terminal.

Payments & CommerceOpen Source

Source API Docs

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.

   

LN Address Funding

Some deployments require sharing revenue from every payment made through a TPoS.
This feature allows you to automatically forward a defined percentage of each received payment
to a specific Lightning Address.

This is especially useful when:

• You host an LNbits server and give a TPoS to a vendor, and you want to receive a host fee / revenue share, or
• Two participants share one TPoS, and a portion of each incoming payment should automatically go to a partner, co-owner, or collaborator.

In these cases, the function helps identify the initial TPoS initiator and forward their share without manual reconciliation.

How it works

1. Open or edit a TPoS.
2. Enable LN Address Funding.
3. Enter:
   • Lightning Address of the recipient (e.g., alice@yourdomain.com)
   • Percentage share (e.g., 10 for 10%)
     

When a customer pays:

• TPoS receives the full Lightning payment.
• The extension splits the amount automatically.
• The defined percentage is forwarded to the configured Lightning Address.

This happens instantly, with no extra setup and no additional wallets required.

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.

---

API Reference

See the TPoS API documentation for endpoint details.

Related Pages

• TPoS API Reference: API endpoints for this extension
• All Extensions: Browse all LNbits extensions