Perguntas Frequentes

Geral

O que é QuantaPay?

QuantaPay é um gateway de pagamento de criptomoedas não custodial. Ele permite que empresas aceitem Bitcoin, Ethereum, USDT e mais de 30 outras criptomoedas como pagamento. "Não custodial" significa que a QuantaPay nunca detém seus fundos — os pagamentos vão diretamente para sua carteira.

Quanto custa?

A QuantaPay cobra uma taxa fixa de0,8% por transação bem-sucedida, deduzida do seu saldo de Créditos. Não há taxas mensais, taxas de configuração ou taxas de saque.

O que é o sistema de Créditos?

Créditos são seu saldo pré-pago usado para cobrir as taxas de transação. Quando um pagamento é concluído, a taxa de 0,8% é deduzida de seus Créditos. Você pode verificar seu saldo através do painel.

QuantaPay é seguro?

Sim. QuantaPay não é custodial — seus fundos vão diretamente para o endereço da sua carteira. Nunca temos acesso às suas chaves privadas ou fundos. Todas as comunicações da API usam HTTPS, e os webhooks incluem uma chave secreta para verificação.

Quais criptomoedas são suportadas?

QuantaPay suporta mais de 30 criptomoedas, incluindo:

• Principais: BTC, ETH, USDT, USDC, BNB, SOL, TRX
• Altcoins: LTC, DOGE, XRP, BCH, XMR, LINK, SHIB, BAT, ALGO, AVAX, DOT, XLM, XTZ, POL e mais
• Stablecoins: USDT (ERC-20, TRC-20, BEP-20, TON), USDC
• TON: Toncoin e USDT na rede TON
• Redes L2: Ethereum em Base, Arbitrum, Optimism
• Tokens Personalizados: Adicione qualquer token ERC-20 ou BEP-20 (plano Pro)

Em quais moedas posso definir os preços?

Você pode definir o preço de checkout em mais de 160 moedas fiduciárias (USD, EUR, GBP, JPY, CNY, etc.). QuantaPay converte automaticamente para a criptomoeda escolhida pelo cliente usando taxas de câmbio em tempo real.

Pagamentos

Quanto tempo leva um pagamento?

A velocidade do pagamento depende da criptomoeda:

• Solana: ~1-2 segundos
• Tron (USDT TRC-20): ~3-10 segundos
• Ethereum / ERC-20: ~30 segundos a 3 minutos
• Bitcoin: ~10-30 minutos (1-3 confirmações)

Esses tempos podem variar com base no congestionamento da rede.

O que acontece se o cliente pagar um valor inferior ao correto?

Por padrão, pagamentos insuficientes são marcados como "pagos insuficientemente" e não são concluídos. Você pode habilitarAceitar Pagamentos Insuficientesem Configurações → Pagamentos → Opções de Pagamento para aceitar automaticamente pequenos pagamentos insuficientes.

Qual é o tempo limite de pagamento?

As sessões de checkout expiram após60 minutos. Se o cliente não concluir o pagamento dentro deste período, a sessão expira. O cliente pode criar uma nova sessão para tentar novamente.

Os clientes podem pagar com MetaMask?

Sim. Habilite a opçãoPagar com MetaMaskem Configurações → Pagamentos → Opções de Pagamento. Isso adiciona um botão MetaMask na página de pagamento para criptomoedas compatíveis com Ethereum.

O que acontece se a taxa de câmbio mudar durante o pagamento?

A taxa de câmbio é determinada quando o cliente seleciona uma criptomoeda na página de pagamento. O cliente tem 60 minutos a partir da criação da sessão para concluir o pagamento. Se a sessão expirar, uma nova sessão com taxas atualizadas pode ser criada.

Técnico

Por que meu webhook não está recebendo notificações?

Causas comuns:

1. URL incorreto— Verifique o URL do webhook em Configurações → Pagamentos → Webhook.
2. Firewall bloqueando— Se estiver usando Cloudflare ou um WAF, permita o endpoint do webhook.
3. HTTPS obrigatório— URLs de webhook devem usar HTTPS.
4. Erro do servidor— Verifique os logs do seu servidor para erros 500 no endpoint do webhook.
5. Não concluído— Webhooks são acionados apenas para transações concluídas (statusC).

Por que minha transação permanece "Pendente"?

• O cliente pode não ter enviado o pagamento ainda.
• O blockchain pode estar congestionado, causando confirmações lentas.
• O valor do pagamento pode não corresponder ao valor esperado.
• A contagem de confirmações não atingiu o mínimo configurado.

Usecheck-transactionpara forçar uma nova verificação ou espere pela verificação automática do cron.

Qual formato de endereço devo usar?

Posso usar o QuantaPay em localhost?

Você pode fazer chamadas de API a partir do localhost, mas os webhooks exigem um URL acessível publicamente. Use um serviço de tunneling como o ngrok para desenvolvimento local.