Terminal de pagamentos cripto: o que é e o que funciona hoje
Terminal de pagamentos cripto explicado: um dispositivo de ponto de venda para pagamentos cripto, o roteiro da Qvard e o que funciona hoje com a API.
Um terminal de pagamentos cripto é um dispositivo de ponto de venda que recebe pagamentos em criptomoedas no balcão. A Qvard tem um terminal no roteiro e ele ainda não foi lançado. Este guia explica o conceito e o caminho que funciona: um servidor de caixa que cria pagamentos com a API v1 em produção.
O que faz um terminal de pagamentos cripto
Um terminal de pagamentos cripto mostra o valor, permite que o cliente pague com a carteira e confirma o resultado na tela. Ele substitui a maquininha de cartão para negócios que querem receber cripto em um balcão físico.
Status: o terminal está no roteiro
O terminal POS da Qvard ainda não foi lançado, e este artigo não o descreve como um dispositivo pronto. O caminho abaixo está disponível hoje pela API, pela página hospedada e pelo webhook.
O que funciona hoje
O servidor do caixa cria um pagamento com POST /api/v1/payment e o cabeçalho x-api-key, e recebe um redirectUrl. O cliente paga na página hospedada para a qual aponta o redirectUrl, e o webhook entrega o status final.
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
}A chamada a partir do servidor do caixa
Envie o id da venda em id e o total em USD em price. Guarde a chave da API no servidor do caixa. A resposta devolve o redirectUrl que o caixa mostra ao cliente.
Confirme a venda pelo webhook
O caixa deve marcar a venda como paga somente depois que o webhook entregar o id e o status paid. Até lá a venda fica pendente, mesmo que o cliente diga que já pagou.
Como se preparar para um terminal próprio
Mantenha a lógica de vendas e o webhook no software do caixa. Quando um terminal dedicado for lançado, o dispositivo muda, mas a criação do pagamento e o tratamento do status continuam os mesmos.
FAQ
Existe hoje um terminal de pagamentos cripto da Qvard?
Ainda não. O terminal POS está no roteiro. Hoje um servidor de caixa usa a API, a página hospedada e o webhook.
Posso usar o meu próprio software de caixa?
Sim. Qualquer software que envie um POST HTTPS e receba um webhook pode criar pagamentos pela API.
O que o cliente vê no balcão?
Hoje o caixa mostra o redirectUrl como QR code ou link, e a página de pagamento abre no dispositivo do cliente.
Como testar antes de uma venda real?
Crie uma fatura de demonstração, pague na página hospedada e confira se o webhook marca a venda.
