Para instalar o Depix Gateway no WordPress, você precisa de menos de 10 minutos e de uma conta ativa no depix.site. O resultado é direto: seu cliente paga com Pix normalmente, pelo app bancário que já usa, e você recebe o valor em DePix na sua carteira Liquid — sem conta bancária PJ, sem formulário de cadastro longo, sem intermediário custodial.
Quem vende produtos digitais conhece bem o problema oposto: a maioria dos gateways exige dados do cliente muito além do necessário. Para liberar acesso a um curso ou entregar um e-book, bastam e-mail e, no máximo, telefone. Ainda assim, o checkout pede CPF, endereço completo e data de nascimento — informações que você não vai usar e que seu cliente preferiria não fornecer. O Depix Gateway resolve isso sem abrir mão do Pix, que é, afinal, o método de pagamento mais usado no Brasil.
Portanto, se você já tem WordPress e WooCommerce instalados, este guia mostra o caminho completo: instalação, configuração e primeiro teste.
Pré-requisitos para instalar o Depix Gateway no WordPress
Antes de começar, confirme que seu ambiente atende aos requisitos mínimos. A instalação é simples, mas a stack precisa estar correta para que o plugin funcione sem problemas.
Requisitos do servidor:
- WordPress 6.0 ou superior
- WooCommerce 7.0 ou superior
- PHP 8.1+ (recomendado: PHP 8.3+)
- MySQL 8.0 ou superior
O que você também vai precisar:
- Uma conta ativa em depix.site — as chaves de API são geradas lá e são o que destrava o plugin
- Uma carteira Liquid configurada para receber os pagamentos (Satsails ou SideSwap funcionam bem para começar)
Além disso, vale entender desde o início o contexto do ativo que você vai receber: o DePix é um ativo digital emitido pela Eulen na Liquid Network. Ele não é regulado pelo Banco Central do Brasil e não tem as garantias do sistema financeiro tradicional. Portanto, o uso deve estar em conformidade com as obrigações legais vigentes.
Como instalar o Depix Gateway no WordPress: passo a passo
O plugin está disponível diretamente no repositório oficial do WordPress.org. Assim sendo, a instalação é segura e pode ser feita sem sair do painel.
Via painel do WordPress (método recomendado):
- No menu lateral, acesse Plugins → Adicionar novo plugin
- No campo de busca, digite
depix-gateway - Localize o plugin “Depix – PIX Payment Gateway for WooCommerce”
- Clique em Instalar agora e aguarde o download concluir
- Em seguida, clique em Ativar
O plugin aparece imediatamente na lista de plugins ativos após a ativação. A partir daí, ele já fica disponível como método de pagamento no WooCommerce.
Via upload manual (método alternativo):
Caso esteja em um ambiente restrito ou prefira controlar a versão instalada, acesse Plugins → Adicionar novo plugin → Fazer upload de plugin, selecione o arquivo .zip e prossiga com a instalação normalmente. O resultado é idêntico ao método anterior.
Configurando o plugin Depix Gateway no WooCommerce
Com o plugin instalado, o próximo passo é a configuração. Com as chaves de API em mãos, o sistema fica pronto para receber pagamentos em minutos — na prática, essa etapa leva menos de 5 minutos do total. Solicite as suas chaves aqui.
Acesse as configurações:
- Vá em WooCommerce → Configurações
- Clique na aba Pagamentos
- Localize o Depix Gateway na lista e clique em Gerenciar
Campos que você vai preencher:
Ativar/Desativar: Marque esta opção para que o método de pagamento apareça no checkout da sua loja. Sem isso, o plugin fica instalado, mas invisível para o cliente.
Store ID, JWT Kid, JWT Secret Key, Webhook Secret: Cole aqui as chaves geradas no painel de depix.site. Isso é o vínculo entre o seu WooCommerce e a infraestrutura do Depix — sem essas configurações, nenhuma transação funciona.
Order Status: define o comportamento do pedido após a confirmação do pagamento. Para produtos digitais, em que o cliente deve receber o link para download, o ideal é “concluído”. Já produtos físicos, o recomendado é “processando”.
Pedidos Cancelados: por regra de negócio, o QRCode Pix tem validade limitada, após a expiração, o pedido é cancelado automaticamente, liberando o estoque daquele item, se for o comportamento configurado no Woocommerce.
Por que o plugin usa verificação dupla de pagamento
O Depix Gateway confirma cada pagamento por dois caminhos independentes: o webhook (notificação ativa enviada pela infraestrutura) e o polling (verificação periódica iniciada pelo próprio plugin). Dessa forma, mesmo em casos de instabilidade momentânea de rede, os pedidos não ficam presos em status pendente por falha de notificação. É um detalhe de arquitetura que, na prática, reduz significativamente a necessidade de suporte manual.
Testando o Depix Gateway no WordPress do início ao fim
Antes de começar a receber pagamentos reais, é importante fazer um teste completo do fluxo para garantir que tudo está conectado corretamente.
- Acesse sua loja como cliente e adicione um produto ao carrinho
- Vá até o checkout e selecione Pix (Depix Gateway) como forma de pagamento
- Conclua o pedido — um QR Code Pix será gerado na tela
- Escaneie o QR Code com qualquer aplicativo bancário e realize o pagamento
- Aguarde alguns instantes e verifique o status do pedido no painel do WooCommerce — ele deve mudar automaticamente para Processando ou Concluído
- Por fim, verifique sua carteira Liquid — o DePix referente ao pagamento deve aparecer em breve
Este é um pedido de teste real: a transação acontece de verdade, com valor real. Por isso, planeje isso com um produto de valor baixo ou use o valor mínimo viável para o teste.
Erros comuns ao instalar o Depix Gateway no WordPress
Mesmo com uma configuração simples, alguns problemas aparecem com frequência. No entanto, os três abaixo respondem pela maioria dos chamados de suporte e têm solução rápida.
Webhook não dispara e o pedido fica em “Pendente”
A causa mais comum é a URL do webhook copiada incorretamente no Onboarding do depix.site. Por isso, verifique se não há espaços extras, caracteres cortados ou barra final faltando. Acione o Suporte para solicitar a correção.
QR Code não é gerado no checkout do WooCommerce
Nesse caso, verifique a API Key. Uma chave inválida, expirada ou com erro de digitação impede a comunicação com a infraestrutura do Depix. Assim sendo, solicite ao time de suporte que regenere a chave se necessário e cole novamente nas configurações do plugin.
Plugin não aparece na busca do WordPress
Isso acontece ocasionalmente quando o repositório do WordPress.org está com indexação desatualizada. Nesse caso, baixe o arquivo .zip diretamente e instale via upload manual — o resultado é idêntico e o problema não volta após a ativação. Solicite o .zip clique aqui.
O que fazer depois de instalar o Depix Gateway no WordPress
Instalar o plugin é o ponto de entrada para algo mais amplo. Por estar dentro do ecossistema WordPress + WooCommerce, as possibilidades vão muito além de um checkout simples.
A mesma infraestrutura suporta sistemas de agendamento, lojas com múltiplos vendedores, plataformas de cursos e memberships (LMS), venda e distribuição de conteúdo digital — qualquer fluxo que o WooCommerce suporte, com Pix como método de entrada e DePix como destino na sua carteira. Além disso, todos esses modelos se beneficiam do mesmo fluxo: o cliente paga com o que já tem, e você recebe sem depender de conta bancária PJ.
O Pix não é um inimigo do Bitcoiner. É, ao contrário, uma ferramenta que já está na mão de todos os seus clientes. Usá-la a seu favor, recebendo em DePix sem burocracia bancária, é uma decisão prática — não uma concessão.
Pronto para instalar? Acesse depix.site para criar sua conta e obter as chaves de API. Em seguida, instale o plugin buscando por depix-gateway no repositório do WordPress.org.
Tem dúvidas técnicas? Fale conosco para tirar dúvidas sobre o plugin. Por fim, sobre o ecossistema DePix, fale com a comunidade Bitcoin BR no Telegram — grupos como Bitcoin Block, Liquid Network Brasil e DePix Brasil têm usuários com experiência.
FAQ
Não. O cliente paga com Pix normalmente, pelo aplicativo bancário que já usa. Portanto, não há nenhuma barreira de entrada do lado do comprador.
O plugin em si não exige CNPJ. No entanto, suas obrigações fiscais e legais dependem da sua situação específica — consulte um contador ou advogado para entender o que se aplica ao seu caso.
Sim, desde que você já tenha as chaves de API do depix.site. Na prática, a maior parte do tempo vai para copiar e colar a URL do webhook corretamente.
Não existe sandbox. Por isso, o teste é feito com uma transação real de valor baixo, conforme descrito na seção de testes acima.
Fale conosco para tirar dúvidas sobre o plugin. Sobre o ecossistema DePix, fale com a comunidade Bitcoin BR no Telegram — grupos como Bitcoin Block, Liquid Network Brasil e DePix Brasil têm usuários com experiência.
