WordPress / WooCommerce

Aceite pagamentos em criptomoedas na sua loja WooCommerce usando o plugin oficial QuantaPay Payment.

Requisitos

• WordPress 5.8+
• WooCommerce (qualquer versão recente)
• PHP 7.4+ (PHP 8.x recomendado)
• Uma conta QuantaPay Cloud (cloud.quantapay.app)

Instalação

Do Diretório de Plugins do WordPress

1. Vá paraPlugins → Adicionar Novono seu painel de administração do WordPress.
2. Pesquise por"QuantaPay Payment".
3. Clique emInstalar Agora, e entãoAtivar.

Instalação Manual

1. Baixe o plugin dewordpress.org/plugins/quantapay-payment.
2. Envie a pastaquantapay-paymentpara/wp-content/plugins/.
3. Ative o plugin emPlugins → Plugins Instalados.

Configuração

Passo 1: Obtenha Suas Credenciais

No seu painel QuantaPay Cloud:

1. API Key— Encontrada emSettings → Account
2. Webhook Secret Key— Encontrada emSettings → Payments → Webhook

Passo 2: Insira as Credenciais no WordPress

1. Navegue até o menuQuantaPayna barra lateral do seu WordPress.
2. Cole seuChave de API da NuvemeWebhook Secret Key.
3. Salvar configurações.

Passo 3: Configurar URL do Webhook

1. O plugin gera uma URL de webhook:https://yoursite.com/wp-json/quantapay/webhook
2. Copie esta URL e cole-a emCloud → Configurações → Pagamentos → URL do Webhook.

Passo 4: Ativar o Gateway

Vá paraWooCommerce → Configurações → Pagamentos → QuantaPaye ative-o.

Configurações do WooCommerce

O plugin adiciona configurações diretamente na página de Pagamentos do WooCommerce:

Configuração Rápida

O menuQuantaPayda barra lateral fornece uma aba de Configuração Rápida onde você pode gerenciar:

• Endereços de carteira
• Moeda padrão
• URL de redirecionamento de agradecimento
• Texto/mensagens do checkout

As alterações feitas aqui são sincronizadas com as configurações da sua Nuvem QuantaPay.

Suporte ao Block Checkout

O plugin oferece suporte total ao Block Checkout do WooCommerce (o novo checkout baseado em React). Tanto o checkout Clássico quanto o Block compartilham a mesma configuração e exibem a faixa de ícones de criptomoedas (BTC, ETH, USDT, USDC, BNB).

Fluxo de Pagamento

1. O cliente seleciona "Pagar com cripto" no checkout.
2. O WooCommerce cria o pedido e chama a API QuantaPay Checkout Session.
3. O cliente é redirecionado para a página de pagamento da QuantaPay.
4. O cliente seleciona a criptomoeda, escaneia o código QR e envia o pagamento.
5. Após a confirmação no blockchain, a QuantaPay envia um webhook para o seu site WordPress.
6. O plugin atualiza o status do pedido do WooCommerce para "Processando" ou "Concluído".
7. O cliente é redirecionado para a página de agradecimento do WooCommerce.

Sincronização do Painel

Na página de administração da QuantaPay no WordPress, você pode:

• Visualizar os saldos da sua carteira
• Navegar pelas 100 transações mais recentes
• Verificar os logs de depuração
• Ver notificações de pagamentos insuficientes e faturas expiradas

Segurança

• Os webhooks são verificados usando a assinatura da chave secreta compartilhada.
• As configurações confidenciais (chaves de API) são criptografadas em repouso.
• As assinaturas HMAC-SHA256 protegem a criação da sessão de checkout contra adulteração.
• Os logs de depuração redigem automaticamente os segredos.

Configuração do Cloudflare / WAF

Se o seu site estiver atrás do Cloudflare ou outro WAF, permita o endpoint do webhook:

1. Crie uma regra de Firewall/WAF correspondente aURI contém /wp-json/quantapay.
2. Defina a ação paraPermitirouIgnorar Segurança.
3. Garanta que o Nível de Segurança não esteja definido como "Estou Sob Ataque" para esse URL.

Idiomas suportados

O plugin é fornecido com traduções para 9 idiomas:

• Inglês, Chinês (Simplificado), Espanhol, Português (Brasileiro), Russo, Francês, Japonês, Coreano, Alemão

Preços

A QuantaPay cobra uma taxa fixa de0,8% por pagamento cripto bem-sucedido. Sem taxas mensais ou taxas de retirada.