Aceitar cripto sem redirecionamento: checkout integrado Qvard
Aceite criptografia sem redirecionamento usando o checkout integrado do Qvard. Um widget JavaScript na sua página, duas formas de criar pagamentos e verificação de assinatura de webhook. Por que isso importa e como funciona.
Aceitar cripto sem redirecionamento significa que o cliente paga sem sair da sua página. O checkout integrado do Qvard faz exatamente isso: adicione um script de qvard.com/checkout.js, crie pagamentos via API ou navegador e manipule a assinatura do webhook. Este guia mostra como.
Por que o redirecionamento custa conversões
Cada redirecionamento é um momento em que o cliente pode desistir. Ele sai da loja, vê uma página desconhecida e precisa confiar em um site novo. Manter o pagamento na sua página reduz esse atrito e ajuda a concluir o pedido.
Como funciona na Qvard
O checkout integrado da Qvard está ao vivo e pronto para usar. Adicione o script https://qvard.com/checkout.js à sua página, crie um pagamento via seu backend ou direto no navegador e abra o widget. A janela de pagamento é uma página Qvard em iframe ou popup: o cliente vê seu idioma, escolhe um ativo e rede, e paga. Visite https://qvard.com/en/embedded-checkout/playground/ para ver em ação.
Duas maneiras de criar o pagamento
No servidor (seguro): POST /api/v1/payment com sua chave secreta qvard_sk_... no cabeçalho x-api-key; você obtém um id e redirectUrl. No navegador (rápido): passe sua chave pública qvard_pk_... ao widget e deixe o cliente pagar da página—seu navegador envia o valor, então verifique no webhook. Se preferir não integrar, redirecione para redirectUrl na página hospedada; esse fluxo também funciona.
X-Qvard-Signature: t=1760950000,v1=…
{ "id": "order_1024", "status": "paid" }Reduza o atrito em torno do redirecionamento
Crie o pagamento somente quando o cliente clicar em pagar, e não antes. Mostre o total e a moeda antes do redirecionamento, para que o cliente saiba o que verá na página seguinte. O id do pedido e o total devem ser os mesmos do carrinho até o pagamento.
Verifique a assinatura do webhook
Todo webhook carrega um cabeçalho X-Qvard-Signature: assine o corpo da requisição com sua chave secreta usando HMAC-SHA256, formato t=<timestamp>,v1=<hex>. Verifique a assinatura, confirme que o timestamp é recente (rejeite requisições antigas), e somente então marque o pedido como pago se o webhook confirma o id do pagamento e um status de pago. Depois envie a confirmação ao cliente.
Quando escolher a janela integrada
Escolha a janela integrada quando seu funil perde clientes no redirecionamento. O widget os mantém na sua página enquanto pagam. O cliente escolhe um ativo e rede; a janela confirma valores e detalhes, então ele sabe exatamente o que esperar.
FAQ
A Qvard aceita cripto sem redirecionamento hoje?
Sim. Use o widget de checkout integrado de qvard.com/checkout.js para manter a janela de pagamento na sua página. O cliente paga sem sair, e você manipula o webhook para confirmar o pagamento.
O redirecionamento reduz a conversão?
Pode reduzir, porque os clientes podem sair pelo caminho. O widget integrado resolve isso mantendo o pagamento na sua página e mostrando ao cliente seu idioma e valores finais de imediato.
O que preciso para integrar o widget?
Adicione o script https://qvard.com/checkout.js, crie um pagamento via API ou navegador e escute os eventos onSuccess, onClose ou onError. O webhook confirma o pagamento assim que o cliente pagar.
É seguro colocar a chave pública no navegador?
Sim, a chave pública qvard_pk_... é feita para o navegador. Defina limites sobre quais sites podem usá-la no seu painel de controle. Mas sempre verifique o valor no webhook porque o valor no navegador pode ser alterado.
