# 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.

::::info
Primeira vez aqui? Conclua o [Cadastro](/pt/docs/merchant-integration/sign-up) e abra seu POS padrão em [Seu Dashboard e POS padrão](/pt/docs/merchant-integration/auth-and-conf).
::::

## 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](/pt/docs/key-concepts/point-of-sale) padrão. Saiba mais sobre o conceito em [Solicitação de pagamento](/pt/docs/key-concepts/payment-request).

## Criar uma solicitação de pagamento no terminal POS

Use este fluxo quando souber o valor exato a cobrar (por exemplo, um checkout individual).

1. Faça login no dashboard e vá em **Points of Sale**.
2. Revise as **configurações** do POS — aqui você define quais [UAIs](/pt/docs/key-concepts/uai) (combinações ativo/rede) o terminal aceitará.
3. Selecione sua moeda de referência clicando nela e informe um valor de teste (por exemplo, `1.00`).
4. Clique em **Charge** para gerar a solicitação de pagamento.
5. Mostre o QR code na tela ao cliente ou clique em **Send a payment link** para compartilhar o link.
6. 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.

::::tip
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**](/pt/docs/key-concepts/naspip/introduction) — 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.

1. Abra seu terminal POS (**Points of Sale → Enter →**).
2. Localize a opção de **QR estático** deste POS (representa o terminal em si, não um valor fixo).
3. **Imprima** ou exiba o QR onde os clientes possam escanear (balcão, suporte de recibos, sinalização).
4. Quando o cliente escaneia, a carteira solicita que ele **informe o valor do pagamento**.

::::note
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 [support@fluxis.us](mailto:support@fluxis.us) |
| `overpaid` | Cliente enviou mais que o esperado | Contatar [support@fluxis.us](mailto:support@fluxis.us) |
| `failed` | Erro inesperado durante o processamento | Contatar suporte; pode ser necessária nova solicitação |

::::info
**Casos extremos**

Valores incomuns (`underpaid`, `overpaid`) e falhas de processamento podem exigir coordenação com o suporte. Consulte [Fluxos de pagamento — Casos extremos](/pt/docs/payment-flows/edge-cases) para contexto.
::::

### Fluxo de pagamento (perspectiva do dashboard)

```mermaid
sequenceDiagram
    participant M as Merchant
    participant D as Fluxis Dashboard
    participant C as Customer
    participant B as Blockchain

    M->>D: Create payment request or show static QR
    D->>C: Display QR / payment link
    C->>B: Send payment
    B->>D: Transaction detected
    D->>M: Status updates in Payments tab
    M->>C: Confirm order / receipt
```

## 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:

**[Guia de integração API →](/pt/docs/developers/tutorials/api-integration-guide)**

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 [support@fluxis.us](mailto:support@fluxis.us).