Sistema POS cripto: como um PDV pode receber cripto
Sistema POS cripto explicado: como um PDV pode aceitar cripto, o que a Qvard prevê para o seu terminal POS e o que funciona hoje com a API. Com exemplos.
Um sistema POS cripto é um software de ponto de venda que recebe pagamentos em criptomoedas ao lado de dinheiro e cartões. A Qvard prevê um terminal POS, que ainda não foi lançado. Este artigo mostra como um PDV pode se conectar hoje à API v1 em produção e onde um terminal dedicado entraria depois.
O que um sistema POS cripto precisa
Um PDV precisa criar um pagamento pelo total da venda, mostrar um link escaneável e receber o status final para fechar a venda. O restante, como recibos e estoque, fica no software do PDV.
Status: o terminal POS da Qvard está no roteiro
O terminal POS da Qvard ainda não foi lançado, e este artigo não o apresenta como dispositivo pronto. A integração abaixo funciona hoje com a API, a página hospedada e o webhook.
A integração hoje
O software do PDV envia POST /api/v1/payment com o cabeçalho x-api-key, o id e o total da venta, recebe um redirectUrl e o mostra como QR code ou link. Depois o webhook devolve o status final para fechar a venda no PDV.
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
}Relacione a venda ao pagamento
Use o id da venda como id, para que cada pagamento fique ligado a exatamente uma venda. O total em USD vai em price.
Feche a venda pelo webhook
O PDV fecha a venda e imprime o recibo somente quando o webhook entregar paid. Vendas pendentes podem aparecer como aguardando, para que o operador saiba que o dinheiro ainda não chegou.
Planeje o caminho de atualização
Quando o terminal dedicado for lançado, ele poderá assumir a etapa do QR code. O software do PDV, os registros de vendas e o tratamento do webhook não mudam.
FAQ
O meu software de PDV pode aceitar cripto hoje?
Sim, se ele conseguir enviar um POST HTTPS, mostrar um QR code ou link e receber um webhook. O terminal POS da Qvard está no roteiro.
Qual campo liga um pagamento a uma venda?
O campo id leva o id da sua venda, assim cada pagamento corresponde a uma venda no seu sistema.
O PDV precisa de um plugin especial?
Não. Qualquer PDV que consiga chamar um endpoint REST e receber um webhook pode se integrar com a API.
Como testar a integração do PDV?
Crie uma fatura de demonstração a partir de uma venda de teste e confirme que o PDV fecha a venda quando o webhook chegar.
