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.

Para quem tem uma loja · Quando é preciso uma mão

Se algo não está bem

Uma caixa que faz uma coisa estranha, com um cliente à frente, deixa toda a gente ansiosa. Na área do comerciante basta um toque: escolhes o que se passa, o site diz-te o que sabe sobre a tua loja e o que fazer agora, e se não chegar envias-nos o pedido: tentamos ajudar-te, sem garantia de prazos. O dinheiro, entretanto, fica na tua carteira: a caixa não o guarda.

Antes de mais Não canceles nem voltes a registar a venda. Um pagamento não se cancela sozinho: quase sempre basta esperar, e a caixa diz como terminou.

Na área do comerciante: «Algo não está bem?»

Na área do comerciante, por baixo do nome da loja, está o botão «Algo não está bem?». Também o encontras no menu da tua caixa, o botão lá em cima, onde estás com o cliente à frente. Abre-se em seis frases, as que dirias na caixa, e são as mesmas desta página.1 Por baixo de cada uma:

  • «O que o site sabe sobre a tua loja»: primeiro o que não está bem, depois, numa ficha fechada, o que funciona. Fala contigo, com as tuas palavras. A página abre logo porque só olha para o que o site já tem; se quiseres que experimente também o teu endereço Lightning, toca em «Verificar outra vez» (pode demorar até 20 segundos).
  • «O que fazer agora», passo a passo.
  • «Pedir ajuda à Valley»: se não chegar, um toque, e o pedido chega-nos com o que o site sabe. Como funciona está mais abaixo, em Pede ajuda com um toque.

Esta página serve para quem não está na área do comerciante, ou quer ler antes: diz as mesmas coisas, caso a caso.

O cliente não consegue pagar

O que vês

A carteira do cliente dá erro, ou o código não é lido, ou a caixa não mostra nenhum código.

O que fazes agora

  1. Recomeça a venda a partir da caixa: aparece um código novo. Um código antigo pode deixar de funcionar, e se a caixa disser «Pagamento expirado», o cliente não pagou nada.
  2. Pede ao cliente para ler o código dentro da app da carteira, não com a câmara do telemóvel, e para verificar se tem o suficiente na carteira. O código não é lido? Toca em «O código não é lido? Mostra-o como texto»: o cliente pode copiá-lo.
  3. Se a caixa não mostrar nenhum código ou a página não abrir, vê a ligação do telemóvel e recarrega a página.
  4. O cliente não tem carteira, ou não sabe como se paga? Mostra-lhe a ficha para os clientes sem carteira: não tens de explicar nada.
  5. Na área do comerciante vês «Lightning: o teu endereço não responde»? Toca em «Tentar outra vez agora». Depois abre a tua carteira: o endereço Lightning ainda é esse? Se mudou, põe o novo a partir da área do comerciante: a loja e o cartaz ficam iguais. Se é o mesmo, o teu fornecedor pode estar com um problema: tenta outra vez daqui a pouco, ou pede ajuda.
  6. Não deixes o cliente à espera: se configuraste o on-chain, «OK, on-chain» é outro caminho; se nada funcionar, pode pagar de outra forma. Depois pede ajuda.

O que faz o site sozinho

O site experimenta o teu endereço de poucas em poucas horas, como o usa a caixa: gera um pedido de pagamento que ninguém paga, e na carteira de vez em quando vês um expirado. Se deixar de responder, escreve-te (para o email com que entras, no chat do Telegram da loja, se o indicaste, e na área do comerciante), e volta a escrever-te quando voltar a funcionar. Nós também o vemos, na lista das coisas a ver.

O pagamento fica à espera

O que vês

A caixa diz «À espera do pagamento», e o cliente jura que pagou (no telemóvel dele está escrito «Enviado»).

O que fazes agora

  1. Não peças ao cliente para pagar outra vez, não canceles, não voltes a registar, e ainda não entregues. Quem trabalha contigo espera pelo visto verde da caixa, não olha para o telemóvel do cliente.
  2. Com a Lightning bastam poucos segundos. Se passar mais tempo, verifica se o telemóvel da caixa tem Wi-Fi ou dados.
  3. Se a caixa disser «Sem ligação», espera: o pagamento aparece assim que a ligação voltar. Se disser que não saiu nada, carrega outra vez em OK quando houver ligação.
  4. Tu, que tens a carteira, abre a tua carteira: o dinheiro chegou? Se sim, o pagamento é bom mesmo que a caixa esteja à espera: toca em «Vejo o pagamento na minha carteira», e no fecho de caixa essa venda fica entre as que há para verificar. Se acontecer muitas vezes, pede ajuda: tentamos perceber porque é que a caixa não deu por isso.
  5. O dinheiro não está lá? Um pagamento Lightning é imediato: o cliente vê a carteira dele e tenta outra vez. Um pagamento on-chain, escrito diretamente no registo do Bitcoin, pode demorar de alguns minutos a uma hora.
  6. Abre o histórico da caixa: cada venda tem o seu estado e diz como terminou.

