Este guia explica como configurar pagamentos em Bitcoin em seu site usando a Electrum. Usaremos solicitações de pagamento assinadas por SSL, seguindo o padrão BIP-70 padrão. Esta documentação é atual para o Electrum 4.0 e posterior.
Antes de começar, verifique se você tem:
- Um certificado SSL válido (assinado pela CA, como o certificado gratuito LetsEncrypt).
- A versão de desenvolvimento da Electrum instalada.
Lembre-se de executar o comando de atualização do submódulo durante a instalação.
Configure seu certificado SSL na Electrum
Para habilitar conexões seguras, você precisa adicionar seu certificado SSL à Electrum. Use estes comandos em seu terminal:
electrum -o setconfig ssl_keyfile /path/to/ssl/privkey.pem
electrum -o setconfig ssl_certfile /path/to/ssl/fullchain.pem
Para obter instruções mais detalhadas sobre como adicionar SSL à Electrum, consulte a seção Configuração de SSL para a Electrum.
Criação e uso de sua Merchant Wallet
Configure uma carteira segura para suas transações comerciais. Esse processo ajuda a proteger sua criptomoeda, mesmo que o servidor do comerciante seja comprometido.
- Criar uma nova carteira
Em um computador seguro, crie uma nova carteira:
electrum create
É melhor usar uma carteira separada para sua empresa, não para sua carteira pessoal.
- Exportar a chave pública mestre
Ainda em seu computador seguro, exporte a chave pública mestre (xpub):
electrum getmpk -w .electrum/wallets/your-wallet
- Configurar o servidor do comerciante
Em sua máquina de servidor, restaure a carteira usando a chave pública mestre exportada:
electrum restore xpub...............................................
Substituir xpub... com sua chave pública mestre real
- Configurar as definições do servidor.
electrum -o setconfig payserver_address yourdomain.com:80
Substituir yourdomain.com com seu domínio real.
Iniciando o Daemon da Electrum
Depois de configurar sua carteira somente leitura, você precisa executar a Electrum como um serviço em segundo plano. Veja como:
- Iniciar o Daemon
Execute este comando para iniciar o Electrum como um daemon:
electrum daemon -d
Isso inicia a Electrum no modo daemon, permitindo que ela seja executada em segundo plano.
- Carregue sua carteira
Em seguida, carregue sua carteira no daemon em execução:
electrum load_wallet
Esse comando torna sua carteira ativa e pronta para uso.
Como interromper o Daemon
Se você precisar interromper o daemon Electrum em qualquer momento, use este comando:
electrum stop
Isso encerrará com segurança o daemon da Electrum.
Criar uma solicitação de pagamento assinada
electrum add_request 0.5 -m "test"
{
"URI": "bitcoin:bc1q3hr4xnta7s4jgeymjhs498ygqa53qkjxqhlx3z?amount=0.5&message=test&time=1589115653&exp=3600",
"address": "bc1q3hr4xnta7s4jgeymjhs498ygqa53qkjxqhlx3z",
"amount": 50000000,
"amount_BTC": "0.5",
"bip70_url": "https://yourdomain.com:80/bip70/bc1qyr5xx5jkue3k72sldm5xa0taqs3n2achupymz8.bip70",
"exp": 3600,
"id": "63822b69013",
"memo": "test",
"status": 0,
"status_str": "Expires in about 1 hour",
"time": 1589115653,
"type": 0,
"view_url": "https://yourdomain.com:80/r/pay?id=bc1q3hr4xnta7s4jgeymjhs498ygqa53qkjxqhlx3z"
}
Veja a seguir um detalhamento das principais informações:
URI: Um URI de Bitcoin que inclui o valor, a mensagem, o registro de data e hora e a expiração.address: O endereço de Bitcoin para o pagamento.amount: O valor solicitado em satoshis.amount_BTC: O valor solicitado em BTC.bip70_url: O URL da solicitação BIP70 assinada.view_url: O URL de uma página da Web que exibe a solicitação.
A saída do comando inclui dois URLs importantes:
bip70_url: Este é o URL da solicitação BIP70 assinada.view_url: Esse é o URL de uma página da Web que exibe os detalhes da solicitação.
Para visualizar sua lista atual de solicitações, use a opção list_requests comando.
Para remover todas as solicitações da lista, use a opção clear_requests comando.
Abra a página de solicitação de pagamento em seu navegador
Depois de criar uma solicitação de pagamento, você pode visualizá-la em um navegador da Web.
Veja como usar a página de solicitação de pagamento:
- Abra o
view_urldo resultado da solicitação de pagamento em seu navegador da Web. - A página exibirá os detalhes da solicitação de pagamento, incluindo:
- Um URI de Bitcoin que pode ser aberto com uma carteira.
- Um código QR que pode ser escaneado para pagamento.
- O tempo restante até a expiração da solicitação.
- Para fazer um pagamento:
- Use uma carteira de Bitcoin para abrir o URI de Bitcoin fornecido.
- Digitalize o código QR com uma carteira móvel.
- A página usa websockets para atualizar em tempo real. Quando o pagamento for recebido, a página será atualizada automaticamente para mostrar o status atualizado.
A aparência real da página pode variar, mas ela conterá as informações essenciais necessárias para concluir o pagamento.
Importante: Sempre verifique os detalhes do pagamento antes de enviar quaisquer fundos.
Pagamentos relâmpago
Configuração do Lightning
Para usar o Lightning, você precisa configurar as chaves do Lightning em sua carteira. Siga estas etapas:
- Interrompa o daemon da Electrum:
electrum stop - Inicializar as chaves do Lightning:
electrum -o init_lightning - Reinicie o daemon:
electrum daemon -d
Você pode adicionar chaves Lightning a uma carteira somente de observação. Essa carteira não poderá gastar moedas na cadeia, mas poderá realizar transações Lightning.
Abertura de um canal
Depois de configurar o Lightning, você precisa abrir um canal:
electrum open_channel <node_id> <amount>
Para verificar se o canal está pronto para uso:
electrum list_channels
Observe que seu novo canal não terá capacidade de entrada no início, portanto, você não poderá receber pagamentos imediatamente. Se precisar receber imediatamente, considere fazer uma troca submarina dos fundos do seu canal.
Criação de uma solicitação de pagamento do Lightning
Para criar uma solicitação de pagamento do Lightning:
electrum add_lightning_request 0.0001 -m "test"
Esse comando cria uma solicitação de 0,0001 BTC com a mensagem "test".