O Blink para WooCommerce agora oferece suporte a contas sem custódia

11 de setembro de 2026

Kemal Yaşar

O WooCommerce hospeda mais de quatro milhões de lojas online ativas, mais do que qualquer outra plataforma. Nosso plugin Blink for WooCommerce vem oferecendo a essas lojas uma maneira de aceitar Bitcoin no momento do pagamento desde 2024: a rede Lightning como opção de pagamento ao lado da transferência bancária, do PayPal, do Stripe ou de qualquer outra opção disponível, sem a necessidade de manter um servidor ou um nó. O cliente escolhe o Lightning, uma fatura é gerada para o carrinho, ele efetua o pagamento e, quando o pagamento é confirmado, o WooCommerce coloca o pedido no status “pago” e o marca como pronto para processamento. Essa é a ideia por trás disso tudo.

A novidade é que agora isso funciona com uma conta Blink sem custódia. Você seleciona a opção “sem custódia” no menu suspenso, insere seu endereço Blink Lightning e os sats de cada venda vão direto para a sua própria carteira. Nós nunca tocamos neles.

Gostaria de explicar por que criamos o plug-in, quais são, na verdade, as diferenças entre os dois tipos de conta, por que ele só funciona com um endereço Blink, o que ainda não funciona e, em seguida, orientar vocês passo a passo pela configuração de ambas as opções.

Por que criamos o plug-in

Pelo mesmo motivo pelo qual criamos o botão de doação: levar o Lightning até onde as pessoas já estão. O comércio eletrônico é dominado por um punhado de plataformas. A maioria das lojas usa o WooCommerce, e o restante usa o Shopify, o PrestaShop, o Joomla ou plataformas semelhantes. O WooCommerce é de código aberto, nós também somos de código aberto, e não havia uma boa opção de Bitcoin Lightning para o processo de checkout.

Se você já utiliza um servidor BTCPay, está tudo resolvido: ele conta com um excelente plugin para o WooCommerce, e nós também temos um plugin do Blink para o BTCPay. Mas usar o BTCPay significa ter um servidor ou conhecer alguém que tenha um, e a maioria dos donos de lojas não tem. Este plugin é para eles: uma maneira de receber pagamentos da sua loja diretamente na sua conta do Blink, sem precisar hospedar nada.

Na verdade, oferecemos uma recompensa por isso em dezembro de 2023. Algumas pessoas tentaram, mas ninguém conseguiu concluir; então, no fim, Juan Pablo (dolcalmi), da nossa equipe, desenvolveu o projeto e o publicou no WordPress.org.

E é no comércio digital que o Bitcoin faz mais sentido. Para transações presenciais, existem muitas soluções, principalmente o dinheiro vivo. Mas, no comércio digital, as opções se resumem basicamente a cartões de crédito e PayPal, que exigem uma conta bancária e, de qualquer forma, trazem uma série de problemas. O Bitcoin é dinheiro digital. Fazer com que ele funcione no comércio eletrônico tem sido uma ambição de longa data dos adeptos do Bitcoin, e um plugin de checkout para a plataforma de lojas mais utilizada é um passo prático nessa direção.

Novidades: contas sem custódia

Até agora, era necessário ter uma chave de API da sua conta Blink, e as contas sem custódia não possuem chaves de API. Isso não é um descuido. Uma chave de API é um recurso de custódia: ela permite que um software realize operações com os fundos que mantemos para você. Com uma conta sem custódia, não mantemos nada, portanto não há nada sobre o qual a chave possa atuar. Se você tivesse migrado sua conta, não poderia mais usar o plugin.

Agora você pode. O plugin gera faturas por meio do seu endereço do Blink Lightning, em vez de uma chave, exibe o código QR na sua própria loja e confirma o pagamento por conta própria. Seu cliente paga, os sats chegam à sua conta e ninguém fica no meio.

Com custódia x sem custódia

