Rovereto, Tuesday 17 November 2026 · Year XIII, n. 321 itende
Bitcoin Valley
ContentsClose

Dispatches from the valley where you pay in bitcoin.

For shopkeepers · When you need a hand

If something goes wrong

A till doing something strange, with a customer standing there, worries everyone. From the panel one tap is enough: you choose what's happening, the site tells you what it knows about your shop and what to do now, and if that isn't enough you send us the request: we try to help you, with no guarantee on timing. The money, meanwhile, stays in your wallet: the till doesn't hold it.

First of all Don't cancel and don't ring the sale up again. A payment doesn't cancel itself: nearly always it's enough to wait, and the till says how it ended.

In the panel: “Something wrong?”

In the panel, under the shop's name, there's the “Something wrong?” button. You'll also find it in your till's menu, the button at the top, where you are with the customer in front of you. It opens on six sentences, the ones you'd say at the till, and they're the same as on this page.1 Under each one:

  • “What the site knows about your shop”: first what's wrong, then, in a closed card, what works. It speaks to you, in your own words. The page opens at once because it looks only at what the site already has; if you want it to test your Lightning address too, tap “Check again” (it takes up to 20 seconds).
  • “What to do now”, step by step.
  • “Ask the association for help”: if that isn't enough, one tap, and the request reaches us with what the site knows. How it works is further down, in Ask for help with one tap.

This page is for whoever isn't at the panel, or wants to read first: it says the same things, case by case.

The customer can't pay

What you see

The customer's wallet shows an error, or the code can't be read, or the till shows no code.

What you do now

  1. Start the sale again from the till: a new code appears. An old code can stop working, and if the till says “Payment expired” the customer has paid nothing.
  2. Ask the customer to read the code from inside their wallet app, not with the phone's camera, and to check that the wallet has enough. Can't read the code? Tap “Can't read the code? Show it as text”: the customer can copy it.
  3. If the till shows no code or the page won't open, check the phone's connection and reload the page.
  4. The customer has no wallet, or doesn't know how to pay? Show them the card for customers without a wallet: you don't have to explain anything.
  5. Do you see “Lightning: your address is not answering” in the panel? Tap “Try again now”. Then open your wallet: is the Lightning address still the same? If it has changed, put the new one in from the panel: the shop and the sign stay the same. If it's the same, your provider may have a problem: try again in a while, or ask for help.
  6. Don't keep the customer waiting: if you've set up on-chain, “OK, on-chain” is another way; if nothing works, they can pay another way. Then ask for help.

What the site does by itself

The site tries your address every few hours, the way the till uses it: it asks for a payment request that nobody pays, and in the wallet you sometimes see it expired. If it stops answering it writes to you (by email and in the panel), and writes again when it works again. We see it too, in the list of things to look at.

The payment stays pending

What you see

The till says “Waiting for payment”, and the customer swears they've paid (on their phone it says “Sent”).

What you do now

  1. Don't ask the customer to pay again, don't cancel, don't ring it up again, and don't hand over yet. Whoever works with you waits for the till's green tick, doesn't look at the customer's phone.
  2. With Lightning a few seconds are enough. If more pass, check that the till's phone has Wi-Fi or data.
  3. If the till says “No connection”, wait: the payment shows up as soon as it returns. If it says nothing started, press OK again when the connection is there.
  4. You, who have the wallet, open your wallet: has the money arrived? If so, the payment is good even if the till is waiting: tap “I see the payment in my wallet”, and in the day's closing that sale stays among the ones to check. If it happens often, ask for help: we try to understand why the till didn't notice.
  5. The money isn't there? A Lightning payment is immediate: the customer looks at their wallet and tries again. An on-chain payment, written directly into Bitcoin's ledger, can take from a few minutes to an hour.
  6. Open the till's history: every sale has its status and says how it ended.

What the site does by itself

Every few seconds the till asks your wallet whether the payment has arrived. The sale stays in the history until it ends: paid, expired or cancelled. An on-chain payment that has been seen but not yet confirmed can be left there, with “Next customer”, and the till checks it again later.

The till won't open

What you see

The till page doesn't load, or says “The site is not answering”.

What you do now

  1. Check the phone's Wi-Fi or data, then try again after a minute.
  2. Lost the till's link? From the panel tap “Open the till”. If it asks you to log in, log in with your wallet or with the link we send you by email.
  3. Someone who works with you can't open their till? The code on their card works once only and lasts a day: if it has expired, make a new one from the panel: “Registers for your staff”, then “Put it on a phone” next to their name.
  4. On a phone that has already opened it, the till takes Lightning payments even if the site doesn't respond: it requests the invoice directly from your address. Press “I see the payment in my wallet” only if you really see it in the shop's wallet. If you don't see it, don't hand over and ask for help.

What the site does by itself

The money always goes directly to your wallet: the site doesn't touch it. A printed Lightning address stays valid. The till talks directly to your wallet: if the site doesn't answer, on a phone that has already opened it the till carries on regardless. The sales are on the phone, and the site doesn't see them.

I've lost my phone, or changed it

What you see

You can no longer get in from the phone you used, or someone else might have it.

