A Maquininha é uma tela da Kontato pensada como PDV (Point of Sale) — pra você cobrar cliente presencial, sem abrir o painel Asaas, com fluxo otimizado pra mobile.
O que é
Não é hardware. É um modo de UI otimizado pra você usar no celular durante atendimento presencial:
- Layout max-428px (cabe na palma da mão)
- Fundo escuro (não cansa a vista, foco no que importa)
- Botões grandes estilo calculadora
- Vibração tátil (10ms a cada toque, feedback físico)
- Fluxo de 7 telas em sequência clara
Como acessar
Em qualquer tela, click no botão "Maquininha" (ícone calculadora) no menu inferior em mobile, ou em desktop pelo /maquininha.
Página inicial mostra keypad numérico estilo POS:
┌─────────────────────────┐
│ R$ 0,00 │
├─────────────────────────┤
│ 7 8 9 ⌫ │
│ 4 5 6 │
│ 1 2 3 COBRAR │
│ 0 , → │
└─────────────────────────┘
Fluxo das 7 telas
Keypad numérico — você digita o valor (R$ 0,00 → R$ 80,00). Vibração 10ms a cada digito.
Buscar cliente — input de busca por nome ou telefone (últimos 8 dígitos). Se cliente não existir, criar novo na hora.
Confirmar valor + cliente — preview com nome do cliente, valor, próximo passo.
Forma de pagamento — Pix · Crédito · Débito · Dinheiro (registro manual).
Pix: mostra QR code grande na tela pra cliente escanear; ou Cartão: abre checkout Asaas embed; ou Dinheiro: confirma e pula pra recibo.
Aguardando confirmação (Pix/cartão) — polling 3s/5min ou retorno do checkout. Spinner animado.
Recibo — confirmação visual (✓ verde grande), opção de enviar pro cliente via WhatsApp, link compartilhável.
Casos de uso típicos
✅ Faz sentido:
- Cabeleireiro que finaliza atendimento e cobra na hora
- Estética que faz combo de serviços (vai somando)
- Maquiagem em domicílio (não tem maquininha física)
- Loja sem PDV físico (instalação, conserto)
❌ Não tão útil:
- Quem cobra remoto (cliente nem está presente) — usa cobrança normal em
/cobrancas - Cobrança recorrente (assinatura mensal) — usa
/cobrancas → assinatura - Cobrança com agendamento futuro — abre cobrança vinculada ao agendamento
Vibração tátil
10ms de vibração em cada toque (keypad, botão, confirmação) usa navigator.vibrate(10). Funciona em qualquer browser mobile (não precisa app nativo).
⚠️ Não funciona em desktop (não tem hardware de vibração).
Diferenças vs cobrança avulsa
| Maquininha | Cobrança avulsa (/cobrancas → Nova) |
|---|---|
| Otimizada pra presencial (mobile) | Otimizada pra remoto (envia link WhatsApp) |
| Layout PDV (keypad grande) | Form normal |
| Fluxo 7 telas guiado | Form único |
| Cliente novo criável na hora | Sempre vincula a cliente |
| Foco em velocidade | Foco em completude (notas, vencimento custom, etc) |
Use o que faz sentido pra cada situação. Mesmo Asaas no backend.
Maquininha Kontato (hardware) — futuro
Há roadmap pra maquininha física Kontato (terminal Bluetooth/4G), mas hoje não existe ainda. Quando lançar, vai integrar com este modo PDV automaticamente — você grita o valor, terminal cobra cartão direto.