Ambas as opções levam o Lightning até o seu caixa. A diferença está em quem fica com o dinheiro e como a loja sabe que recebeu o pagamento.

Com uma conta de custódia, o plugin cria notas fiscais por meio da API do Blink, redireciona seu cliente para o site pay.blink.sv para concluir o pagamento e o painel do Blink notifica sua loja por meio de um webhook quando o pagamento for liquidado. O Blink retém os fundos em sua conta, e você escolhe em qual carteira eles serão depositados: seu saldo em Bitcoin ou seu saldo em dólares.

Com uma conta sem custódia, não há nenhuma chave de API. O plugin funciona por meio do seu endereço Blink Lightning, exibe o código QR no seu próprio site e confirma o pagamento automaticamente. Você mantém as chaves, e os pagamentos chegam em sats.

Por que o plugin só funciona com um endereço do Blink?

As pessoas me perguntam se podem inserir um endereço da Wallet of Satoshi ou de alguma outra carteira. A resposta é não, e o motivo é técnico.

Gerar uma fatura a partir de um endereço Lightning público é fácil; qualquer pessoa pode fazer isso. O problema vem depois. Quando o cliente paga uma fatura gerada em nome do comerciante, a loja precisa verificar se o pagamento realmente foi bem-sucedido e, para isso, o servidor LNURL da carteira precisa implementar a verificação LNURL (LUD-21). O Blink implementa isso. Não temos controle sobre outras carteiras e não podemos garantir seu funcionamento, e a Wallet of Satoshi não é de código aberto, portanto, nem mesmo podemos verificar. Portanto, o plug-in é compatível apenas com o Blink.

Vale a pena saber como funciona essa verificação. A loja consulta o Blink em segundo plano, repetidamente, para saber se a fatura foi paga, enquanto ela estiver válida. Se não conseguir acessar o servidor naquele momento, ela deixa o pedido pendente em vez de cancelá-lo, pois, do ponto de vista da loja, um servidor inacessível e uma fatura não paga são a mesma coisa, e apenas uma dessas situações é motivo para recusar um cliente.

Dito isso, se houver algum desenvolvedor de código aberto por aí que queira um projeto: um plugin geral do Lightning para o WooCommerce, que funcione com qualquer carteira que implemente a verificação LNURL — e não apenas com o Blink —, seria uma contribuição real para o ecossistema. Nosso código está aberto. Vá em frente.

Uma coisa que ainda não funciona: o saldo em dólares

Com uma conta custodial, você pode determinar para onde os fundos recebidos vão — Saldo em Bitcoin ou Saldo em Dólar —, por meio do ID da carteira. Com uma conta não custodial, você também tem um Saldo em Dólar, mas o plugin ainda não consegue direcionar os pagamentos diretamente para lá. É necessária uma conversão, e como não somos o provedor desse serviço, a implementação é mais complexa. Talvez mais tarde. Por enquanto, “não custodial” significa que você recebe sats.

Se você quiser dólares mesmo assim, existe uma maneira manual. No aplicativo, acesse seu Saldo em Dólares, gere uma fatura Lightning e pague-a usando seu Saldo em Bitcoin. Isso transfere o valor. Se você estiver realizando muitas vendas, pode automatizar esse processo com o SDK do Breez; e se alguém desenvolver isso e disponibilizar como código aberto, eu adoraria ver.

Essa é a história. A descrição está abaixo e, em seguida, as perguntas que mais nos fazem.

Configuração

Conta sem custódia

Essa rota ignora completamente a chave da API.

1. Instale o plugin. No painel de administração do WordPress, acesse Plugins → Adicionar novo, procure por “Blink for WooCommerce”, instale e ative.

2. Abra as configurações do plugin no WooCommerce.

3. Selecione “sem custódia” no menu suspenso de tipo de conta e insira seu endereço Blink Lightning (por exemplo, you@blink.sv). Não é necessária nenhuma chave.

