Pagamentos cripto com QR code: como um código escaneado leva ao pagamento
Pagamentos cripto com QR code explicados: como um código escaneado leva à página de pagamento, o que a Qvard prevê para o QR no terminal e o que funciona hoje.
Os pagamentos cripto com QR code permitem que o cliente escaneie um código com a carteira e pague em criptomoedas. A Qvard prevê o pagamento por QR no seu terminal POS, que ainda não foi lançado. Este guia explica como o escaneamento leva ao pagamento e o que funciona hoje: um QR code que aponta para a página de pagamento hospedada.
O que o QR code contém
Um QR code é a imagem de um link. Quando o cliente o escaneia, a carteira ou o celular abre o link, e o link leva à página de pagamento daquela venda específica.
Status: o QR no terminal está no roteiro
Um terminal da Qvard que mostre o próprio QR code ainda não foi lançado. Este artigo não o apresenta como disponível. O fluxo por QR abaixo funciona hoje, porque o código codifica o redirectUrl devolvido pela API.
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
}O que funciona hoje
O caixa cria o pagamento com POST /api/v1/payment e o cabeçalho x-api-key, recebe o redirectUrl e o codifica como QR code. O cliente escaneia, abre a página hospedada e paga, e o webhook entrega o status final.
Codifique apenas o redirectUrl
Coloque só o redirectUrl no código. Não inclua a chave da API, o total nem nenhum segredo no QR code, porque quem vir o código poderá lê-lo.
Mostre o valor ao lado do código
Exiba o total em USD ao lado do QR code. A página hospedada mostra depois o valor exato na criptomoeda escolhida, com taxa fixa, para que o cliente possa comparar.
Confirme pelo webhook
Um código escaneado não comprova o pagamento. Marque a venda como paga somente quando o webhook entregar o id e o status paid.
FAQ
A Qvard mostra hoje um QR code no terminal?
Não por um terminal dedicado, que está no roteiro. Hoje o seu próprio caixa pode gerar um QR code a partir do redirectUrl.
Posso colocar a chave da API no QR code?
Nunca. O QR code deve conter apenas o redirectUrl, que pode ser compartilhado com segurança.
Um QR code escaneado basta para confirmar o pagamento?
Não. Confirme o pagamento somente pelo webhook com o status paid.
Como testar o QR code?
Crie uma fatura de demonstração, codifique o redirectUrl dela e escaneie com uma carteira de teste.
