Bitcoin Payment Processor

Imagine alguém comprando um livro pela internet. A loja pede ao processador uma invoice, uma solicitação com valor e moeda, e salva seu identificador junto ao número do pedido. O cliente abre a página de pagamento ou lê um código QR e paga. A associação registrada permite identificar a compra correspondente ao dinheiro. Sem ela, perceber que bitcoin chegou a algum lugar não basta. Voltar à página “Obrigado pela compra” também não prova que a loja recebeu o pagamento. [1]

BTCPay Server pode gerar endereços de recebimento a partir dos dados públicos de uma carteira existente, sem obter as chaves privadas que permitem gastar. Isso difere de uma carteira quente com chaves no servidor ou do acesso aos fundos de um nó Lightning que opera pagamentos rápidos. Em um serviço, o provedor pode controlar o dinheiro antes do repasse. Portanto, o rótulo non-custodial, que indica não confiar as chaves ao provedor, não basta sozinho. Confira permissões reais, quem pode enviar os fundos e se recuperá-los exige autorização de outra pessoa. [2] [6]

O livro pode ter preço em moeda convencional enquanto o cliente envia bitcoin. BTCPay Server fixa valor e taxa de câmbio na solicitação por tempo limitado. O vencimento não impede a chegada de uma transferência posterior; a loja precisa tratá-la corretamente. O mesmo vale para pagamentos a menos ou a mais. Valor e câmbio originais ficam registrados para conciliação. Uma nova solicitação com outra taxa pode exigir uma quantidade diferente de satoshis, as menores unidades do bitcoin, mesmo sem mudança no preço do livro. [3]

No BTCPay Server, Processing significa que o valor solicitado foi pago, mas ainda faltam condições de conclusão, como confirmações da transação em blocos. Settled indica que elas foram cumpridas; pagamentos Lightning normalmente não esperam confirmação em bloco. Outros serviços definem seus próprios estados. BitPay alerta expressamente que paid não garante pagamento. A regra de envio deve seguir a documentação do serviço escolhido e o método de pagamento. Marcar manualmente o pedido como pago não substitui verificar o recebimento real. [3] [5]

O processador informa mudanças por webhook, uma mensagem automática entre servidores. A loja verifica origem e conteúdo. No BTCPay, HMAC-SHA256 é calculado sobre os bytes originais da mensagem com um segredo compartilhado: trata-se de um código de autenticação, não de uma confirmação da rede Bitcoin. BitPay não assina sua notificação IPN; ela deve apenas provocar uma consulta ao estado real pela API, interface usada por programas para se comunicar. Mensagens podem chegar novamente. A loja registra o atendimento do pedido para evitar outro envio e, após uma interrupção, concilia seus estados com o processador. [4] [5]

Receber o pagamento do cliente e receber o repasse do serviço são eventos diferentes. BitPay permite configurar uma moeda de liquidação aceita e uma conta bancária ou endereço de criptomoeda; alterações podem precisar de aprovação. O comerciante também verifica prazos, limites, tarifas e quem controla o dinheiro antes do repasse. Receber diretamente na própria carteira pode dispensar essa etapa intermediária. O sistema de vendas deve distinguir os modelos para que “pago” não crie uma impressão falsa sobre o dinheiro disponível. [6] [2]

Um reembolso não apaga a transação Bitcoin original. A loja atende à solicitação, decide valor e moeda, verifica o destinatário e providencia um novo pagamento. Um link para solicitar reembolso ainda não significa que o dinheiro saiu. Pedido, solicitação de pagamento, recebimento, câmbio, tarifas e devolução permanecem registrados. Relatórios exportados ajudam a contabilidade, mas não cumprem sozinhos todas as obrigações locais. A confirmação na rede também não resolve uma disputa de entrega nem elimina deveres contratuais ou legais diante de uma reclamação. [7] [8] [10]

Uma compra de teste bem-sucedida não basta antes do lançamento. Teste valores insuficientes, pagamentos atrasados, notificações repetidas e recuperação após interrupção. Uma chave API é a credencial de acesso de um programa: recebe apenas as permissões necessárias para aquela loja. Os dados anexados não devem incluir informações pessoais desnecessárias. A operação própria envolve hospedagem, atualizações e suporte; Lightning também exige gerir liquidez, ou seja, fundos e espaço nos canais para pagamentos. Software gratuito não torna a operação gratuita. Disponibilidade, proteção das chaves e integração correta precisam de verificações separadas. [1] [9]