faq

Solução de problemas

Atualizado: 09/03/2026

Pagamento Não Recebido

O cliente diz que pagou, mas a transação aparece como "Pendente" ou nenhuma transação é exibida.

Verificar o blockchain: Use um explorador de blockchain (por exemplo, Etherscan, Blockchain.com) para verificar o hash da transação. Confirme se o pagamento foi enviado para o endereço correto.

Verificar confirmações: O pagamento pode estar aguardando o número necessário de confirmações. Vá para o seu painel → Transações e procure o status da transação.

Verificar o valor: Se o cliente enviou um valor inferior ao necessário, a transação será marcada como paga a menos, a menos que "Aceitar Pagamentos Inferiores" esteja habilitado.

Verificar o endereço: Garanta que o cliente enviou para o endereço de carteira correto e na rede correta. Um erro comum é enviar tokens ERC-20 para um endereço TRC-20 (redes diferentes, os fundos podem ser perdidos).

Verificar a criptomoeda: Verifique se o cliente pagou com a criptomoeda que selecionou, e não com um token diferente na mesma rede.

Se a transação for confirmada no blockchain, mas não refletida no QuantaPay, use a APIcheck-transactionpara forçar uma nova verificação.
Se o pagamento foi enviado para o endereço errado ou rede errada, o QuantaPay não pode recuperar os fundos.

Pagamentos concluídos no painel do QuantaPay, mas seu servidor não recebe notificações de webhook.

Verificar URL do webhook: Vá para Configurações → Pagamentos → Webhook e confirme se o URL está correto.

Verificar acessibilidade do endpoint: Garanta que seu endpoint de webhook esteja acessível publicamente via HTTPS. Teste com curl:

   curl -X POST https://yoursite.com/wp-json/quantapay/webhook \
     -H "Content-Type: application/json" \
     -d '{"test": true}'

Verificar logs do servidor: Procure por requisições POST de entrada para o seu endpoint de webhook. Se não houver nenhuma, o problema é com a entrega. Se houver erros 500, o problema está no seu código de tratamento.

Firewall / WAF: Se estiver usando Cloudflare, garanta que o endpoint de webhook seja permitido (vejaWordPress / WooCommercepara a configuração do Cloudflare).

Verificar status do webhook: No seu painel → Transações, a coluna "Webhook" mostra1se o webhook foi enviado para essa transação.

Corrija o URL do webhook ou a acessibilidade do endpoint.
Use temporariamente um serviço de teste de webhook (webhook.site) para confirmar se o QuantaPay está enviando webhooks.
Como alternativa, consulte a APIget-checkout-sessionpara verificar o status do pagamento.

Erro	Causa	Solução
`api-key-not-found`	Falta o parâmetro`api-key`.	Inclua a`api-key`em toda requisição POST.
`invalid-api-key`	Chave de API incorreta.	Copie a chave correta em Configurações → Conta.
`function-not-found`	Erro de digitação no nome da função.	Verifique a ortografia do nome da função.
`missing-argument`	Parâmetro obrigatório ausente.	Verifique a documentação da API para os parâmetros obrigatórios.
Timeout de conexão	Problema de rede ou servidor inativo.	Tente novamente após alguns segundos.
Erro SSL	Problema de certificado.	Certifique-se de que os certificados CA do seu servidor estejam atualizados.

Teste com curl: Use o curl para isolar se o problema está no seu código ou na API:

   curl -X POST https://cloud.quantapay.app/api.php \
     -d "function=get-balances" \
     -d "api-key=YOUR_API_KEY"

Verifique o formato da resposta: Todas as respostas seguem o formato{"success": true/false, ...}. Analise o camposuccessantes de acessar aresponse..

Registre as requisições: Registre a requisição e a resposta completas para depuração.

Verifique se a URL do webhook está configurada tanto no WordPress quanto no QuantaPay Cloud.
Verifique o log de debug do WordPress (wp-content/debug.log) para erros.
Certifique-se de que o pedido do WooCommerce existe e está com o status "Pendente".