What you do now

  1. The phone of someone who works with you: from the panel, under “Registers for your staff”, open the tills and tap “Turn off” next to their name. That till stops at once and the others carry on. For the new phone, make a new till, with a new code.
  2. Your phone, for the till: log in from the new phone with your wallet or with the link we send you by email, if you gave us one, and tap “Open the till”: add it to the new phone's home screen. There's no money and no recovery words in the till: it can only ask for payments, and they come to you. The sales history was on the old phone: put back the last encrypted copy you downloaded, with its password, and everything up to that day comes back. If you use on-chain, you enter its settings again.
  3. The phone with the wallet: the wallet is put back on a new phone with the twelve words you wrote on paper. We don't have them and can't recover them. Tell one person you trust where to find the sheet, in case something happens to you: nobody else reads the words or photographs them.
  4. Is the wallet new too? From the panel tap “Edit” and then “Change the Lightning address”, and enter the new wallet's address: only you can do it, having signed in recently. The shop, its page and the sign stay the same; you reopen each till by confirming the change. If you get stuck, ask for help.

What the site does by itself

The till of someone who works with you doesn't see your sales or the settings, and can't change where the money goes. Switched off, it takes no new payments, but it still opens for a day: a sale already on the screen ends there, and the shift's copy can be downloaded.

I gave too much change, or the customer paid too much

What you see

The customer paid twice, or sent more than they owed on-chain. Or you yourself gave too much change.

What you do now

  1. Hand over the goods: the sale is paid.
  2. Check in your wallet that the extra amount has really arrived. If it isn't there, you give back nothing.
  3. Open the till's history: every sale has the amount, the satoshis and the exchange rate at that moment. From there you know how much to give back.
  4. Give the difference back from your wallet, not from the till. If the customer agrees, in cash too. If you work the till and aren't the owner, you note the time and amount and call them: the owner gives the money back, never with your own money.
  5. Did you give too much change yourself? The till can't take that money back, and a payment already made doesn't change. The history gives you the sale's correct amount, for your accounts.

What the site does by itself

Nothing: the money and the sales are yours. The site doesn't see the payments, sends nothing to the customer and keeps no accounts. You give the money back, and the till's history tells you how much.

Something else

What you see

Something doesn't add up and none of the entries above looks like it. That's fine: it happens, and you only need to tell us in one line.

What you do now

From the panel tap “Something wrong?”, then “Something else”, and ask for help: one line on what you see and since when, and we try to look at everything the site knows about your shop.

Can't get into the panel? Then write to info@bitcoinvalley.eu, with four things: the shop's name, the time, what's written on the screen (a photo is fine too) and how you'd like to be contacted. We try to reply, with no guarantee on timing.

One thing never goes in the message, neither on the site nor by email: the wallet's twelve words. We never need them, and the site refuses them.

What the site does by itself

Whoever looks at your request has a tool that reads your shop and says, in plain words, what's wrong: the Lightning address, the first day, the tills of whoever works with you. Not the sales: they live on your phone. It only reads: it changes nothing in your shop, and “Something wrong?” never asks you for an address or a key.

Ask for help with one tap

Under every sentence in the panel there's “Ask the association for help”.1

  • One line, if you like. Write what you see and since when, in a few words (up to two hundred characters, on a single line). A key or the wallet's words the site refuses.
  • How you'd like to be contacted. By email, at the address you log in with (the panel shows it with some letters hidden); on Telegram, in the shop's chat; on the shop's phone; or “I'll look at my panel: it says when it's solved”.
  • What reaches us. The shop's name, what's happening, your line, how to contact you (the way, never the address or the number) and what the site knows about your shop at that moment. Never a key, never an address. The request sits at the top of our list; when it's sorted out, someone marks it “solved”.
  • What you see. In the panel “You asked for help at 10:32” and then “Solved”, for three days. If the message doesn't reach us (no Telegram, or it doesn't answer), the request is saved all the same and the panel tells you so.

Up to three requests a day per shop. It isn't a chat: we try to contact you the way you asked, with no guarantee on timing, and mark the request “solved” when it's sorted. What we can do and what we can't: the terms of the help.

“Something wrong?” never changes the till, the sign, the tills of whoever works with you or where the money goes.

What the site prepares for us, without you doing anything

The site prepares for us a list of things to look at:1 Lightning addresses that aren't answering and since when, and shops that have moved over and are still waiting for their owner or their wallet. Your shop is on it if it has a problem, and the requests for help sit at the top. When we manage to look at it, we start from what the site knows; we can't guarantee the timing.

We don't see your sales: they stay on the till's phone and in the copies you download yourself. The on-chain public key, if you use it, lives in the till as well. We don't see your wallet's balance, and we can't spend your money or block your takings.

Customer's wallet
the money
→
Your walletbehind your Lightning address
↑ “an invoice?”  ·  “has it been paid?” ↓
The tillon the phone or computer
The site isn't in this picture. That's why, if it doesn't respond, a till that's already open keeps taking payments: it talks to your Lightning address, not to us.

The sheet to keep behind the till The shop's questions The first day, hour by hour The guide for shops


  1. 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”) and as seen in the shop's panel. Read on 10 November 2026, checked again on 12 November. ↩↩↩