Once you're up and running
The till takes payments and you have the basic merchant pass. What comes next arrives one step at a time, when you need it: the map, the evening routine, the advanced features and the game.
In one line First the map and the sign, then closing up in the evening and the people who work with you; the rest when you need it, and the game once the till has been running for a few days.
Nothing is locked The steps are an order, not an obligation: you can read everything now. The first four, from the shop to the basic merchant pass, are in For shopkeepers; the list of all the guides, from first to last, is in Everything, if you want.
The answers come from the shop's panel and from the bitmentor documentation.1
5. On the map
You go on the map after one of us has looked at the shop: we do that with every new shop. While you wait, the till takes payments as usual. Once you're on the map, the panel shows “Your card on the map, now”.
You join a community that has been accepting bitcoin since 2013. You get customers who come specially, visitors from further afield and a place on the map: Amadori tells of tourists from northern Europe, heading for the Veneto or Lombardy, who stopped in Trentino because on their map the area was “exploding with orange”.
In 2025 an active shop took an average of 14 payments, with a typical bill of €13, and the busiest venue of the year took 69 (the ledger's numbers).
On the map your listing has a Lightning icon, solid as long as your address responds: how it lights up and how it fades is in Badge, icons and holidays.
The sign and the till card
The sign is printed and put up once the team has approved the shop: printing it, in the panel, is for when you're on the map. It goes on the customers' side: its code opens your shop's page, which says how to pay there, with a card to show at the till and the nearby places where you can pay. Before approval that page shows only the name.
The card for the till goes on your side of the counter. It has the instructions in a few lines and, if you add it, the code that opens the till on the phone: with the code on it, keep it out of customers' sight. The space to write your name and your phone number is already there.
Want something to stick up next to the till too? There's the sheet to keep behind the till, with the three things to remember. And every so often check that the sign is still yours: how and how often, in QR codes, signs and links.
6. The routine
After a few sales, or a few days, the till becomes a habit. Three things are left to learn: closing the day, taking the figures to your accountant and giving a till to the people who work with you.
Closing the day
Tap “Close the day” on your till, in “History and day closing”: it's the closing receipt, like the one from a card terminal. It says how much you took today, in euros and in satoshis, split by method (Lightning or on-chain). Below, what to check in the wallet: the sales you marked as paid by hand and those from your staff's tills that the till couldn't check with the provider. Sales that weren't paid, expired or were cancelled are only counted.
The closing is done by the till, on your phone: the site receives neither sales nor amounts. You can look at other days too.
Then you compare with the wallet: every sale must have its payment. How to do it, line by line, is told in Behind the counter.
The file for your accountant, and the copies
The sales are yours. From the till's history you download the copies: the file for your accountant, for one month or for everything, with a line for each sale (time, amount in euros, status, payment method, satoshis received and exchange rate), and an encrypted copy, with a password you choose, to put back on a new phone. The till reminds you as often as you choose.
The sales stay only on the phone and in your copies: the site doesn't see them and doesn't keep them. If you lose the phone without a copy you lose the history, not the money, which is in your wallet.
The closing doesn't replace the receipt or anything to do with tax. The price stays in euros and the receipt is rung up as usual. What the rules say and the questions to ask your accountant: Tax in the shop.
Refunds, and if you want euros
If you need to give money back, the payment doesn't reverse itself: you pay again from your wallet. In the till's history every sale has its satoshis and the exchange rate at that moment: from there you know how much to give back. Refunds, double payments and the evening check, step by step: Behind the counter.
The till gives you bitcoin, not euros. To change into euros you need a platform authorised under the EU's MiCAR regulation: the register is kept by ESMA, the European markets authority. Amadori says that shops in Rovereto now keep their bitcoin rather than changing it straight away. You can do as you prefer.
The people who work with you have their own till
In the panel, in “Registers for your staff”, you give each person a till of their own, with their name (“Anna”, “evening shift”), and you put it on their phone with a code that works once only and lasts a day. Five minutes per person. That till can only take payments: what it sees, what it doesn't and how its history reaches yours are in The people who work with you.
Anna has her own practice till too. The first time she opens her till she reads and accepts three rules, the same ones as on the sheet to keep behind the till. Her till opens once you have the basic merchant pass.
If Anna stops working with you, or loses her phone, on the “Registers for your staff” page you tap “Turn off” next to her name: her till stops at once, the others carry on. Your own till, though, can't be switched off: you give your till's link to nobody.
At the end of the shift. With your npub in the till's settings there's nothing to hand over: the sales from your staff's tills arrive in yours by themselves (the copies on Nostr). Without an npub, each person taps “End the shift” on their own till, downloads the encrypted copy of its history and gives it to you with its password: you import it into your till, without going through the site. Your till checks their Lightning sales by itself with the provider of your address; the others come in as “reported”, to be checked in the wallet. A shift that runs past midnight counts for its own day: until 5 in the morning “today” is still yesterday.
Things we've learned
“Some struggle even with the 22% discount […] because it's psychological: blimey, I worked hard to get these.” Marco Amadori, ImpAct 2025, abridged
The discount, the sales force, the halfway house and the accountant, with the mistakes we made, are in What Rovereto taught, the page for people opening a Valley. Here are the three shopkeeper's rules.
Practise without money first, then with one euro. The practice till is there for making mistakes. Then pay yourself from another phone before you put up the sign.
Decide beforehand what to do with the bitcoin. Keep it, convert some, pay a supplier with it. Some merchants sold straight away and regretted it, others took fright when the price dropped.
The one thing you must never do. Give anyone your wallet's recovery phrase, even if they say they're one of us.
If the site goes down, your wallet keeps working, and a printed Lightning address stays valid.
7. The rest, when you need it
Not everyone needs these features, and not on the first day. In the till they're in “Settings”, some under “Advanced”; the others are in the panel.
Taking on-chain payments too
You take payments with Lightning; on-chain is plan B, for when the customer's wallet doesn't understand your Lightning code. In the shop's form you tick “I take on-chain payments too”: the wallet's key goes into the till's settings, on the phone, and the site never sees it. From then on, under the keypad, there's “OK, on-chain”. You try it in the fifth exercise on the practice till.
| Lightning | On-chain | |
|---|---|---|
| How long it takes | A few seconds | From a few minutes to an hour |
| When | Always: coffee, lunch, groceries | Plan B, if the customer's wallet doesn't understand your Lightning code |
| What you give us | Your Lightning address | Nothing: the extended public key goes into the till, on your phone |
| What we see | That the address answers: neither the sales nor the balance | That you also accept on-chain, so the map can say so, and how many addresses your till has handed out: neither amounts nor payments |
What changes for you, and when to wait for a confirmation: Lightning or on-chain.
Closing for the holidays
Coming in the next few months. The button is already in the software, “Closing for a while?”: in the Valley we're switching it on a little at a time. With it the map will say “Closed for holidays” and when you reopen, without treating your shop as gone, and the till keeps working. How it will work: Close for holidays.
Your shop on OpenStreetMap
OpenStreetMap is the free map that anyone can correct, and many Valley shops are already on it. In the panel, “Your shop on OpenStreetMap” tells you whether the shop is there and which bitcoin lines are missing or different, as of the last monthly reading. You can update it yourself, with the steps in plain words and the lines to copy, or ask us to do it with a tap: on OpenStreetMap only one person from the Valley writes, by hand.2 What we keep of those requests: the privacy page.
The till's copies on Nostr
As well as the encrypted file you download yourself, the till can keep a copy of the history on Nostr, on the Valley's relay (wss://bitcoinvalley.eu/relay). Enter your public key, the npub, in the till's settings, in “Advanced”, under “Copy on Nostr”. Everything is encrypted with your key: the relay sees only encrypted data, the site nothing.3
The sales from your staff's tills arrive in yours by themselves, as they make them, without waiting for the end of the shift: you see them when you open your till. This works for the tills paired after you entered the npub: the ones paired before, you pair again with a new code, from “Registers for your staff”. Without an npub, there's still the encrypted file, handed over at the end of the shift.
The discount for people who pay in bitcoin
On the map 13 shops give a discount, from 10% to 22%. It isn't there to cover the card-terminal fee, which is worth a couple of percentage points: it's there to get people who hold bitcoin to spend it instead of sitting on it.
You enter it in the shop's form. In the till it's in “Settings”, under “Prices”: it starts from your discount, or from the one the Valley suggests if you don't have one, and you change it or switch it off yourself. You can let the tills take it off a sale, and round the discounted price down to a round figure.1
Changing the Lightning address, or the wallet
It's done from the panel: “Edit”, then “Change the Lightning address”. It's where the money goes, so there are some safeguards: you must have signed in within the last 15 minutes, the site tests the new address live, and you can change it at most once every seven days (the same wait applies after a change of recovery email). You get a notice.
The shop and the sign stay the same. You reopen each till by confirming the change, and your staff's tills have to be paired again. The badge comes back as soon as the site sees the new address working. When it's worth changing it, for example if the provider of your invoices (the Lightning payment request, not the tax invoice) stops working: Who creates your invoices.
8. The game
The game comes after the till: once you've been taking payments for a few days, the merchant pass still has something to give you, and the shop something to show.
The other merchant pass modules
Besides the four basic ones, in the panel, in “Your merchant pass”, there are four more modules: who creates your invoices, QR codes and signs, tax, what we do and what we don't. They don't stop the till, and each one points to a page on the site, with a few questions and a few statements to tick.
Then three actions, which you tick yourself once you've done them: “Practice done”, after the practice till; “Backup checked” and “Withdrawal tried”, after the two tests with a few satoshis.4
The badge
Once your Lightning address responds and you've passed the basic merchant pass, the “Certified shop” badge appears on your listing. You don't apply for it: it arrives on its own, and the panel tells you what's missing. The rules are in Badge, icons and holidays.
The passport
The pilgrim's passport keeps a stamp for each thing you do on the site: the first coffee rung up for pretend, the signature with a real key, the scam taken apart, the walk. It all stays in your browser, with no account, and there's also a booklet to print.
For shopkeepers Everything, if you want Questions from shopkeepers If something goes wrong Open the panel
-
What the till and the panel do, as described in the bitmentor documentation (github.com/mammadori/bitmentor, folder
docs/features: “The practice register”, “Staff and shops kept apart”, “Closed for a while”, “The customer at the till”, “Something wrong?”, “History and day closing”, “On-chain at the register”, “Registers for the staff”, “The register's settings”, “Changing a shop's Lightning address”) and as seen in the shop's panel. Read on 10 November 2026, checked again on 12 and 19 November. ↩↩ -
Bitmentor, “OpenStreetMap” (
docs/features/openstreetmap.md), in the same repository: the site reads OpenStreetMap once a month and never writes to it by itself; the shopkeeper's request is carried out by a person, by hand. Read on 19 November 2026. ↩ -
Bitmentor, “Copies on Nostr” (
docs/features/nostr-copies.md), in the same repository: the owner's npub in the till's settings, the copy encrypted with NIP-44, the relay that sees only encrypted data. Read on 19 November 2026. ↩ -
Bitmentor, “The merchant's training” (
docs/features/merchant-training.md), in the same repository, and the modules of the Valley's merchant pass. Read on 19 November 2026. ↩