+
Skip to content

lnbits/tpos

Repository files navigation

LNbits

OpenSats Supported License: MIT Built for LNbits Explore LNbits TPoS Stripe Tap-to-Pay Wrapper

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

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.

    Create a TPoS
  3. Open TPoS in the browser.

    Open TPoS
  4. Present the invoice QR to the customer.

    Invoice QR

Receiving Tips

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

    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.

    Enter amount
  4. A tip dialog appears.

    Tip selection dialog
  5. Select a percentage or Round to.

    Select tip or round
  6. Present the updated invoice to the customer.

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

    Tip distribution

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.

    Expand items

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

    Add item dialog
  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):

Items view

Click Add to add to a cart / total:

Add to cart

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.

Add custom value

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)
ATM settings
  1. Open the TPoS, then tap the ATM button.
ATM button

Warning

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

ATM mode badge
  1. Set the amount to sell and present the LNURLw QR to the buyer.
Withdraw QR
  1. After a successful withdrawal, a confirmation appears and TPoS exits ATM mode.
Withdrawal success

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.
Not logged in feedback

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.

Tax settings

Powered by LNbits

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

Visit LNbits Shop Try myLNbits SaaS Read LNbits News Explore LNbits Extensions

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 10

点击 这是indexloc提供的php浏览器服务,不要输入任何密码和下载