Aceite Bitcoin sem intermediários: BTCPay Server no seu VPS

Um processador de pagamentos faz mais do que cobrar uma taxa. Ele guarda os seus fundos, vê os seus clientes e pode congelar a sua conta. O BTCPay Server é um software gratuito e de código aberto que permite receber Bitcoin diretamente em uma carteira que você controla. Ele roda em um VPS, e este guia mostra a instalação padrão baseada em Docker.

O que você precisa

• Um VPS com 2 vCPU, 4 GB de RAM e 80 GB de disco se você executar um nó Bitcoin podado junto com ele. Menos se você apontá-lo para um nó externo.
• Um nome de domínio, por exemplo pay.example.com, com um registro A apontando para o servidor.
• Ubuntu 22.04 ou 24.04 com o Docker instalado e uma configuração SSH reforçada.

Passo 1: aponte o domínio

Crie primeiro o registro A e espere até que ele resolva. O instalador solicita um certificado Let's Encrypt para o nome e falhará se o registro estiver ausente. Nosso guia de DNS explica como fazer isso.

Passo 2: execute o instalador oficial

sudo su -
git clone https://github.com/btcpayserver/btcpayserver-docker
cd btcpayserver-docker
export BTCPAY_HOST="pay.example.com"
export NBITCOIN_NETWORK="mainnet"
export BTCPAYGEN_CRYPTO1="btc"
export BTCPAYGEN_LIGHTNING="clightning"
export BTCPAYGEN_REVERSEPROXY="nginx"
export BTCPAYGEN_ADDITIONAL_FRAGMENTS="opt-save-storage-s"
export LETSENCRYPT_EMAIL="you@example.com"
. ./btcpay-setup.sh -i

O fragmento opt-save-storage-s poda a blockchain para economizar disco. A sincronização inicial pode levar muitas horas, e a loja funciona para faturas assim que o nó se atualizar. O Lightning é opcional, então deixe essa linha de fora se não o quiser.

Passo 3: crie o administrador e uma loja

Abra o seu domínio, registre a primeira conta (ela se torna o administrador do servidor) e depois desative o registro público em Server Settings. Crie uma loja e defina a moeda padrão dela.

Passo 4: conecte uma carteira que você controla

Gere a carteira em uma carteira de hardware ou no seu próprio dispositivo e cole apenas a chave pública (a xpub) no BTCPay. Não gere uma hot wallet no servidor se puder evitar, pois assim os fundos dependem de o servidor continuar seguro. Os pagamentos vão direto para endereços derivados da sua chave pública.

Passo 5: teste e integre

Crie uma fatura de teste e pague um valor pequeno. Depois instale um plugin para a sua loja (WooCommerce, Shopify, uma chave de API personalizada) seguindo a documentação do BTCPay.

Mantenha tudo seguro

• Ative a autenticação de dois fatores no administrador.
• Faça backup dos dados do BTCPay com o script de backup integrado e guarde-o fora do servidor e criptografado.
• Atualize com btcpay-update.sh, depois de ler as notas de versão.
• Execute o firewall com apenas SSH, 80 e 443 abertos.

Para saber qual moeda é a mais adequada aos seus clientes, leia a cripto mais barata para pagamentos. Vai executar o seu próprio nó de apoio? Veja como executar um nó Bitcoin.