Aceitar pagamentos pelo Dashboard
Introdução
Este guia é para comerciantes que recebem pagamentos pelo Dashboard da Fluxis — sem API ou código. Você aprenderá a criar solicitações de pagamento no terminal POS, usar um QR estático no caixa e acompanhar os pagamentos conforme são concluídos.
Primeira vez aqui? Conclua o Cadastro e abra seu POS padrão em Seu Dashboard e POS padrão.
Duas formas de receber pagamentos
| Método | Ideal para | Como funciona |
|---|---|---|
| Solicitação de pagamento pontual | Uma venda com valor conhecido | Informe o valor no terminal POS → o cliente escaneia o QR ou abre o link de pagamento |
| QR estático no caixa | Pagamentos de valor aberto em local fixo | Imprima ou exiba o QR estático do POS → o cliente escaneia e informa o valor na carteira |
Ambos os métodos usam seu Ponto de Venda padrão. Saiba mais sobre o conceito em Solicitação de pagamento.
Criar uma solicitação de pagamento no terminal POS
Use este fluxo quando souber o valor exato a cobrar (por exemplo, um checkout individual).
- Faça login no dashboard e vá em Points of Sale.
- Revise as configurações do POS — aqui você define quais UAIs (combinações ativo/rede) o terminal aceitará.
- Selecione sua moeda de referência clicando nela e informe um valor de teste (por exemplo,
1.00). - Clique em Charge para gerar a solicitação de pagamento.
- Mostre o QR code na tela ao cliente ou clique em Send a payment link para compartilhar o link.
- Confira a solicitação gerada na tabela à esquerda, com seu status atual.
O cliente paga com a carteira cripto. A Fluxis detecta o pagamento on-chain e atualiza o status da solicitação automaticamente.
Solicitações de pagamento expiram após cerca de 8 minutos se nenhum pagamento for recebido. Crie uma nova solicitação se o cliente precisar de mais tempo.
O que o cliente vê
O QR ou link codifica um token NASPIP — uma instrução de pagamento assinada que informa à carteira exatamente onde e quanto pagar. Você não precisa entender o formato do token para usar o dashboard; a Fluxis cuida da codificação e validação.
Imprima seu QR estático para o caixa
Em loja física, muitos comerciantes exibem um QR estático no caixa para que clientes paguem sem o atendente informar cada valor no terminal.
- Abra seu terminal POS (Points of Sale → Enter →).
- Localize a opção de QR estático deste POS (representa o terminal em si, não um valor fixo).
- Imprima ou exiba o QR onde os clientes possam escanear (balcão, suporte de recibos, sinalização).
- Quando o cliente escaneia, a carteira solicita que ele informe o valor do pagamento.
O QR estático está vinculado ao seu Ponto de Venda, não a uma transação única. Cada leitura pode iniciar um novo pagamento com o valor escolhido pelo cliente. Acompanhe pagamentos concluídos em Payments na barra lateral do dashboard.
Acompanhar pagamentos e status
Toda a atividade aparece em Payments na barra lateral do dashboard. Filtre por conta, período ou busca para encontrar transações específicas.
As solicitações de pagamento passam por estes estados:
| Estado | Significado | O que fazer no dashboard |
|---|---|---|
pending | Checkout criado; pagador ainda não escolheu ativo | Aguardar ou exibir checkout hospedado, se aplicável |
created | Endereço atribuído; aguardando pagamento (~8 min de expiração) | Manter QR/link visível; aguardar pagamento do cliente |
confirmed | Pagamento on-chain confirmado; liquidação em processamento | Aguardar completed antes de considerar totalmente liquidado |
processing | Pagamento detectado; aguardando confirmações blockchain | Informar ao cliente que o pagamento está em andamento |
completed | Pagamento recebido e confirmado | Pedido atendido; pagamento aparece nas estatísticas de volume |
expired | Sem pagamento no prazo | Criar nova solicitação para o cliente |
underpaid | Cliente enviou menos que o esperado | Contatar [email protected] |
overpaid | Cliente enviou mais que o esperado | Contatar [email protected] |
failed | Erro inesperado durante o processamento | Contatar suporte; pode ser necessária nova solicitação |
Casos extremos
Valores incomuns (underpaid, overpaid) e falhas de processamento podem exigir coordenação com o suporte. Consulte Fluxos de pagamento — Casos extremos para contexto.
Fluxo de pagamento (perspectiva do dashboard)
Code
Precisa integrar via API?
Se quiser incorporar a Fluxis em site, app móvel ou backend — e receber notificações automáticas quando os pagamentos forem concluídos — siga o caminho do desenvolvedor:
Esse guia cobre chaves de API, autenticação, criação de solicitações via POST /v1/pos/:posID/payment-request e monitoramento via webhooks ou polling.
Precisa de ajuda?
Entre em contato em [email protected].