Pagamentos cripto em eventos: receber cripto em feiras e festivais
Pagamentos cripto em eventos explicados: receber cripto em feiras e festivais, o que a Qvard prevê para terminais de evento e o caminho que funciona hoje.
Pagamentos cripto em eventos significam que os vendedores de feiras, festivais e mercados aceitam criptomoedas dos visitantes. A Qvard prevê um terminal para esses eventos, que ainda não foi lançado. Este guia explica o fluxo do evento e o caminho que funciona hoje: o caixa de cada vendedor cria os pagamentos pela API e mostra um QR code ao visitante.
Por que eventos são um caso especial
Em um evento muitas vezes não há internet estável e há muitas vendas curtas em sequência. Cada venda ainda precisa ser um pagamento separado com o seu próprio status, e o vendedor precisa de uma forma clara de mostrar o valor.
Status: o terminal para eventos está no roteiro
Um terminal da Qvard para vendedores de eventos ainda não foi lançado, e este artigo não o descreve como disponível. O caminho abaixo usa a API, a página hospedada e o webhook, e precisa de conexão no momento do pagamento.
O que funciona hoje
O caixa de cada vendedor cria cada pagamento com POST /api/v1/payment e o cabeçalho x-api-key, recebe um redirectUrl e o mostra como QR code. O visitante paga na página hospedada, e o webhook devolve o status final ao caixa.
Um pagamento por venda
Crie um pagamento separado para cada venda, com um id único, para que cada venda possa ser confirmada individualmente. Totais em lote não substituem o status por venda.
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
}Prepare-se para conexão fraca
Se a conexão for ruim, mantenha a venda pendente no caixa e repita a requisição quando a rede voltar. Não mostre uma venda como paga até que o webhook a confirme.
Concilie após o evento
Depois do evento, compare a lista de vendas do caixa com os webhooks pagos. As vendas que ficaram pendentes precisam de acompanhamento antes de serem fechadas.
FAQ
Existe hoje um terminal da Qvard para eventos?
Ainda não. O terminal para eventos está no roteiro. Hoje cada vendedor usa um caixa que funciona com a API.
O vendedor precisa de internet na barraca?
Sim, para criar pagamentos e receber o webhook. Planeje uma conexão ou uma estratégia de novas tentativas para o evento.
Um pagamento pode cobrir várias vendas?
Não. Crie um pagamento por venda, para que cada uma tenha o seu próprio id e status.
Como testar antes de um evento?
Crie faturas de demonstração a partir de um caixa de teste e confira se o webhook marca cada uma antes do início do evento.
