Aqui o passo a passo completo pra cobrar cliente presencial com a maquininha. Pra primeira vez, ler tudo. Depois vira automático.
Pré-requisitos
- ✅ Asaas conectado (em Configurações → Cobranças → Conectar Asaas)
- ✅ Cliente com CPF cadastrado (Asaas exige) OU disposto a cadastrar agora
- ✅ Valor que você vai cobrar (preço do serviço, somatório do combo, etc)
Fluxo passo a passo
1. Abrir maquininha
Toca no botão Maquininha no menu inferior (em mobile) ou navega pra /maquininha (desktop). Tela inicial:
R$ 0,00
[keypad numérico]
[COBRAR]
2. Digitar valor
Toca os números:
- 80 → R$ 0,80
- 800 → R$ 8,00
- 8000 → R$ 80,00
Vibração de 10ms a cada toque (mobile).
⚠️ Não tem ponto/vírgula — o sistema ajusta automaticamente. R$ 80,00 é "8000" no keypad.
Para corrigir, usa o ⌫ (backspace).
3. Click em COBRAR
Avança pra tela de cliente.
4. Escolher cliente
🔍 Buscar cliente
[input: nome ou telefone]
Cliente cadastrado:
- Digita 2-3 letras → autocomplete mostra clientes
- Click no nome → cliente selecionado
Cliente novo:
- Se não achar no autocomplete, opção "Criar novo cliente" aparece
- Preenche nome + telefone na hora → cliente fica cadastrado e selecionado
⚠️ Toda cobrança vincula a um cliente (cadastrado ou criado na hora). Não há fluxo "cobrança avulsa sem vínculo".
5. Confirmar
✓ Maria Silva
✓ R$ 80,00
[ Continuar → ]
Click avança pra forma de pagamento.
6. Forma de pagamento
Como vai pagar?
[ 💚 Pix ]
[ 💳 Cartão crédito ]
[ 💳 Cartão débito ]
[ 🔁 Assinatura recorrente ]
[ 💵 Dinheiro (registrar manualmente) ]
A opção Assinatura recorrente abre tela extra pra escolher ciclo (semanal, mensal, trimestral, anual). Cobra o cartão do cliente automaticamente no vencimento de cada ciclo. Útil pra mensalidade fixa de serviço continuado.
A — Pix
Click "Pix". Sistema gera QR Code em tempo real via Asaas (~1-2s).
Tela do QR aparece em fullscreen — você gira o celular pra mostrar pro cliente:
💚 Aponta a câmera
[QR CODE GIGANTE]
ou copia chave: 00020126...
R$ 80,00 vencendo HOJE
Cliente abre app do banco, escaneia, paga.
Sistema faz polling no Asaas a cada 3s — quando confirma, muda automaticamente pra recibo (✓ verde).
B — Cartão (crédito/débito)
Click "Cartão crédito" ou "Cartão débito".
Asaas abre checkout embed (modal sobre o app).
Você passa o celular pro cliente, ele preenche dados do cartão (número, validade, CVV, nome).
Crédito: se você configurou max parcelas > 1, cliente vê opção de parcelar (1-12x sem juros pra ele).
Cliente confirma. Asaas processa, retorna sucesso/erro em ~5-15s.
Sucesso → tela vira recibo (✓ verde) automaticamente.
C — Dinheiro
Click "Dinheiro".
Sistema assume que cliente pagou (você é responsável por receber/conferir).
Vai direto pra recibo (✓ verde). Sem polling, sem checkout.
⚠️ Dinheiro vai pra /cobrancas com status pago direto. Assaas não envolvido. Nem split TMB de 1% (TMB não recebe nada de cobrança em dinheiro).
7. Recibo
✓
Recebido R$ 80,00
Maria Silva — Pix
05 maio 14:32
[ Enviar pro cliente via WhatsApp ]
[ Cobrar próximo ]
[ Voltar pra Agenda ]
Cliente recebe mensagem WhatsApp confirmando se você clicar "Enviar pro cliente":
"Recebido! R$ 80,00 pelo seu atendimento no Studio Bella 💚 Obrigado, Maria!"
Click "Cobrar próximo" volta pra tela inicial pra próxima cobrança (útil em fluxo contínuo).
Tempo total esperado
- Pix: ~30 segundos do "valor digitado" ao "recibo"
- Cartão débito: ~1-1.5 minuto
- Cartão crédito 1x: ~1-1.5 minuto
- Cartão crédito parcelado: +30s (cliente pensa quantas parcelas)
- Dinheiro: ~10 segundos
Cancelar a cobrança no meio
Em qualquer tela antes do recibo, botão voltar descarta o fluxo. Nada cobrado, nada salvo.
Após recibo, se quer cancelar:
- Pix: cobrança continua existindo no Asaas — você cancela manualmente em
/cobrancas → click → Cancelar - Cartão: pra estornar, faz pelo painel Asaas (Kontato não tem botão de estorno)
- Dinheiro: edita o registro em
/cobrancas→ Excluir