Defina o limite da carteira
Uma carteira somente observação pode detectar pagamentos sem manter as chaves privadas de gasto. Uma chave pública estendida ainda revela atividade sensível da carteira e deve ser protegida. A integração com Lightning pode exigir uma carteira online e introduz risco operacional adicional.
Dimensionar para a pilha completa
Um backend Bitcoin, base de dados, serviço web e nó Lightning opcional têm necessidades diferentes de armazenamento e memória. Reveja as instruções de implantação atualmente suportadas e os requisitos de crescimento antes de escolher uma máquina pequena.
Proteja a interface do comerciante
Use um nome de anfitrião dedicado, HTTPS, uma proteção de login forte e acesso administrativo restrito. Mantenha o servidor atualizado e verifique as assinaturas de webhook ou os mecanismos de verificação suportados na aplicação recetora. Não envie mercadorias apenas com base num redirecionamento do navegador.
Faça backup e reconcilie
Proteja a configuração da loja, a base de dados, as informações de recuperação da carteira e o material específico da Lightning de acordo com a documentação relevante. Teste a recuperação e reconcilie as faturas com o sistema de pagamento, especialmente em torno de expiração, pagamento insuficiente e reembolsos.
Verifique a implantação e a estratégia da cadeia
Use as instruções de implantação atualmente suportadas, um hostname dedicado e uma rota HTTPS verificada. Uma cadeia podada pode reduzir os requisitos contínuos de armazenamento onde houver suporte, mas as necessidades de rescan e recuperação devem ser compreendidas. Não escolha um disco apenas pelo tamanho atual da cadeia; deixe espaço para toda a pilha e para o crescimento.
- Verifique o callback de pagamento a partir de um teste externo
- Use pagamentos de teste antes de uma loja ao vivo
- Confirme a política de liquidação de faturas
Documentação oficial: Opções de implantação do BTCPay
Mantenha a chave de gasto onde você pretende
Uma configuração somente observação pode detectar pagamentos a partir de uma chave pública estendida sem entregar ao servidor a chave de gasto. A xpub é sensível porque pode revelar a atividade da carteira. Uma carteira quente altera esse risco ao colocar a capacidade de gasto online. Revise separadamente a custódia da carteira e da Lightning e siga o processo de backup suportado.
Documentação oficial: Modelo de carteira BTCPay
Crie uma lista de verificação de implementação em torno da stack escolhida
Comece com um domínio dedicado, um método de implementação suportado, o modo de cadeia pretendido e espaço em disco suficiente para a sincronização. Reveja o gerador Docker upstream e os componentes selecionados antes da instalação; preserve as escolhas de implementação não secretas para que outra máquina possa ser reconstruída de forma consistente. Verifique a resolução do domínio, a emissão do certificado e a titularidade da conta administrativa antes de mostrar um checkout aos clientes. Um exemplo genérico de Docker Compose não é prova de que todos os componentes opcionais do BTCPay estão configurados.
- Decida qual proprietário da instância controla atualizações, monitorização, backups e resposta a incidentes.
- Separe a exposição do reverse-proxy do RPC Bitcoin privado, do banco de dados e da administração do Lightning.
- Documente os limites de recuperação/rescan de um backend podado antes de conectar uma carteira com pagamentos históricos.
- Mantenha um ambiente de teste suportado ou um pequeno exercício de pagamento controlado para integrações antes de cumprir encomendas valiosas.
Documentação oficial: BTCPay Server: opções de implementação · BTCPay Server: implementação Docker suportada
Investigue pagamentos de carteira em falta sem importar uma seed
Uma loja pode usar a informação xpub/derivação de uma carteira enquanto a chave de gasto permanece noutro dispositivo. Teste a receção e o caminho de recuperação com a carteira escolhida. Se o BTCPay detetar o pagamento de uma fatura mas uma carteira externa não o mostrar, inspecione o seu esquema de derivação e o comportamento do limite de lacunas de endereços antes de assumir que os fundos desapareceram. Longas sequências de endereços gerados não pagos podem afetar a descoberta de uma carteira. Utilize os diagnósticos suportados da carteira em vez de copiar palavras de recuperação para o servidor.
Documentação oficial: BTCPay Server: solução de problemas de carteira e derivação
Reconciliar faturas antes do cumprimento
Registe os identificadores de fatura e torne a operação de cumprimento idempotente. O regresso de um navegador à loja é um evento de navegação, não prova de liquidação. Verifique o estado do pagamento através da sua integração de servidor autenticada, trate explicitamente faturas expiradas, atrasadas ou pagas a menos, e mantenha um percurso de revisão para resultados não resolvidos. Se um callback se repetir, devolver uma confirmação bem-sucedida não deve enviar nem creditar o pedido duas vezes.
- Teste um pagamento que chega perto do fim do prazo e verifique se a encomenda permanece associada à fatura correta.
- Mantenha o banco de dados, a configuração da loja e o material de recuperação da carteira em um backup independente testado.
- O Lightning acrescenta uma responsabilidade separada de liquidez e de backup de canais; restaurar todo o VPS de ontem não é um procedimento de recuperação universal seguro.
- Alojar uma instância BTCPay não acrescenta Lightning nem XMR ao checkout de clientes KoalaVPS; os métodos de pagamento neste site de alojamento continuam a ser as suas sete rotas publicadas.
Documentação oficial: Guia para programadores Bitcoin: verificação de pagamento · LND: recuperação de desastres · Core Lightning: backups de carteira e canais