UniPoS is a fork of the LNbits TPoS extension. It adds EVM stablecoin payments. It installs beside TPoS, because it has its own extension id, its own database schema and its own payment tag. Data does not carry over from a TPoS install.

To test the EVM payment method, read TESTING-SEPOLIA.md.

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 UniPoS flow.

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

• Overview
• Usage
• Receiving Tips
• LN Address Funding
• Adding Items to PoS
• OTC ATM Functionality
• Tax Settings
• Powered by LNbits

• 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

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

1. Enable the extension.

2. Create a UniPoS.

   

3. Open UniPoS in the browser.

   

4. Present the invoice QR to the customer.

   

1. Create or edit a UniPoS 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 UniPoS, 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.

   

Some deployments require sharing revenue from every payment made through a UniPoS.
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 UniPoS to a vendor, and you want to receive a host fee / revenue share, or
• Two participants share one UniPoS, 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 UniPoS initiator and forward their share without manual reconciliation.

1. Open or edit a UniPoS.
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:

• UniPoS 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.

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

1. After creating or opening a UniPoS, 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 UniPoS 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 UniPoS, switch via the bottom button.

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

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

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

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

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

• 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.

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.

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