The shop's wallet
The site never touches the money: for every sale the till asks your wallet for an invoice, and the satoshis arrive there. You need a wallet with the right address.
For paying, any Lightning wallet will do. For taking payments you need a Lightning address the till can read. If you're looking for a wallet to pay with, it's in lesson 3.
The shop's wallet can be different from the one you pay with, and it's better if it is: taking payments needs things that paying doesn't. With one wallet for the shop and one of your own, takings don't get mixed up with spending either, and the evening count adds up sooner. Every so often, move the takings into your savings, which don't sit on the till's phone: lesson 6.
What the wallet has to do
To take payments, the wallet has to do four things:1
- give a Lightning address,
something@domain: for every sale the till asks it for the invoice; - answer “has it been paid?” (it's called LUD-21
verify) from the address's own domain, or from one of its subdomains: the till talks to nobody else, so a tampered answer can't send it to another site. An address on your own domain that forwards everything to a service elsewhere won't do; - answer the browser on the phone, where the till runs;
- receive with the phone switched off, or at least with the app closed: the till is often on a different phone.
The form checks the first three when you paste the address, and if one is missing it tells you which. The phone switched off you can only see by trying.
What we recommend
- A self-custodial wallet on Spark: the recovery phrase is yours, and it receives with the phone switched off, with no channels or liquidity to manage. We tried Blink, in self-custodial mode, with the till on 11 November 2026: the payment was confirmed with the wallet's phone switched off (the test).
- A Lightning node of your own, if you have one: its address works the same way, as long as it answers “has it been paid?” (A node of your own).
- On-chain only for special cases: you put the key in the till's settings, on the phone (Lightning or on-chain).
Of the five wallets we have tried for paying, this is how it went with the till:
| Wallet | Address | At the till |
|---|---|---|
| Blink, self-custodial | name@blink.sv |
Receives with the phone switched off: tried on 11 November 20261 |
| Glow by Breez | name@breez.cash (or @breez.tips) |
Answers “has it been paid?”: check of 12 November 20261. On 17 November 2026 Pizzeria Le Fucine, the first shop to move to the new till, connected it to the till and received a test payment2. With the phone off, not tried yet |
| Phoenix | A different kind | For paying: the till can't read its address |
We haven't yet tried Bitkit and Blixt with the till. The links for downloading all of them are in Choosing your wallet with care.
If you're opening a shop and don't have a wallet yet, the form walks you through it: tick “I don't have a wallet yet” and the steps come one after another.
Glow by Breez, step by step
- Download it only from the link, from Breez's page, not by searching the store: there's also another “Glow”, for Solana, by a different publisher. The right publisher is Breez. On an iPhone it needs iOS 18 or later.
- It doesn't show the 12 words by itself. When you first open it, the big “Get Started” button creates a passkey, and the words don't appear. Open them straight away from Settings → Backup → Recovery Phrase and write them on paper; or, when you first open it, choose “Use Recovery Phrase Instead”.
- Give the address your shop's name before you paste it into the form. The starting name is random: under Receive → Edit put your shop's name, short and without spaces, for example
barcentrale. If you change it later, the address you pasted stops receiving. The address ends in@breez.cash; the older@breez.tipsones work too.
On an iPhone, open the till in Safari
If you open the sign-in link from the Gmail app, on an iPhone the page stays in Gmail's own browser, and the till would stay there too. Once the till is open, move it to Safari: choose “Open in Safari” from the page menu, or copy the address and paste it into Safari. Then, from Safari, save it to the Home Screen: Share → Add to Home Screen. The till opens from its own address, without signing in again. On Android the same goes for the phone's browser, if the link opened inside another app.
How to test one
Whichever wallet you pick, the address is connected and tested the same way:
- Create the wallet and write the recovery phrase down on paper, in the right order. No photos, no messages, and don't type it into the form: none of us will ever ask you for it.
- Find the Lightning address. It looks like an email,
something@domain. It isn't the long code starting withlnbc: that one only works for a single payment. - Paste it into the form. The form tests it straight away, without paying anything, and tells you whether the till can use it.
- Try it with the phone switched off. Switch off the wallet's phone, and from another phone pay a few hundred satoshis at the till. The till must say “Payment received” on its own; then switch the phone back on, and the satoshis must be there. It's done with real bitcoin: on the test network few wallets give an address that answers “has it been paid?”.
Tell the others how it went
Wallets change: one that worked can lose the “has it been paid?” answer with an update, and one that didn't may work now. Tell the community about your test, at the next meetup or by writing to us, or among the bitmentor issues, where it helps other communities too: the wallet and its version, the day, the network, and whether it worked or at which step it stopped, with what the form or the till said. Without a date and a version, whoever comes next can't tell whether it still holds.
The wallet belongs on the owner's phone, never on staff phones: whoever's serving at the till only needs their till, which takes payments and can't spend.
For shopkeepers Lesson 5: behind the counter Who creates your invoices Spark, and what we're keeping an eye on
-
Bitmentor, “Choosing wallets for your community” (
docs/wallets.md), in the bitmentor repository: what a wallet must do to work with the till, what it recommends, the four steps for testing one and the invitation to report the test. The Blink test with the phone switched off is from 11 November 2026; the check of the Blink and Glow addresses from 12 November 2026. Read on 14 November 2026. ↩↩↩ -
In production, 17 November 2026: Pizzeria Le Fucine, the first shop to move from the old till to the new one, took over its shop with its email, connected a
@breez.cashaddress and opened the till, in just over a minute. The test payment that followed went through, according to those present: payments go from the customer to the shop's wallet, and the site doesn't see them. It was not tried with the phone off. ↩