4. Salve e, em seguida, ative a opção “Pagar com Bitcoin Lightning” em WooCommerce → Configurações → Pagamentos.

Conta de custódia

Você precisará de uma conta no Blink e de alguns minutos no painel do Blink para criar uma chave de API.

1. Instale o plugin. No painel de administração do WordPress, acesse Plugins → Adicionar novo e procure por “Blink for WooCommerce”. Verifique se é o plugin publicado pela Blink, instale-o e ative-o.

2. Abra o painel do Blink. Nas configurações do plug-in, acesse o painel do Blink e faça login com sua conta do Blink usando seu e-mail ou número de telefone, além do código de autenticação de dois fatores. Mantenha o painel à mão; você voltará a ele.

3. Crie uma chave de API apenas para recebimento. Na seção “Chaves de API” do painel, crie uma nova chave. Dê a ela um nome como “WooCommerce” e defina seu escopo para apenas leitura e recebimento, sem gravação, para que ela possa aceitar fundos, mas nunca enviá-los. Copie a chave imediatamente: o Blink a exibe apenas uma vez e você não a verá novamente; portanto, guarde-a em um local seguro.

4. Cole a chave no plugin. De volta às configurações do plugin do WooCommerce, cole sua chave de API.

5. Escolha sua carteira. Escolha a carteira de Bitcoin se quiser que os fundos recebidos acompanhem a variação do preço do Bitcoin, ou a carteira de Stablesats se quiser que eles mantenham seu valor em dólares. Salve.

6. Ative a forma de pagamento. Acesse WooCommerce → Configurações → Pagamentos e ative a opção “Pagar com Bitcoin Lightning”. Salve, e a opção Lightning aparecerá na sua página de finalização da compra.

Seja por qual caminho for, o cliente escolhe Bitcoin na finalização da compra, escaneia o código QR com qualquer carteira Lightning, e o pedido é marcado como pago assim que o pagamento for creditado. Eu faria primeiro um pequeno pedido de teste, só para ver se os sats chegam onde você espera. Se você preferir ver como se faz, uma loja em Curaçao gravou um passo a passo completo: o tutorial do Bitcoin Curaçao.

Requisitos

Seu servidor precisa ter o WordPress 6.5 ou superior, o WooCommerce 9.0 ou superior e o PHP 8.1 ou superior, com a extensão cURL do PHP ativada. Para solucionar problemas e obter o passo a passo completo sobre a configuração sem custódia, consulte o guia de configuração para comerciantes no repositório de plug-ins.

‍

Perguntas frequentes

Preciso de uma chave de API para uma conta sem custódia? Não. As chaves de API são um recurso de custódia no Blink. As contas sem custódia se conectam apenas com o seu endereço Lightning do Blink.

Posso usar um endereço Lightning que não seja do Blink, como o da Wallet of Satoshi? Não, o plug-in funciona apenas com o Blink. O motivo é a exigência de verificação do LNURL mencionada acima: nem todas as carteiras implementam isso, portanto, a confirmação do pagamento não pode ser garantida com outros provedores.

Preciso executar um servidor ou um nó Lightning? Não. O Blink cuida da parte do Lightning; basta conectar sua conta ou endereço.

Meus clientes precisam do Blink? Não. Qualquer carteira Lightning pode pagar a fatura no momento do pagamento.

Em qual saldo os pagamentos são creditados? Em uma conta custodial, você escolhe entre o saldo em Bitcoin ou o saldo em dólares (mantido em dólares por meio de Stablesats). Em uma conta não custodial, os pagamentos chegam em Bitcoin.

Posso receber pagamentos no meu Saldo em Dólares por meio de uma conexão sem custódia? Ainda não. Por enquanto, os pagamentos sem custódia são recebidos em Bitcoin (veja acima como fazer manualmente). Essa funcionalidade poderá ser oferecida no futuro.

O plugin é de código aberto? Sim. O código está no repositório do plugin.

Comece agora: blink.sv/en/woocommerce

‍