A carteira da loja
O site não toca no dinheiro: a cada venda, a caixa pede à tua carteira um pedido de pagamento (fatura Lightning), a forma de a Lightning pedir o dinheiro (não a fatura fiscal), e os satoshis chegam lá. É precisa uma carteira com o endereço certo.
Para pagar, serve qualquer carteira Lightning. Para receber, é preciso um endereço Lightning que a caixa saiba ler. Quem procura a carteira para pagar encontra-a na lição 3.
A carteira da loja pode ser diferente daquela com que pagas, e convém que seja: para receber são precisas coisas de que quem paga não precisa. Com uma carteira para a loja e outra tua, além disso, os recebimentos não se misturam com as despesas, e à noite as contas batem certo mais depressa. De vez em quando, passa os recebimentos para as tuas poupanças, que não ficam no telemóvel da caixa: lição 6.
O que tem de fazer a carteira
Para receber, a carteira tem de fazer quatro coisas:1
- dar um endereço Lightning,
algumacoisa@dominio: a cada venda, a caixa pede-lhe o pedido de pagamento; - responder a «está pago?» (chama-se LUD-21
verify) a partir do domínio do endereço, ou de um subdomínio seu: a caixa não fala com mais ninguém, e assim uma resposta adulterada não a pode mandar para outro site. Um endereço no teu domínio que reencaminha tudo para um serviço noutro lado não serve; - responder ao navegador do telemóvel, onde corre a caixa;
- receber com o telemóvel desligado, ou pelo menos com a app fechada: muitas vezes a caixa está noutro telemóvel.
As três primeiras, o formulário verifica-as quando colas o endereço, e se faltar uma diz-te qual. O telemóvel desligado só se vê experimentando.
O que recomendamos
- Uma carteira não custodial na Spark: as palavras de recuperação são tuas, e recebe com o telemóvel desligado, sem canais nem liquidez para gerir. A Blink, no modo não custodial, experimentámo-la com a caixa a 11 de novembro de 2026: o pagamento foi confirmado com o telemóvel da carteira desligado (o teste).
- Um nó Lightning teu, se o tiveres: o seu endereço serve da mesma forma, se responder a «está pago?» (Um nó teu).
- On-chain só para os casos especiais: a chave põe-se nas definições da caixa, no telemóvel (Lightning ou on-chain).
Das cinco carteiras que experimentámos para pagar, com a caixa correu assim:
| Carteira | Endereço | Na caixa |
|---|---|---|
| Blink, não custodial | nome@blink.sv |
Recebe com o telemóvel desligado: experimentado a 11 de novembro de 20261 |
| Glow by Breez | nome@breez.cash (ou @breez.tips) |
Responde a «está pago?»: verificação de 12 de novembro de 20261. A 17 de novembro de 2026, a Pizzeria Le Fucine, a primeira loja a passar para as novas caixas, ligou-a à caixa e recebeu um pagamento de teste2. Com o telemóvel desligado ainda não foi experimentada |
| Phoenix | De outro tipo | Não funciona com a caixa: a caixa não lê o seu endereço. Para pagar, serve |
A Bitkit e a Blixt ainda não as experimentámos com a caixa. Os links para as descarregar todas estão em Escolher a carteira com cuidado.
Se abrires uma loja e ainda não tiveres carteira, o formulário acompanha-te: marcas «Ainda não tenho carteira» e encontras os passos um a seguir ao outro.
Glow by Breez, passo a passo
- Descarrega-a só a partir do link, na página da Breez, e não a procures na loja de apps: há outra «Glow», para a Solana, de outro editor. O editor certo é a Breez. No iPhone é preciso o iOS 18 ou posterior.
- As 12 palavras não aparecem sozinhas. Na primeira abertura, o botão grande «Get Started» cria uma passkey, e as palavras não aparecem. Abre-as logo em Settings → Backup → Recovery Phrase e escreve-as em papel; ou, na primeira abertura, escolhe «Use Recovery Phrase Instead». A app está em inglês.
- Dá ao endereço o nome da loja, antes de o colares no formulário. O nome inicial é ao acaso: em Receive → Edit põe o da loja, curto e sem espaços, por exemplo
barcentral. Se o mudares depois, o endereço que colaste deixa de receber. O endereço acaba em@breez.cash; também servem os antigos,@breez.tips.
No iPhone, a caixa abre-se no Safari
Se abrires o link para entrar a partir da app do Gmail, no iPhone a página fica no navegador interno do Gmail, e a caixa ficaria lá. Quando a caixa estiver aberta, leva-a para o Safari: no menu da página escolhe «Abrir no Safari», ou copia o endereço e cola-o no Safari. Depois, no Safari, guarda-a no ecrã principal: Partilhar → Adicionar ao ecrã principal. A caixa abre-se a partir do seu endereço, sem voltar a entrar. No Android vale o mesmo com o navegador do telemóvel, se o link se abriu dentro de outra app.
Como experimentar uma
Seja qual for a carteira que escolheres, o endereço liga-se e experimenta-se da mesma forma:
- Cria a carteira e escreve em papel as palavras de recuperação, pela ordem certa. Nem fotografias nem mensagens, e não as escrevas no formulário: nenhum de nós tas vai pedir.
- Procura o endereço Lightning. Parece um email,
algumacoisa@dominio. Não é o código comprido que começa porlnbc: esse só serve para um pagamento. - Cola-o no formulário. Experimenta-o logo, sem pagar nada, e diz-te se a caixa o pode usar.
- Experimenta-o com o telemóvel desligado. Desliga o telemóvel da carteira e, a partir de outro telemóvel, paga na caixa algumas centenas de satoshis. A caixa tem de dizer «Pagamento recebido» sozinha; depois liga outra vez o telemóvel, e os satoshis têm de lá estar. Faz-se com bitcoins verdadeiros: na rede de teste, poucas carteiras dão um endereço que responda a «está pago?».
Como correu, conta aos outros
As carteiras mudam: uma que funcionava pode perder a resposta a «está pago?» com uma atualização, uma que não funcionava pode funcionar agora. Conta o teu teste à comunidade, no próximo encontro ou escrevendo-nos, ou nas issues do bitmentor, onde servem também às outras comunidades: a carteira e a sua versão, o dia, a rede, e se funcionou ou em que passo parou, com o que diziam o formulário ou a caixa. Sem data e versão, quem vier depois não sabe se ainda vale.
A carteira fica no telemóvel do dono, nunca no de quem trabalha com ele: a quem está na caixa basta a sua caixa, que recebe e não gasta.
Para quem tem uma loja Lição 5: atrás do balcão Quem cria os teus pedidos de pagamento A Spark, e o que vigiamos
-
Bitmentor, «Choosing wallets for your community» (
docs/wallets.md), no repositório do bitmentor: o que tem de fazer uma carteira para a caixa, o que recomenda, os quatro passos para experimentar uma e o convite para contar o teste. O teste da Blink com o telemóvel desligado é de 11 de novembro de 2026; a verificação dos endereços da Blink e da Glow, de 12 de novembro de 2026. Consultado a 14 de novembro de 2026. ↩↩↩ -
Em produção, 17 de novembro de 2026: a Pizzeria Le Fucine, a primeira loja a passar da caixa antiga para a nova, assumiu a loja com o email, ligou um endereço
@breez.cashe abriu a caixa, em pouco mais de um minuto. O pagamento de teste que se seguiu correu bem, segundo quem estava presente: os pagamentos vão do cliente para a carteira da loja e o site não os vê. Com o telemóvel desligado não foi experimentado. ↩