Caixa – guia para comerciantes

Com o caixa KAI-Pay, você aceita pagamentos em Bitcoin via Lightning, por exemplo no balcão ou numa banca de feira. O caixa é uma página separada (kasse.kai-pay.net) sem chaves: só pode criar faturas, mas não enviar dinheiro. Cada pagamento vai direto para a sua carteira KAI-Pay em autocustódia. Lá você vê o fechamento diário e mensal e pode fazer reembolsos.

O KAI-Pay é uma beta pública. O caixa é um terminal de pagamento, não uma caixa registradora (veja Limites).

1. Requisitos

Uma carteira KAI-Pay cujas 12 palavras você guardou com segurança e confirmou na app.
Um endereço Lightning: crie-o na carteira, em “Receber”.
Internet no dispositivo do caixa. Não é necessário ter conta nem fazer inscrição.

2. Configurar o caixa

Na carteira, abra o menu e escolha “Caixa & fechamento”. Bem no final está “Configurar caixa (PDV)”.
Opcionalmente, informe um nome do caixa, por exemplo “Balcão 1” ou “Feira”. Com o nome, mudam o link e o código QR.
Abra o caixa:
- No mesmo dispositivo: “Abrir o caixa neste dispositivo”. O caixa abre numa nova aba ou, na app Android, no navegador.
- Num dispositivo de caixa próprio (por ex., um tablet no balcão): leia o código QR com esse dispositivo ou copie ou envie o link e abra-o lá.

O link contém o seu endereço Lightning, o nome do caixa e uma chave pública dos comprovantes. Esses dados ficam na parte do link depois de “#”; não são transmitidos a nenhum servidor. O caixa guarda essas informações no dispositivo do caixa. Na próxima vez que você abrir kasse.kai-pay.net, ele inicia diretamente; a partir daí, você não precisa mais do link.

Se alguém abrir, num dispositivo de caixa já configurado, um link com outro endereço ou outra chave dos comprovantes, o caixa pede confirmação antes de mudar. Só confirme se foi você mesmo que configurou isso. O caixa e a carteira mostram a impressão digital da chave dos comprovantes; você pode comparar as duas.

3. Cobrar

Digite o valor: numa moeda local (EUR, USD, GBP, CHF, CAD, AUD ou JPY, convertido pela cotação do mempool.space exibida com a hora da cotação) ou em sat (“Digitar em sat”). A cotação fica fixada para a fatura. Em moeda local, o caixa só cobra com uma cotação obtida há no máximo 5 minutos e que, segundo o mempool.space, tenha no máximo 30 minutos.
“Cobrar”: o caixa mostra uma fatura como código QR.
O cliente lê o código com qualquer carteira Lightning e paga.
O caixa mostra “Pago” e um comprovante de pagamento numerado. Ele é uma prova de pagamento, não um recibo fiscal. “Comprovante em PDF” grava o comprovante num arquivo.

Avisos do caixa:

Cancelar: uma fatura cancelada ainda pode ser paga. Se o pagamento chegar depois, o caixa avisa isso expressamente.
Página recarregada: “Fatura em aberto retomada” – o caixa retoma a verificação da fatura em curso. Não cobre duas vezes.
“Fatura expirada – não paga”: cobre de novo.
“Status do pagamento desconhecido” (sem conexão): antes de cobrar de novo, confira o recebimento na carteira.
“Últimas faturas” mostra as faturas mais recentes deste dispositivo (no máximo 20 dos últimos 7 dias). O que vale é sempre o histórico na carteira.

Cobrar com produtos

“Gerenciar produtos”: nome, preço e moeda do preço (moeda local ou sat) e, opcionalmente, categoria e alíquota de imposto. A alíquota é apenas uma informação no comprovante; o KAI-Pay não calcula impostos.
“Produtos”: toque nos produtos e altere a quantidade com − e +. Um carrinho tem exatamente uma moeda.
“Cobrar”: o total passa a ser a fatura. Itens, preços e cotação ficam fixados para este pedido – mudanças de preço posteriores não alteram comprovantes pagos.

Os produtos ficam apenas no dispositivo do caixa. “Exportar catálogo” grava os produtos num arquivo; para usá-los em outro caixa ou na carteira (Caixa & fechamento → Produtos), use “Importar catálogo”. A carteira só precisa do catálogo para mostrar os itens com nome; uma nova importação não altera os nomes de produtos já importados. Renomear cria um novo produto no caixa, para que comprovantes antigos mantenham o nome.

Itens e valores em moedas diferentes do euro só chegam à carteira se o caixa tiver sido configurado pelo link do caixa atual da sua carteira. Caixas configurados com um link mais antigo: abra de novo, uma vez, o link do caixa na carteira. Até lá, os itens aparecem apenas no comprovante do caixa.

Comprovante em PDF

O caixa e a carteira geram o comprovante em PDF no dispositivo, a partir dos dados armazenados, sem servidor; gerado de novo, o mesmo pagamento resulta no mesmo arquivo (mesmo idioma e fuso horário). O caixa mantém comprovantes apenas para as suas faturas mais recentes (no máximo 20 dos últimos 7 dias). O comprovante é uma prova de pagamento, não uma fatura fiscal nos termos do § 14 UStG (Alemanha) nem um recibo fiscal. Para reembolsos, a carteira cria um comprovante de reembolso próprio.

