Aceitar cripto em loja física: como um estabelecimento pode receber cripto hoje
Como aceitar cripto em loja física: o fluxo de venda no caixa, o que o terminal da Qvard prevê e o caminho que funciona hoje com a API. Passo a passo.
Aceitar cripto em uma loja significa que o cliente paga no balcão com uma carteira em vez de cartão. A Qvard prevê um terminal POS para isso, que ainda não foi lançado. Este guia explica o fluxo de venda e o caminho que funciona hoje: o caixa cria o pagamento e o cliente paga na página hospedada.
O fluxo de venda na loja
O caixa digita o total, o caixa mostra um código de pagamento, o cliente o escaneia com uma carteira e a venda é confirmada. Os passos são simples, mas o caixa precisa saber quando o pagamento é definitivo.
Status: o terminal POS está no roteiro
Um terminal dedicado da Qvard para lojas ainda não foi lançado, e este artigo não o apresenta como disponível. O fluxo de venda abaixo funciona hoje com a API, a página hospedada e o webhook.
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 um redirectUrl e o mostra como QR code ou link. O cliente paga na página hospedada, e o webhook devolve o status final ao caixa.
Mostre o total antes do pagamento
Exiba o valor em USD no balcão antes de o cliente escanear. A página hospedada mostra depois o valor exato em cripto, com taxa fixa, para o ativo e a rede escolhidos.
Trate o status no balcão
Mantenha a venda pendente no caixa até que o webhook entregue paid. O recibo impresso deve seguir o status pago, não a palavra do cliente.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }Planeje para o terminal
Quando o terminal dedicado for lançado, o equipamento do balcão muda. O software do caixa, os registros de pedidos e o tratamento do webhook continuam no lugar.
FAQ
Uma loja pode aceitar cripto no balcão hoje?
Sim, com um caixa que cria pagamentos pela API e mostra o redirectUrl como QR code ou link. O terminal dedicado está no roteiro.
O cliente precisa de um aplicativo?
Precisa de uma carteira que suporte o ativo e a rede escolhidos. A página hospedada guia o pagamento.
Quando uma venda é definitiva?
Quando o webhook entregar o id e o status paid, não quando o cliente mostrar a tela de pagamento.
Como testar em uma loja?
Crie uma fatura de demonstração a partir de um caixa de teste e confirme que o webhook marca a venda antes de entrar no ar.