O que faz o site sozinho

A caixa pergunta à tua carteira, de poucos em poucos segundos, se o pagamento chegou. A venda fica no histórico até terminar: paga, expirada ou cancelada. Um pagamento on-chain visto mas ainda não confirmado podes deixá-lo lá, com «Cliente seguinte», e a caixa volta a verificá-lo depois.

A caixa não abre

O que vês

A página da caixa não carrega, ou diz «O site não responde».

O que fazes agora

  1. Verifica o Wi-Fi ou os dados do telemóvel, e depois tenta outra vez daqui a um minuto.
  2. Perdeste o link da caixa? Na área do comerciante, toca em «Abrir a caixa». Se te pedir para entrar, entra com o link que te enviamos para o email com que te inscreveste. Com a carteira, só se a ligaste à tua conta («A tua conta», «Entrar também com uma carteira»): senão a carteira abre uma conta nova e vazia.
  3. Uma pessoa que trabalha contigo não consegue abrir a sua caixa? O código na ficha dela só funciona uma vez e dura um dia: se expirou, cria um novo na área do comerciante: «Caixas para quem trabalha contigo», e depois «Pôr num telemóvel» ao lado do nome dela.
  4. Num telemóvel que já a abriu, a caixa recebe com a Lightning mesmo que o site não responda: o pedido de pagamento (fatura Lightning) pede-o diretamente ao teu endereço. Carrega em «Vejo o pagamento na minha carteira» só se o vires mesmo na carteira da loja. Se não o vires, não entregues e pede ajuda.

O que faz o site sozinho

O dinheiro vai sempre diretamente para a tua carteira: o site não lhe toca. Um endereço Lightning impresso continua válido. A caixa fala diretamente com a tua carteira: se o site não responder, num telemóvel que já a abriu continua a funcionar. As vendas ficam no telemóvel, e o site não as vê.

Perdi o telemóvel, ou mudei de telemóvel

O que vês

Já não consegues entrar a partir do telemóvel que usavas, ou outra pessoa pode tê-lo.

O que fazes agora

  1. Telemóvel de uma pessoa que trabalha contigo: na área do comerciante, em «Caixas para quem trabalha contigo», abre as caixas e toca em «Desligar» ao lado do nome dela. Essa caixa para logo e as outras continuam. Para o telemóvel novo, cria uma caixa nova, com um código novo.
  2. O teu telemóvel, para a caixa: entra no telemóvel novo com o link que te enviamos por email, ou com a carteira, se a ligaste à tua conta, e toca em «Abrir a caixa»: adiciona-a ao ecrã do telemóvel novo. Na caixa não há dinheiro nem palavras de recuperação: só sabe pedir pagamentos, e chegam a ti. O histórico das vendas estava no telemóvel antigo: repõe a última cópia cifrada que descarregaste, com a sua palavra-passe, e volta tudo o que lá havia até esse dia. As definições do on-chain, se as usas, voltas a escrevê-las.
  3. O telemóvel com a carteira: a carteira repõe-se num telemóvel novo com as doze palavras que escreveste em papel. Nós não as temos e não as podemos recuperar. Deixa dito a uma só pessoa de confiança onde encontrar a folha, se te acontecer alguma coisa: as palavras ninguém as lê nem as fotografa.
  4. A carteira também é nova? Na área do comerciante toca em «Editar» e depois em «Mudar o endereço Lightning», e põe o endereço da carteira nova: só tu o podes fazer, tendo entrado há pouco. A loja, a sua página e o cartaz ficam os mesmos; cada caixa abres outra vez confirmando a mudança. Se ficares bloqueado, pede ajuda.

O que faz o site sozinho

A caixa de uma pessoa que trabalha contigo não vê as tuas vendas nem as definições, e não pode mudar o destino do dinheiro. Desligada, já não aceita pagamentos novos, mas durante um dia ainda abre: uma venda que já esteja no ecrã termina aí, e descarrega-se a cópia do turno.

Dei troco a mais, ou o cliente pagou a mais

O que vês

O cliente pagou duas vezes, ou on-chain enviou mais do que devia. Ou foste tu que deste troco a mais.

