PDV — visão geral
:::info Estado atual O PDV já cobra pela wallet de um participante sem app, usando o QR impresso emitido pelo caixa + PIN, e também já cobra um participante com app via QR/NFC dinâmico, com aprovação pelo celular do participante. Sessão operacional (abrir/fechar terminal), pedidos com múltiplos itens e estornos ainda não existem — esta página será expandida assim que esses endpoints existirem. :::
O PDV é uma conta operacional (operator_type=pdv), criada pela gestão e
escopada a um workspace específico. Ver Gestão → Operadores (PDV e
caixa) para como a conta é provisionada.
O que existe hoje
- Login/logout/refresh (ver Autenticação).
- Cobrar um participante sem app, via QR impresso + PIN emitido pelo caixa (ver Pagamento via QR impresso + PIN).
- Cobrar um participante com app, via QR/NFC dinâmico com aprovação pelo celular (ver Pagamento dinâmico via QR/NFC).
- Consultar o histórico das próprias vendas/tentativas, dos dois métodos juntos (ver Minhas vendas).
Onde cada coisa vive
- Autenticação — login, refresh, logout, o que o JWT do PDV contém.
- Pagamento via QR impresso + PIN — cobrar participante sem app.
- Pagamento dinâmico via QR/NFC — cobrar participante com app, com notificação em tempo real via WebSocket.
- Minhas vendas — histórico unificado de vendas aprovadas, recusadas e expiradas.
Planejado (ainda não implementado)
- Sessão operacional do terminal (abrir/fechar).
- Criação de pedido com múltiplos itens e
payment intent. - Estorno total/parcial de uma cobrança.