Rovereto, Quinta-feira 19 de Novembro de 2026 · Ano XIII, n.º 323
pt
Bitcoin Valley
ÍndiceFechar

Crónicas do vale onde se paga em bitcoin.

Aprender · Lição 5 de 8 · Para quem tem uma loja · Versão fácil

Atrás do balcão

As outras lições são para quem paga. Esta é para quem está do outro lado, com o telemóvel da caixa na mão.

Numa linha O dinheiro vai da carteira do cliente para a tua. A caixa escreve o valor e pergunta se chegou: não o guarda, não lhe toca.

O que acontece quando o cliente paga

Escreves 3,50 euros. A caixa converte-os em satoshis ao câmbio desse momento e pede ao teu endereço Lightning uma fatura desse valor: a fatura Lightning, um pedido de pagamento, que nada tem a ver com a fatura fiscal. O QR que o cliente aponta é essa fatura: a carteira dele paga a tua, diretamente. Depois a caixa pergunta a quem te dá o endereço se a fatura foi paga, e quando a resposta é sim mostra a confirmação.

Carteira do cliente
o dinheiro
→
A tua carteirapor trás do teu endereço Lightning
↑ «uma fatura de 3,50 €?»  ·  «está paga?» ↓
A caixaescreve, pergunta, confirma
A caixa não está no caminho do dinheiro: está ao lado, e faz perguntas.

Por isso nem todos os endereços servem. A caixa precisa que o fornecedor responda à segunda pergunta, «está paga?», e que responda a partir do domínio do teu endereço, diretamente ao navegador do telemóvel: a caixa não fala com mais ninguém.1

O que experimentámos.

  • 11 de novembro de 2026: um endereço Blink não custodial respondeu mesmo com o telemóvel da carteira desligado.
  • 12 de novembro: a Blink, a Glow by Breez e a Cake Wallet passaram a verificação do site, que no entanto ainda não é um pagamento com o telemóvel desligado.
  • 2 de novembro: a Zeus e o Alby Hub tinham dado um endereço válido no teste.
  • Phoenix: o endereço é de outro tipo, e a caixa não o usa.

O formulário faz a mesma verificação quando o escreves, sem pagar nada, e diz-te logo se a caixa o pode usar. Qual escolher é uma escolha tua: a lição 3 diz quais recomendamos e o que verificar.

Em quem confiamos «Não lhe toca» vale para o dinheiro. Para as perguntas confia-se em quem gere a caixa, que decide a que endereço pedir a fatura: é por isso que, mais abaixo, está a verificação do fim do dia.

O preço continua em euros

O talão passa-se como sempre, em euros. Em satoshis o mesmo valor muda de um dia para o outro, porque muda o câmbio: o café de ontem e o de hoje não valem os mesmos satoshis. O que fazer com o que recebes, guardá-lo, trocá-lo ou pagar com ele a um fornecedor, decide-o antes, e fala disso com o contabilista: Coisas que aprendemos conta o que vimos fazer, e O fisco na loja é uma ficha para lhe levar.

Lightning ou on-chain

Lightning On-chain
Tempo Poucos segundos De alguns minutos a uma hora
Taxa Cêntimos Não olha para o valor
Quando Quase sempre Se a carteira do cliente não ler Lightning
Se aceitares antes da confirmação A confirmação chega com o pagamento feito Um risco pequeno com quem conheces, maior com quem não conheces

Na caixa quase tudo passa pela Lightning. O on-chain, o pagamento escrito diretamente na cadeia de blocos, é o plano B. O cliente aponta ao teu código e a carteira dele não o percebe? Talvez só pague on-chain: não desesperes, toca em «OK, on-chain» e a caixa mostra-lhe um endereço da tua carteira. O botão aparece se nas definições da caixa puseste a chave pública da tua carteira para o on-chain. Para ti há também uma vantagem: o dinheiro chega direto à tua carteira, sem passar por nenhum fornecedor. É o quinto exercício da caixa de treino, «O cliente não percebe o teu código».

Se o aceitares antes da confirmação corres um risco pequeno com quem conheces e maior com quem não conheces: a lição 8 explica porquê, com o empregado de café que ninguém quer zangar. A partir de que valor esperar por uma confirmação escolhes nas definições da caixa.

A caixa usa os endereços de receção da tua carteira, um novo para cada venda, e vês-los na carteira como qualquer recebimento. Por isso, enquanto usares a caixa, não dês a ninguém os endereços de receção dessa carteira para outros pagamentos: um pagamento alheio com o valor certo, nos mesmos minutos, a caixa tomá-lo-ia pela venda. Para outros recebimentos usa outra carteira, ou outra conta da mesma.

Quando o dinheiro tem de voltar para trás

Um pagamento não se anula sozinho, nem o teu nem o do cliente. Se marcaste 12,00 em vez de 1,20 e o cliente já pagou:

  1. o cliente abre a carteira dele, escolhe «Receber» e mostra-te um QR com a diferença;
  2. pagas-lhe a partir da tua carteira, não da caixa;
  3. aponta a hora e o valor: à noite, na carteira, vai haver uma saída que a caixa não conhece.

Há também o caso contrário. Cada fatura foi pensada para um único pagamento. Duas faturas, porém, são dois pagamentos: se anulares uma venda e a voltares a marcar, e o cliente pagar os dois QR, o dinheiro chega-te duas vezes. A caixa marca a primeira como «paga depois da anulação», e o fecho do dia põe-na entre as que há para acertar com o cliente. É dinheiro do cliente: devolve-se da mesma maneira.

