Quando já arrancaste
A caixa recebe e tens o passe básico. O que vem depois chega uma etapa de cada vez, quando for preciso: o mapa, a rotina da noite, as funções avançadas e o jogo.
Numa linha Primeiro o mapa e o cartaz, depois o fecho da noite e quem trabalha contigo; o resto quando precisares, e o jogo quando a caixa já funcionar há alguns dias.
Nada está fechado à chave As etapas são uma ordem, não uma obrigação: podes ler tudo agora. As primeiras quatro, da loja ao passe básico, estão em Para quem tem uma loja; a lista de todos os guias, do primeiro ao último, está em Tudo, se quiseres.
As respostas vêm da área do comerciante e da documentação do bitmentor.1
5. No mapa
No mapa entras depois de um de nós ver a loja: fazemo-lo com cada loja nova. Enquanto esperas, a caixa recebe como sempre. Quando estiveres no mapa, a área do comerciante mostra «A tua ficha no mapa, agora».
Entras numa comunidade que aceita bitcoin desde 2013. Ganhas clientes que vêm de propósito, visitantes de fora e um lugar no mapa: Amadori conta de turistas do Norte da Europa a caminho do Véneto ou da Lombardia que pararam no Trentino porque no mapa deles a zona «explodia de laranja».
Em 2025, uma loja ativa fez em média 14 pagamentos, com um talão típico de 13 euros, e o espaço com mais pagamentos do ano fez 69 (os números do registo).
No mapa, a tua ficha tem um ícone para a Lightning, cheio enquanto o teu endereço responder: como se acende e como esmorece está em Selo, ícones e férias.
O cartaz e a ficha para a caixa
O cartaz imprime-se e afixa-se depois de a equipa aprovar a loja: a impressão, na área do comerciante, é para quando estiveres no mapa. Fica do lado dos clientes: o seu código abre a página da tua loja, onde está escrito como se paga lá, com uma ficha para mostrar na caixa e os sítios próximos onde se paga. Antes da aprovação, essa página só mostra o nome.
A ficha para a caixa fica do teu lado do balcão. Tem as instruções em poucas linhas e, se o juntares, o código que abre a caixa no telemóvel: com o código, guarda-a longe dos olhos dos clientes. O espaço para escreveres o teu nome e o teu telefone já lá está.
Queres alguma coisa para afixar também ao lado da caixa? Há a folha para ter atrás da caixa, com as três coisas a lembrar. E de vez em quando vê se o cartaz ainda é o teu: como e de quanto em quanto tempo, em QR, cartazes e links.
6. A rotina
Depois de algumas vendas, ou de alguns dias, a caixa torna-se um hábito. Ficam três coisas por aprender: fazer o fecho de caixa, levar as contas ao contabilista e dar uma caixa a quem trabalha contigo.
O fecho de caixa
Toca em «Fazer o fecho de caixa» na tua caixa, em «Histórico e fecho de caixa»: é o talão de fecho, como o do terminal. Diz quanto recebeste hoje, em euros e em satoshis, dividido por método (Lightning ou on-chain). Por baixo, o que há para verificar na carteira: as vendas que marcaste como pagas à mão e as que vieram das caixas de quem trabalha contigo e que a caixa não pôde verificar com o fornecedor. As vendas não pagas, expiradas ou canceladas, são só contadas.
O fecho faz a caixa, no teu telemóvel: o site não recebe nem vendas nem valores. Também podes ver os outros dias.
Depois comparas com a carteira: cada venda tem de ter o seu recebimento. Como se faz, linha a linha, di-lo Atrás do balcão.
O ficheiro para o contabilista, e as cópias
As vendas são tuas. No histórico da caixa descarregas as cópias: o ficheiro para o contabilista, para um mês ou para tudo, com uma linha por cada venda (hora, valor em euros, estado, forma de pagamento, satoshis recebidos e taxa de câmbio), e uma cópia cifrada, com uma palavra-passe que escolhes, para repor num telemóvel novo. A caixa lembra-tas com a frequência que escolheres.
As vendas ficam só no telemóvel e nas tuas cópias: o site não as vê nem as guarda. Se perderes o telemóvel sem uma cópia, perdes o histórico, não o dinheiro, que está na tua carteira.
O fecho não substitui o talão nem nada de fiscal. O preço fica em euros e o talão emite-se como sempre. O que dizem as normas e as perguntas a fazer ao contabilista: Os impostos na loja.
Reembolsos, e se quiseres euros
Se tiveres de devolver o dinheiro, o pagamento não se anula sozinho: paga-se outra vez a partir da tua carteira. No histórico da caixa, cada venda tem os seus satoshis e a taxa de câmbio desse momento: a partir daí sabes quanto devolver. Reembolsos, pagamentos duplos e a verificação da noite, passo a passo: Atrás do balcão.
A caixa dá-te bitcoin, não euros. Para passar a euros é precisa uma plataforma autorizada segundo o regulamento europeu, o Regulamento MiCA (MiCAR): o registo é mantido pela ESMA, a autoridade europeia dos mercados. Amadori diz que hoje as lojas de Rovereto guardam os bitcoins em vez de os trocarem logo. Tu podes fazer como preferires.
Quem trabalha contigo tem a sua caixa
Na área do comerciante, em «Caixas para quem trabalha contigo», dás a cada pessoa uma caixa só dela, com o seu nome («Ana», «turno da noite»), e pões-na no telemóvel dela com um código que só funciona uma vez e dura um dia. Cinco minutos por pessoa. Essa caixa só sabe receber: o que vê, o que não vê e como o seu histórico chega ao teu estão em Quem trabalha contigo.
A Ana também tem a sua caixa de treino. Na primeira vez que abre a caixa dela, lê e aceita três regras, as mesmas da folha para ter atrás da caixa. A caixa dela abre quando tu tiveres o passe básico.
Se a Ana deixar de trabalhar contigo, ou perder o telemóvel, na página «Caixas para quem trabalha contigo» tocas em «Desligar» ao lado do nome dela: a caixa dela para logo, as outras continuam. A tua caixa, pelo contrário, não se pode desligar: o link da tua caixa não o dás a ninguém.
No fim do turno. Com a tua npub nas definições da caixa, não há nada para passar: as vendas das caixas de quem trabalha contigo chegam sozinhas à tua (as cópias no Nostr). Sem npub, cada pessoa toca em «Terminar o turno» na sua caixa, descarrega a cópia cifrada do seu histórico e dá-ta com a sua palavra-passe: tu importa-la na tua caixa, sem passar pelo site. As vendas Lightning dela, a tua caixa verifica-as sozinha com o fornecedor do teu endereço; as outras entram como «declaradas», para verificar na carteira. O turno que passa da meia-noite conta no seu dia: até às 5 da manhã, «hoje» ainda é ontem.
Coisas que aprendemos
«Alguns custam a fazê-lo mesmo com o desconto de 22% […] porque é psicológico: caramba, custou-me a ganhá-los.» Marco Amadori, ImpAct 2025, frase abreviada
O desconto, a força de venda, o meio-termo e o contabilista, com os erros que nós cometemos, estão em O que Rovereto ensinou, a página para quem abre uma Valley. Aqui ficam as três regras de lojista.
Treina primeiro sem dinheiro, depois com um euro. A caixa de treino é feita para errar. Depois paga tu mesmo com outro telemóvel, antes de afixar o cartaz.
Decide antes o que fazer aos bitcoins. Guardá-los, trocar uma parte, pagar com eles a um fornecedor. Alguns comerciantes venderam logo e arrependeram-se, outros assustaram-se com as descidas.
A coisa que nunca deves fazer. Dar a alguém as palavras de recuperação da carteira, mesmo que diga que é dos nossos.
Se o site se desligar, a tua carteira continua a funcionar, e um endereço Lightning impresso continua válido.
7. O resto, quando for preciso
Estas funções não são precisas a todos, e não no primeiro dia. Na caixa estão nas «Definições», algumas em «Avançadas»; as outras na área do comerciante.
Receber também on-chain
Recebe-se com a Lightning; o on-chain é o plano B, para quando a carteira do cliente não percebe o teu código Lightning. No formulário da loja marcas «Também aceito pagamentos on-chain»: a chave da carteira pões nas definições da caixa, no telemóvel, e o site nunca a vê. A partir daí, por baixo do teclado, aparece «OK, on-chain». Experimentas no quinto exercício da caixa de treino.
| Lightning | On-chain | |
|---|---|---|
| Quanto demora | Poucos segundos | De alguns minutos a uma hora |
| Quando | Sempre: café, almoço, compras | O plano B, se a carteira do cliente não perceber o teu código Lightning |
| O que nos dás | O teu endereço Lightning | Nada: a chave pública estendida pões na caixa, no teu telemóvel |
| O que vemos | Que o endereço responde: nem as vendas nem o saldo | Que aceitas também on-chain, para o mapa o dizer, e quantos endereços deu a tua caixa: nem valores nem pagamentos |
O que muda para ti, e quando esperar por uma confirmação: Lightning ou on-chain.
Fechar para férias
A chegar nos próximos meses. O botão já existe no software, «Vais fechar por uns tempos?»: na Valley vamos ativá-lo aos poucos. Com ele, o mapa dirá «Fechada para férias» e quando reabres, sem dar a loja por extinta, e a caixa continua a funcionar. Como vai funcionar: Fechar para férias.
A tua loja no OpenStreetMap
O OpenStreetMap é o mapa livre que qualquer pessoa pode corrigir, e muitas lojas da Valley já lá estão. Na área do comerciante, «A tua loja no OpenStreetMap» diz-te se a loja lá está e que linhas sobre o bitcoin faltam ou são diferentes, na última leitura do mês. Podes atualizá-la sozinho, com os passos em palavras simples e as linhas para copiar, ou pedir-nos para o fazer com um toque: no OpenStreetMap só escreve uma pessoa da Valley, à mão.2 O que guardamos desses pedidos: a privacidade.
As cópias da caixa no Nostr
Além do ficheiro cifrado que descarregas tu, a caixa pode guardar uma cópia do histórico no Nostr, no relay da Valley (wss://bitcoinvalley.eu/relay). Escreve a tua chave pública, a npub, nas definições da caixa, em «Avançadas», na opção «Cópia no Nostr». Tudo é cifrado com a tua chave: o relay só vê dados cifrados, o site nada.3
As vendas das caixas de quem trabalha contigo chegam sozinhas à tua, enquanto as fazem, sem esperar pelo fim do turno: vês-las quando abres a tua caixa. Vale para as caixas emparelhadas depois de teres escrito a npub: as emparelhadas antes voltas a emparelhá-las com um código novo, em «Caixas para quem trabalha contigo». Sem npub, fica o ficheiro cifrado, que se passa no fim do turno.
O desconto para quem paga em bitcoin
No mapa, 13 lojas fazem desconto, de 10 a 22%. Não serve para poupar a comissão do terminal, que vale um ou dois pontos: serve para convencer quem tem bitcoin a gastá-lo em vez de o guardar.
Escreves no formulário da loja. Na caixa está em «Definições», em «Preços»: parte do teu desconto, ou do que a Valley sugere se não tiveres um, e mudas ou desligas tu. Podes deixar que as caixas o tirem de uma venda, e arredondar para baixo o preço com desconto para um valor redondo.1
Mudar o endereço Lightning, ou a carteira
Faz-se na área do comerciante: «Editar», depois «Mudar o endereço Lightning». É o sítio para onde vai o dinheiro, por isso há cautelas: tens de ter entrado nos últimos 15 minutos, o site experimenta o endereço novo ao vivo, e só o podes mudar no máximo uma vez a cada sete dias (a mesma espera aplica-se depois de mudares o email de recuperação). Recebes um aviso.
A loja e o cartaz ficam os mesmos. Cada caixa abres outra vez confirmando a mudança, e as de quem trabalha contigo têm de ser emparelhadas outra vez. O selo volta assim que o site vir o novo endereço a funcionar. Quando convém mudá-lo, por exemplo se o fornecedor dos teus pedidos de pagamento (fatura Lightning: a forma de a Lightning pedir o dinheiro, não a fatura fiscal) parar: Quem cria os teus pedidos de pagamento.
8. O jogo
O jogo vem depois da caixa: quando já recebeste durante alguns dias, o passe ainda tem algo para te dar, e a loja algo para mostrar.
Os outros módulos do passe
Além dos quatro básicos, na área do comerciante, em «O teu passe do balcão», há mais quatro módulos: quem cria os teus pedidos de pagamento, QR e cartazes, os impostos, o que fazemos e o que não fazemos. Não param a caixa, e cada um remete para uma página do site, com algumas perguntas e algumas frases para marcar.
Depois, três gestos, que marcas tu quando os tiveres feito: «Treino feito», depois da caixa de treino; «Cópia de segurança verificada» e «Levantamento experimentado», depois dos dois testes com poucos satoshis.4
O selo
Quando o teu endereço Lightning responde e passaste o passe básico, chega à tua ficha o selo «Loja certificada». Não o pedes: chega sozinho, e a área do comerciante diz-te o que falta. As regras estão em Selo, ícones e férias.
O passaporte
O passaporte do peregrino guarda um carimbo por cada gesto feito no site: o primeiro café registado a fingir, a assinatura com uma chave verdadeira, a burla desmontada, o passeio. Fica tudo no teu navegador, sem conta, e há também uma caderneta para imprimir.
Para quem tem uma loja Tudo, se quiseres As perguntas da loja Se algo não está bem Abrir a área do comerciante
-
O que fazem a caixa e a área do comerciante, tal como o descreve a documentação do bitmentor (github.com/mammadori/bitmentor, pasta
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») e como se vê na área do comerciante da loja. Consultados a 10 de novembro de 2026, verificados de novo a 12 e a 19 de novembro. ↩↩ -
Bitmentor, «OpenStreetMap» (
docs/features/openstreetmap.md), no mesmo repositório: o site lê o OpenStreetMap uma vez por mês e não escreve lá sozinho; o pedido do comerciante é feito por uma pessoa, à mão. Consultado a 19 de novembro de 2026. ↩ -
Bitmentor, «Copies on Nostr» (
docs/features/nostr-copies.md), no mesmo repositório: a npub do dono nas definições da caixa, a cópia cifrada com NIP-44, o relay que só vê dados cifrados. Consultado a 19 de novembro de 2026. ↩ -
Bitmentor, «The merchant's training» (
docs/features/merchant-training.md), no mesmo repositório, e os módulos do passe da Valley. Consultado a 19 de novembro de 2026. ↩