Visão geral

O plugin QuantaPay Payment noWordPress.orgadiciona um gateway de criptomoedas não custodial ao WooCommerce (checkout clássico, Blocks, HPOS) e Easy Digital Downloads. Use este documento para manter cada etapa em um só lugar, em vez de alternar entre arquivos de FAQ/Readme.

Requisitos

• WordPress 5.8+ com WooCommerce 6.0+ ou EDD 3.0+, PHP 7.4+ (8.x recomendado).

• Acesso HTTPS de saída para cloud.quantapay.app para API + verificação de Webhook.

• Workspace ativo do QuantaPay Cloud com Chave de API e Segredo de Webhook.

• Capacidade de permitir solicitações para https://seusite.com/wp-json/quantapay/webhook através de WAF/Cloudflare.

Instale o Plugin

1) Baixe o zip mais recente do WordPress.org ou da sua build interna.

2) No painel de administração do WordPress, vá para Plugins → Adicionar Novo → Enviar Plugin e envie quantapay-payment.zip.

3) Ative o “QuantaPay Payment”. Uma nova tela Configurações → QuantaPay aparece para as credenciais.

Configure as Credenciais e o Checkout

• AbraConfigurações → QuantaPaye cole a Chave de API do Cloud + Segredo de Webhook e salve. A página mostra o URL do Webhook gerado (https://seudominio.com/wp-json/quantapay/webhook).

• WooCommerce: vá paraWooCommerce → Configurações → Pagamentos → QuantaPay(ou Pagamentos → Gerenciar na nova UI) e alterne para “Ativar”. Escolha o título/descrição do checkout e a moeda padrão.

• Configuração Rápida: ainda em Configurações → QuantaPay, você pode sincronizar endereços de carteira, redirecionamento de agradecimento, cópia de checkout localizada e preferência de registro sem editar o PHP.

• Easy Digital Downloads: ative o gateway emDownloads → Configurações → Gateways de Pagamento → QuantaPaypara expô-lo nos formulários de checkout do EDD.

Lista de Verificação de Webhook e Firewall

1) No QuantaPay Cloud, vá para Configurações → Webhooks e cole o endpoint do WordPress exibido no plugin. Clique em “Verificar Segredo” para armazenar a assinatura.

2) Se você executar o Cloudflare ou outro WAF, crie uma regra: Nome do host é igual a seudominio.com E URI contém /wp-json/quantapay, ação Permitir/Ignorar. Opcionalmente, filtre pelo user agent ou cabeçalho de assinatura do QuantaPay-Webhook.

3) Mantenha o site fora do modo “Estou Sob Ataque” para esse endpoint, para que os callbacks assinados cheguem ao WordPress antes que o plugin os valide.

Testes e Solução de Problemas

• Faça um pedido de teste de $1 no WooCommerce ou EDD e escolha QuantaPay. Confirme se a página hospedada exibe a mesma moeda e valor.

• No QuantaPay Cloud, marque a fatura como paga ou envie uma transferência de criptomoeda real; o WordPress deve mover o pedido de Pendente para Processando/Concluído com o hash do blockchain armazenado nas notas do pedido.

• Se os pedidos não forem atualizados, verifique a Chave de API do Cloud/Segredo de Webhook, confirme se o Cloudflare permite o endpoint e revise wp-content/uploads/quantapay/quantapay-debug.log (ative o registro somente durante o teste; os segredos são redigidos).

• Use o botão “Testar API do Cloud” dentro de Configurações → QuantaPay para confirmar as credenciais e atualizar os snapshots da carteira sem criar um novo pedido.

Remoção ou Reinstalação

Desativar o plugin mantém a configuração para mais tarde. Escolher Excluir remove as opções armazenadas e as preferências de registro, mas nunca toca nos pedidos do WooCommerce ou EDD. Sempre faça backup antes de substituir o conector em produção.

Links Úteis

•Download / changelog no WordPress.org

•Painel do QuantaPay Cloud

•Índice de documentos

• Suporte:[email protected]

Precisa de ajuda?

Precisa de ajuda? Envie um e-mail para[email protected]e mencione o URL do site e o ID do pedido.