O histórico da caixa dá-te uma ajuda: cada venda tem o valor, os satoshis e o câmbio desse momento, e daí sabes quanto devolver. O site não vê as vendas, não envia nada ao cliente e não toca na fatura: o dinheiro devolves tu.

Quem trabalha contigo

A tua caixa A caixa de quem trabalha contigo
As vendas Vês todas Só vê as suas
As definições Mudas tu Não as vê
Reembolsos e pagamentos a mais Fazes tu Vão para ti
Para onde vai o dinheiro Decides tu Não o pode mudar: vai para a tua carteira
Como se põe no telemóvel Na tua área do comerciante Com um código que só vale uma vez
Para a parar – Desligas tu, e para logo

A caixa é uma página no telemóvel ou no computador da loja, e só sabe fazer uma coisa: pedir pagamentos. Não gasta, não mostra o saldo, não conhece as tuas palavras de recuperação. Podes deixá-la nas mãos de quem trabalha contigo sem lhe dares a tua carteira. Cinco minutos chegam para a explicar: valor, QR, espera pela confirmação, e se a confirmação não chegar não se volta a marcar a venda, espera-se.

Melhor ainda, na área do comerciante fazes para cada pessoa a sua caixa, com o nome dela. Põe-se no telemóvel com um código que só vale uma vez: uma fotografia do código não abre nada. Na primeira abertura a pessoa lê e aceita três regras, as mesmas da folha para ter atrás da caixa. Essa caixa recebe e mais nada: não vê as tuas vendas nem as definições, e os reembolsos e os pagamentos a mais vão para ti. No fim do turno dá-te a cópia cifrada do seu histórico, com a palavra-passe dela: importas-la na tua caixa, e vês de que caixa partiu cada venda. As vendas Lightning dela, a tua caixa verifica-as sozinha com o fornecedor; as outras entram como «declaradas», para verificar na carteira.

Se a pessoa se for embora, ou perder o telemóvel, desligas a caixa dela e para logo. Cada um tem também a sua caixa de treino, sem dinheiro: para quem começa, dez minutos. Para quem está na caixa há uma folha para imprimir com as três coisas a lembrar.

A regra que qualquer pessoa na caixa tem de saber é a mesma do cliente: ninguém dos nossos vai alguma vez pedir as palavras de recuperação, ao telefone ou pessoalmente.

Se um cliente te pedir para lhe trocares bitcoins por dinheiro vivo, fica a saber que em Itália fazê-lo como serviço, mesmo com dinheiro teu, exige a autorização prevista no regulamento europeu MiCA (MiCAR): desde 1 de julho de 2026 a antiga inscrição na OAM já não chega.

A verificação do fim do dia

Aqui há uma experiência: o dia de um café, a caixa de um lado e a carteira do outro, e uma linha que não bate certo. Precisa de JavaScript; a lição está completa mesmo sem ele.

À noite toca em «Fechar o dia» na caixa: é o talão de fecho, com quanto recebeste, por método, e as vendas a verificar na carteira. Depois descarrega a cópia: as vendas só estão no telemóvel ou no computador da caixa e nas cópias que guardas tu.

Depois, à noite ou pelo menos uma vez por semana, põe lado a lado as vendas da caixa e os recebimentos da carteira. Cada venda tem de ter o seu recebimento, à mesma hora e com os mesmos satoshis. As linhas que não batem certo são quase sempre os reembolsos e os pagamentos em duplicado de há pouco: no histórico da caixa cada venda tem o seu estado.

Só uma é grave: uma venda que a caixa dá como paga e que não está na tua carteira. Quer dizer que essa fatura foi emitida por outra pessoa. Nesse caso deixa de usar essa caixa e avisa logo quem gere o site: aqui está como nos escrever.

O endereço só o mudas tu, na área do comerciante («Editar», depois «Mudar o endereço Lightning»), no máximo uma vez por semana: a loja, a caixa e o cartaz ficam os mesmos, e recebes uma confirmação por email. Se não foste tu, escreve-nos logo.

Três perguntas

Fazem-tas na loja. Tenta responder, depois abre.

«Se a caixa se desligar, perco os recebimentos?»

Não. O dinheiro está na tua carteira, não na caixa. Se o site se desligar a carteira continua a funcionar, e um endereço Lightning impresso continua válido.

«O cliente pagou duas vezes: o que faço?»

Devolves-lhe a diferença: ele mostra-te um QR da carteira dele, em «Receber», e tu pagas a partir da tua. O pagamento não se anula sozinho.

«Porque é que tenho de comparar a caixa com a carteira?»

Porque o dinheiro só a carteira o vê. A tua caixa lembra-se do endereço onde recebes, e se o site lhe der outro para e diz-to. Uma página da caixa adulterada, porém, pode mostrar ao cliente outro QR: o dinheiro iria para outro lado, e só a comparação com a carteira dá por isso.

Lição 6: guardar, e deixar Abre a tua caixa Todas as lições


  1. Bitmentor, «Choosing wallets for your community» (docs/wallets.md), no repositório do bitmentor: o que uma carteira tem de fazer para a caixa, o teste da Blink com o telemóvel desligado de 11 de novembro e a verificação da Blink, da Glow e da Cake Wallet de 12 de novembro de 2026. Lido a 12 de novembro de 2026. ↩