Este artigo é sobre o cartão do DONO que paga a mensalidade Kontato — não cobrança do cliente final pagando você. Pra cobrança do cliente que não confirma, ver Cobrança não confirma.
O que aconteceu
A cobrança automática da sua mensalidade Kontato falhou. Sequência:
- Dia 1 do mês: cron
billinggera sua fatura do mês anterior - Dia 2 do mês: cron tenta cobrar via cartão tokenizado
- Cartão recusou: Asaas retorna falha
dunning_inicioé setado pro seu negócio- Banner aparece no app: "Regularize seu pagamento"
- 15 dias depois, sem regularizar, status vira
bloqueado
Diagnóstico — qual o motivo?
A Kontato não exibe motivo detalhado da recusa (limitação atual). Mas você pode investigar:
1. Email do Asaas
Asaas envia automaticamente email pra conta do dono explicando o motivo:
- "Cartão recusado: limite insuficiente"
- "Cartão expirado"
- "Antifraude bloqueou a transação"
Verifica caixa de entrada (e spam).
2. Painel Asaas direto
Se você tem acesso ao Asaas (https://www.asaas.com), busca a cobrança pelo valor + data. Detalhes da tentativa aparecem com mensagem do banco.
3. Banco emissor
Pode ligar pro banco do cartão pra confirmar:
- "Houve uma transação Asaas no dia X recusada — qual foi o motivo?"
- Comum: antifraude bloqueia transações recorrentes em dia diferente do habitual
Causas mais comuns
| Causa | Fix |
|---|---|
| Limite/saldo insuficiente | Pagar fatura anterior do cartão ou trocar pra outro |
| Cartão expirado | Trocar em /cobrancas/cartao (data de validade nova) |
| Cartão cancelado/perdido | Trocar em /cobrancas/cartao |
| Antifraude | Liberar com seu banco emissor (ligar) ou trocar de cartão |
| Banco bloqueou recorrência | Habilitar "compras online" + recorrência no app do banco |
Como resolver — trocar cartão
Acesse: Menu lateral → Cobranças → Trocar cartão (ou direto /cobrancas/cartao).
- Preenche dados do novo cartão (nome, número, validade, CVV, CPF, CEP)
- Salva → Asaas tokeniza
- Sistema automaticamente:
- Limpa
dunning_inicio - Status volta a
ativo - Próxima cobrança no dia 2 usa o cartão novo
- Limpa
Você não precisa "pagar agora" manualmente. O sistema tenta de novo no próximo ciclo. Se quiser pagar imediatamente pra parar o banner antes, há botão "Pagar agora" na página
/cobrancas.
A janela de 15 dias
Conte a partir do dia que o banner apareceu. Antes dos 15 dias:
| Dia | Estado | O que acontece |
|---|---|---|
| 0 (recusou) | dunning_inicio setado | Banner aparece |
| 1-14 | Em dunning | Banner persiste, app funciona normal |
| 15 | status: bloqueado | App entra em modo bloqueado |
Se você cadastra cartão novo entre dia 1 e dia 14, dunning é cancelado e tudo volta ao normal.
O que acontece quando status='bloqueado'?
Ao chegar em 15 dias sem regularizar, status do negócio muda pra bloqueado. A página /cobrancas detecta e mostra UI específica.
Comportamento exato pode variar conforme versão. Em geral: app continua acessível pro dono regularizar (não derruba sessão), mas funcionalidades operacionais (bot WhatsApp, agenda, cobranças) podem ficar restritas até desbloqueio.
Pra desbloquear: cadastrar/trocar cartão em /cobrancas/cartao. Sistema:
- Limpa
dunning_inicio - Volta status pra
ativo - Banner some
- Próxima cobrança roda no próximo ciclo
Limitações conhecidas
Sem retry imediato
Se você cadastra cartão novo no dia 5 do dunning, o sistema não tenta cobrar imediatamente — espera o próximo cron diário (03:00 BRT). Pra forçar cobrança imediata, use botão "Pagar agora" na página /cobrancas (se aparecer).
Sem múltiplos cartões fallback
1 cartão por negócio. Se ele falhar, não tem cartão B automaticamente. Você precisa trocar manualmente.
Sem mensagem detalhada do motivo
A Kontato hoje não relaciona o código de erro do Asaas/banco com mensagem específica no banner. Você vê só "Regularize seu pagamento" — sem dizer "limite insuficiente".
Roadmap futuro pode incluir mensagem detalhada. Por enquanto, email Asaas é a fonte mais rica.
Edge cases
Trocar cartão durante o trial
Trial não cobra ainda — você pode cadastrar/trocar cartão a qualquer momento sem urgência. Útil pra deixar pronto pra primeira cobrança real.
Cartão certo mas Asaas mostrou recusa
Raro. Pode ser:
- Glitch temporário do banco — tenta de novo no próximo dia ou força via "Pagar agora"
- Antifraude muito agressivo — liberar com seu banco
Banner some mas você não pagou
Se status virou bloqueado (15 dias), banner pode ter mudado pra UI de bloqueio. Não significa que problema sumiu — verifica /cobrancas.
Conta em modo trial e cartão "futuro"
Se você cadastrou cartão antes do trial acabar e ele não funciona quando o trial vira ativo, mesma sequência de dunning.
Negócio cancelado vs bloqueado
- Bloqueado (
status='bloqueado') = falha de pagamento, reversível ao trocar cartão - Cancelado (
status='cancelado') = você cancelou ativamente em/configuracoes/conta. Reversível mas envolve reativação manual
Antes de perder a paciência
Se você jura que o cartão está OK e mesmo assim continua recusando:
- Ligar pro banco emissor — antifraude pode estar bloqueando recorrência. 5min resolvem
- Tentar outro cartão — verifica se é problema do cartão original ou do Asaas
- Email do Asaas — geralmente tem o motivo exato
Se nada disso resolveu: ticket pelo botão "?" (Kira) com:
- Email da sua conta Kontato
- Data aproximada da recusa
- O que você já tentou
Suporte consulta o erro real do Asaas direto.
Próximos artigos
- Cobrança não confirma — cobrança do cliente final pagando você
- App lento — outros problemas operacionais
- Login não funciona — acesso à conta