Para aceitar pagamentos em cripto no WooCommerce, instale o módulo gratuito Payora, cole sua chave API e segredo nas configurações do plugin e registre uma URL de callback — https://yoursite.com/?wc-api=payora — no seu painel do Payora. Essa é toda a configuração. Depois disso, um cliente escolhe "Pagar com cripto" na finalização da compra, escolhe uma moeda em uma página de pagamento hospedada, envia e o pedido do WooCommerce muda de pending para pago automaticamente quando o webhook assinado chega ao seu servidor. Sem processador de cartão, sem conta de comerciante, sem corte retirado da venda.
O que acontece quando você aceita pagamentos em cripto no WooCommerce
O WooCommerce trata o Payora como qualquer outro gateway de pagamento: ele aparece em WooCommerce → Configurações → Pagamentos como um método que você pode renomear para o que seus compradores entenderem. Quando alguém o seleciona e clica em Fazer pedido, três coisas acontecem:
- O WooCommerce cria o pedido em
pending. Nada é pago, nada é enviado. - O módulo chama o servidor da API Payora de servidor para servidor com o id do pedido e o total do carrinho na moeda da sua loja, e recebe de volta uma URL de checkout hospedada.
- O comprador é redirecionado para lá, escolhe uma moeda e vê um valor fixo, um endereço, um código QR e uma contagem regressiva de bloqueio de taxa.
O comprador nunca digita um número de cartão, e sua instalação do WordPress nunca toca em uma chave privada. Cotações, derivação de endereço e rastreamento de confirmação acontecem fora da sua caixa. Experimente o demonstração ao vivo primeiro.
Instalando o gateway de pagamento em criptomoeda WooCommerce
O módulo é um dos 22 integrações CMS gratuitas disponíveis na página de módulos. Um ZIP de plugin comum, sem Composer.
- Crie uma conta gratuita e gere um
api_key/api_secretpar no painel. Registro é gratuito. - Baixe o ZIP do WooCommerce de /módulos, faça o upload em Plugins → Adicionar Novo → Fazer Upload do Plugin, ative.
- Abra WooCommerce → Configurações → Pagamentos → Payora. Cole a chave e o segredo, escolha quais moedas mostrar, salve.
- De volta ao painel do Payora, defina a URL de callback desta loja para
https://yoursite.com/?wc-api=payora. - Faça um pequeno pedido de teste real e pague com algo barato, como USDT na Tron. Observe o status mudar por conta própria.
A URL de callback é o passo que as pessoas pulam
Perder o passo 4 e tudo parece perfeito até que não é. O comprador paga, as moedas chegam na sua carteira — e o pedido fica em pending para sempre, porque nada informou ao WooCommerce que o dinheiro chegou. É o erro de configuração mais comum e falha silenciosamente: sem erro, apenas pedidos que nunca progridem. Defina o callback antes da sua primeira venda real, no seu domínio ao vivo sobre HTTPS, exatamente como o WordPress serve.
Por que o webhook marca o pedido como pago, não o comprador voltando
O redirecionamento de volta para sua página de agradecimento é cosmético — uma confirmação para o comprador, nada mais. Os compradores fecham abas. O telefone deles toca no meio do pagamento. Eles pagam de uma carteira de hardware em uma máquina diferente daquela com o carrinho aberto, ou transmitem a transação e se afastam enquanto a rede leva quatro minutos para confirmar. Se sua loja tratasse a viagem de retorno como prova de pagamento, uma parte dos pedidos pagos nunca seria marcada como pago, e você estaria encontrando-os manualmente na caixa de entrada de suporte.
Assim, o módulo ignora o retorno como uma fonte de verdade completamente. A Payora observa a cadeia, espera pela regra de finalização daquela moeda, então POSTa um corpo JSON para sua URL de callback assinado com HMAC-SHA256 sobre a carga bruta, carregando uma janela de timestamp e uma chave de idempotência. Ele recomputa a assinatura com seu api_secret, compara em tempo constante, rejeita qualquer coisa fora da janela, descarta chaves duplicadas, verifica o valor, então chama o payment_complete() do WooCommerce — que avança o pedido, decrementa o estoque e envia o e-mail ao cliente. A verificação da assinatura é coberta em a documentação do webhook HMAC; o módulo faz cada passo por você.
A consequência prática é o ponto principal: um cliente que paga e fecha a aba ainda recebe seu pedido.
Escolhendo quais moedas oferecer
Você decide quais dos 20+ ativos em 9 redes aparecem na página hospedada. Mais opções não é automaticamente melhor; uma parede de logotipos faz um comprador de primeira viagem hesitar. Um padrão sensato:
| Ativo / rede | Custo para o comprador | Por que incluí-lo |
|---|---|---|
| USDT na Tron (TRC-20) | Centavos | O cavalo de batalha: estável, barato, amplamente detido. |
| USDT na TON (Gram) | Centavos | Quase instantâneo; o padrão dentro das carteiras do Telegram. |
| USDC na Base ou Polygon | Centavos | Rota barata para fundos já no EVM. |
| USDT na Ethereum (ERC-20) | Dólares no pico | Pedidos maiores, onde o gás é ruído. |
| BTC | Varia com o mempool | Detentores de Bitcoin que insistem em pagar em BTC. |
USDT-TRC20 e TON merecem destaque. Uma transferência de USDT na Tron geralmente custa centavos para o comprador; o mesmo USDT na Ethereum em uma hora movimentada pode custar vários dólares. Em um pedido de €40, essa diferença decide se o carrinho converte, e o comprador paga a taxa da rede de qualquer forma, então eles sentem isso. Se seu pedido médio é pequeno, coloque uma stablecoin em uma rede barata no topo — comparação mais profunda em o guia de redes USDT.
Mantenha o Bitcoin habilitado de qualquer maneira. É mais lento e sua taxa flutua, mas os clientes que desejam pagar em BTC são firmes sobre isso. Quanto tempo você os faz esperar é uma questão de confirmações — veja quantas confirmações são seguras.
Status dos pedidos, HPOS e reembolsos
O fluxo de status permanece chato, que é o que você deseja:
pending— fatura criada; nada enviado ainda, ou não confirmado ainda.on-hold— opcional: visto na blockchain, aguardando confirmações.processingoucompleted— webhook verificado, pedido pago. Produtos virtuais e baixáveis vão direto para concluído.cancelled— a fatura expirou sem pagamento; estoque é liberado.
O módulo é compatível com HPOS (Armazenamento de Pedidos de Alto Desempenho, as tabelas de pedidos personalizadas que são o padrão para novas instalações desde o WooCommerce 8.2) e com armazenamento legado baseado em postagens: declara compatibilidade e usa a API CRUD em vez de ler wp_postmeta diretamente, então se comporta da mesma forma de qualquer maneira. Checkouts baseados em blocos e clássicos com shortcode são ambos suportados.
Reembolsos são a troca honesta de escolher aceitar pagamentos em cripto no WooCommerce. Cripto não tem estorno, que é o motivo pelo qual a fraude de pagamento deixa de ser seu problema — mas nenhum botão retira dinheiro da carteira do cliente também. Um reembolso é um pagamento que você envia para um endereço que o cliente lhe fornece, do seu saldo, assinado offline. Uma mudança de fluxo de trabalho, não um bloqueador, mas decida sua política antes de ativar o gateway.
Taxas: 0% para aceitar
Payora leva 0% para aceitar um pagamento. Essa é a principal razão para usá-lo em vez de um plugin de bitcoin para WordPress que silenciosamente redireciona através de um processador que cobra 0,5–1% de cada venda. Com €10.000 por mês, essa diferença é de €50–100, todo mês, pelo trabalho que seu servidor já faz.
As taxas se aplicam apenas quando você move dinheiro fora: 1,5% em pagamentos, transferências e retiradas para uma carteira externa no plano Gratuito, além da taxa de rede da moeda em um pagamento ou retirada (retirada mínima de $50). Aceitar é gratuito. As taxas de rede on-chain são separadas, sempre se aplicam e na parte de entrada são pagas pelo remetente. Detalhamento em preços.
Onde o dinheiro cai
Por padrão, o Payora credita cada pagamento confirmado ao seu saldo Payora. Você pode reembolsar ou pagar a partir desse saldo conforme sua programação, e configurações de liquidação direta aprovadas podem usar material de chave pública do comerciante — um xPub ou um pool de endereços gerados offline — onde esse modo está habilitado e suportado. Nesse modo de liquidação direta, as chaves privadas permanecem fora do servidor e os pagamentos de saída ainda são assinados offline.
Para um proprietário de loja que é operacional, não ideológico: WooCommerce e WordPress nunca precisam de chaves privadas, e seu checkout ainda depende de webhooks assinados em vez de redirecionamentos de navegador. Se você usar a liquidação direta aprovada, a mecânica xPub/somente leitura é explicada em o explicador do xPub.
O que você precisa para executá-lo
PHP 7.4 ou mais recente — em 2026, todo host compartilhado comum — e nada além do que o WordPress já exige. Sem Composer, sem trabalhador de fila, sem daemon. O módulo envolve um SDK PHP de arquivo único, sem dependências; se você preferir chamar a API REST em JSON puro diretamente, isso está documentado em a documentação.
Uma advertência honesta: seu servidor deve ser acessível pela internet para que o webhook funcione — isso é trivial para uma loja normal, mas pode ser um problema em um ambiente de staging protegido por autenticação HTTP.
Se você já possui uma loja WooCommerce, isso é um trabalho de dez minutos sem custo mensal associado.Crie uma conta gratuita, cole suas chaves, defina a URL de callback e faça um pedido de teste — então leia sobre checkout hospedado, faturas e links de pagamento em aceitar pagamentos.
Comments