4. Nome do caixa e vários caixas

A carteira não armazena o nome do caixa. Ele percorre este caminho:

O nome está no link. O caixa guarda o nome no dispositivo do caixa, junto com um identificador aleatório do dispositivo e um contador sequencial de comprovantes.
A cada pagamento, o caixa envia junto uma nota criptografada: identificador do dispositivo, nome do caixa, número do comprovante, valor em moeda local e cotação e, no caso de produtos, também os itens. Só a sua carteira consegue ler essa nota.
A carteira lê essas notas nos pagamentos e, no fechamento, associa cada uma ao caixa correspondente.

Renomear: abra o link com o novo nome no mesmo dispositivo do caixa. O identificador do dispositivo e a numeração dos comprovantes continuam; pagamentos anteriores mantêm o nome que tinham na época.
Sem nome: o caixa mantém o nome anterior ou recebe o nome “Caixa”.
Vários caixas: configure cada dispositivo com um nome próprio. Dois dispositivos com o mesmo nome aparecem no fechamento como linhas separadas, e a carteira avisa você sobre isso.

5. Fechamento diário

Na carteira, em “Caixa & fechamento”, escolha um dia. Para cada caixa, você vê:

o número de pagamentos e o total em sat,
o valor segundo o caixa por moeda local (pela cotação fixada na fatura),
o intervalo dos números de comprovante, bem como números ausentes ou duplicados,
os reembolsos e o valor líquido.

Além disso, a carteira lista “Outros recebimentos” (pagamentos para o seu endereço que não vieram pelo caixa) e pagamentos ainda pendentes.

6. Fechamento mensal e exportação CSV

“Exportar dia como CSV” ou “Exportar mês como CSV” grava um arquivo com uma linha por transação:

data, hora, caixa e número do comprovante,
valor em sat e taxa,
valor segundo o caixa, com moeda e cotação,
ID do pagamento e tipo (venda ou reembolso; reembolsos com sinal de menos).

No final aparecem os totais em sat e por moeda local.

Para isso, a carteira não mantém um livro-caixa próprio. Ela calcula o fechamento a cada vez a partir do histórico de pagamentos. Por isso, você pode exportar de novo qualquer mês passado, enquanto os pagamentos estiverem no histórico. A carteira deriva a chave das notas de comprovante das suas 12 palavras; mesmo após uma restauração, as notas continuam legíveis.

A exportação do caixa contém apenas pagamentos feitos pelo caixa. Para uma visão geral de todas as receitas, exporte também o histórico da carteira como CSV; ele contém todos os pagamentos.

7. Reembolso

Na carteira, abra no histórico o pagamento feito pelo caixa e escolha “Reembolsar”.
Informe o endereço Lightning ou a fatura do cliente. Você pode reembolsar no máximo o valor ainda em aberto.
Verifique e confirme. O reembolso aparece no fechamento com sinal de menos. Em endereços Lightning que aceitam nota, a carteira envia junto “Reembolso do comprovante …”.

A associação “reembolso do comprovante” fica armazenada apenas no dispositivo em que você fez o reembolso. Se um reembolso ainda estiver em andamento, a carteira avisa antes de um segundo.

8. Segurança e dados

Dispositivos de funcionários: o caixa não tem acesso ao seu dinheiro e não pode enviar nada. Palavras, PIN e saldo ficam na sua carteira.
O que os outros veem: a nota do comprovante é criptografada. Os itens só seguem dentro dessa nota criptografada; sem chave dos comprovantes, eles ficam no dispositivo do caixa. Mesmo assim, o serviço de pagamento vê o valor, o horário e o seu endereço Lightning. Criptografia não significa anonimato. Os detalhes estão na política de privacidade (em inglês).
Dispositivos de uso comum: os dados do caixa (endereço, nome do caixa, contador de comprovantes, últimas faturas, produtos e moeda escolhida) ficam no navegador do dispositivo do caixa. Em dispositivos de terceiros ou de uso comum, apague-os por meio de “Outro endereço” ou dos dados do navegador.

9. Limites

Não é uma caixa registradora: o caixa não é um sistema eletrônico de registro com dispositivo técnico de segurança certificado (TSE) nos termos da KassenSichV (Alemanha). Se você é obrigado a usar uma caixa registradora depende da sua atividade efetiva. Cabe a você mesmo cumprir as suas obrigações de registro, de comprovação e fiscais – veja os Termos de uso (em inglês).
Valor segundo o caixa: a nota do caixa não está vinculada de forma fixa ao pagamento; quem conhece o link do caixa poderia montar uma nota compatível. A carteira confere valor, cotação e itens com os sat pagos e sinaliza grandes desvios em relação à cotação de hoje. O valor reembolsado é sempre, no máximo, o valor pago em sat.
Visão geral, não contabilidade: o fechamento e o CSV são uma visão geral dos pagamentos para você. Não contêm discriminação de IVA nem relatório de caixa; você pode usá-los como base para a sua contabilidade.
Beta: as funções podem mudar. Guarde as exportações mensais regularmente. Ainda não está verificado de forma conclusiva se, após uma troca de dispositivo, todas as notas de comprovante voltam completas.

Dúvidas? Perguntas frequentes ou kontakt@kai-pay.net.