O que fazes agora

  1. Entrega a mercadoria: a venda está paga.
  2. Verifica na tua carteira se o valor a mais chegou mesmo. Se não estiver lá, não devolves nada.
  3. Abre o histórico da caixa: cada venda tem o valor, os satoshis e a taxa de câmbio desse momento. A partir daí sabes quanto devolver.
  4. Devolve a diferença a partir da tua carteira, não da caixa. Se o cliente concordar, também em dinheiro. Se trabalhas na caixa e não és o dono, anota a hora e o valor e liga-lhe: quem devolve é o dono, nunca com dinheiro teu.
  5. Foste tu que deste troco a mais? A caixa não pode recuperar esse dinheiro, e um pagamento já feito não muda. O histórico dá-te o valor certo da venda, para as tuas contas.

O que faz o site sozinho

Nada: o dinheiro e as vendas são teus. O site não vê os pagamentos, não envia nada ao cliente e não guarda contas. O dinheiro devolves tu, e o histórico da caixa diz-te quanto.

Outra coisa

O que vês

Alguma coisa não bate certo e nenhuma das situações acima se parece com a tua. Não faz mal: acontece, e basta dizeres-nos numa linha.

O que fazes agora

Na área do comerciante toca em «Algo não está bem?», depois em «Outra coisa», e pede ajuda: uma linha sobre o que vês e desde quando, e tentamos ver tudo o que o site sabe sobre a tua loja.

Não consegues entrar na área do comerciante? Então escreve para info@bitcoinvalley.eu, com quatro coisas: o nome da loja, a hora, o que está escrito no ecrã (também serve uma fotografia) e como preferes ser contactado. Tentamos responder-te, sem garantia de prazos.

Há uma só coisa que nunca vai na mensagem, nem no site nem por email: as doze palavras da carteira. Nós nunca precisamos delas, e o site recusa-as.

O que faz o site sozinho

Quem vê o teu pedido tem uma ferramenta que lê a tua loja e diz, em palavras simples, o que não está bem: o endereço Lightning, o primeiro dia, as caixas de quem trabalha contigo. As vendas não: estão no teu telemóvel. Só lê: não muda nada na tua loja, e «Algo não está bem?» nunca te pede um endereço nem uma chave.

Pede ajuda com um toque

Por baixo de cada frase da área do comerciante está «Pedir ajuda à Valley».1

  • Uma linha, se quiseres. Escreve o que vês e desde quando, em poucas palavras (até duzentos caracteres, numa linha só). Uma chave ou as palavras da carteira, o site recusa-as.
  • Como preferes ser contactado. Por email, para o endereço com que entras (a área do comerciante mostra-o com algumas letras escondidas); no Telegram, no chat da loja; no telefone da loja; ou «Vou ver a minha área do comerciante: diz quando estiver resolvido».
  • O que nos chega. O nome da loja, o que se passa, a tua linha, como te contactar (a forma, nunca o endereço nem o número) e o que o site sabe sobre a tua loja nesse momento. Nunca uma chave, nunca um endereço. O pedido fica no topo da nossa lista; quando estiver resolvido, alguém o marca como «resolvido».
  • O que vês tu. Na área do comerciante, «Pediste ajuda às 10h32» e depois «Resolvido», durante três dias. Se a mensagem não nos chegar (o Telegram não está configurado, ou não responde), o pedido fica guardado na mesma e a área do comerciante diz-to.

Até três pedidos por dia por loja. Não é um chat: tentamos contactar-te como pediste, sem garantia de prazos, e marcamos o pedido como «resolvido» quando estiver resolvido. O que podemos fazer e o que não: as condições da ajuda.

«Algo não está bem?» nunca muda a caixa, o cartaz, as caixas de quem trabalha contigo nem o destino do dinheiro.

O que o site prepara para nós, sem tu fazeres nada

O site prepara-nos uma lista de coisas a ver:1 os endereços Lightning que não respondem e desde quando, as lojas mudadas de sistema que ainda esperam pelo dono ou pela carteira. A tua loja está lá se tiver um problema, e os pedidos de ajuda ficam no topo. Quando conseguimos vê-la, partimos do que o site sabe; os prazos não os podemos garantir.

As tuas vendas não as vemos: ficam no telemóvel da caixa e nas cópias que tu descarregas. A chave pública on-chain, se a usares, também fica na caixa. Não vemos o saldo da tua carteira, e não podemos gastar o teu dinheiro nem bloquear os teus pagamentos.

Carteira do cliente
o dinheiro
→
A tua carteirapor trás do teu endereço Lightning
↑ «um pedido de pagamento?»  ·  «está pago?» ↓
A caixano telemóvel ou no computador
O site não está neste desenho. É por isso que, se não responder, a caixa já aberta recebe na mesma: fala com o teu endereço Lightning, não connosco.

A folha para ter atrás da caixa As perguntas da loja O primeiro dia, hora a hora O guia para as lojas


  1. 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») e como se vê na área do comerciante da loja. Consultados a 10 de novembro de 2026, verificados de novo a 12 de novembro. ↩↩↩