Botão de pagamento cripto: como adicioná-lo ao seu site
Botão de pagamento cripto: como adicionar um botão de pagar com cripto ao seu site, o que é o botão previsto do SDK e o que funciona hoje. Com código.
Um botão de pagamento cripto é um único botão no seu site que inicia um pagamento em criptomoedas. O SDK previsto da Qvard renderizaria esse botão com algumas linhas de código, mas ele ainda não foi lançado. Este guia mostra como criar hoje um botão que funciona com a API real.
O que faz um botão de pagamento cripto
Um botão de pagamento inicia um pagamento quando o cliente clica. Em um site cripto o clique leva a uma página de pagamento em que o cliente escolhe o ativo e a rede. O próprio botão não guarda fundos nem chaves.
Status: o botão do SDK está no roteiro
O botão do SDK da Qvard ainda não foi lançado. Este artigo não o apresenta como componente pronto, e o código de prévia na mídia está marcado como roteiro.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 149.99,
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Um botão que funciona hoje
O botão envia uma requisição ao seu backend. O backend cria o pagamento com POST /api/v1/payment e o cabeçalho x-api-key e devolve o redirectUrl. O botão leva o cliente até lá, e o webhook confirma o pagamento.
Posicione o botão no checkout
Coloque o botão no fim do carrinho, junto ao total. Mostre o valor em USD antes do clique, para que o cliente saiba o que esperar na página hospedada.
Torne o botão seguro
Não coloque a chave da API no código do botão. Crie o pagamento apenas quando o cliente clicar e confira o total do pedido no servidor, não no navegador.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });Confirme pelo webhook
Quando o webhook entregar o id e o status paid, marque o pedido como pago. Um clique no botão não significa que o dinheiro chegou.
FAQ
Existe hoje um componente de botão de pagamento da Qvard?
Não como componente do SDK, que está no roteiro. Hoje um botão comum que chama o seu backend faz o mesmo trabalho.
O botão pode mostrar o valor em outra moeda?
O preço na requisição da API é em USD. A página hospedada mostra o valor exato no ativo escolhido, com taxa fixa.
O botão basta sem webhook?
Não. O botão apenas inicia o pagamento. Marque o pedido como pago somente pelo webhook.
Como testar o botão?
Use um fluxo com fatura de demonstração e confirme que o webhook marca o pedido após o pagamento.
