A Asaas é a fintech parceira da Kontato pra cobranças. Você precisa ter conta lá (gratuita) e conectar a chave API uma vez. Depois é tudo automático.
Por que Asaas
Escolhemos Asaas pelos motivos:
- Conta gratuita, sem mensalidade
- API completa (Pix, cartão, recorrência)
- Suporte nacional, em português
- KYC aprovado em 24-48h (vs Mercado Pago que pode demorar mais)
- Compliance com regulação Bacen
Criar conta no Asaas
Se você ainda não tem:
Vai em asaas.com → Criar conta.
Preenche dados pessoais ou da empresa (CPF/CNPJ, endereço, telefone).
Envia documentos pra KYC (selfie + RG/CNH + comprovante de endereço).
Aguarda aprovação (normalmente 24-48h em dia útil).
Configura conta bancária pra receber transferências.
Sem KYC aprovado, você consegue até criar cobrança em sandbox mas não cobrar de cliente real.
Pegar a chave API
Já com conta aprovada:
Logado no painel Asaas, vai em Configurações → Integração → Chave API.
Click em "Gerar nova chave" (ou copia a existente).
Copia a chave inteira — começa com $aact_ e tem ~150 caracteres.
A chave é sua identidade fiscal
Quem tem a chave, opera na sua conta. Nunca compartilhe via email/print, e troque imediatamente se suspeitar de vazamento. Asaas permite gerar nova chave (e invalidar a antiga) com 1 click.
Conectar na Kontato
Em Configurações → Cobranças → Conectar Asaas.
Cola a chave API. Salva.
Kontato chama Asaas pra validar. Se OK, mostra "Conectado ✓ — conta de [seu nome]".
Pronto — cobranças disponíveis em /cobrancas. Configurações granulares de cartão (max parcelas) e Pix (vencimento default) ainda não estão expostas na UI — usa-se valores padrão do Asaas/Kontato.
Webhook automático
Pra Kontato saber quando seu cliente pagou (em tempo real, sem polling), o webhook é cadastrado automaticamente na sua conta Asaas no momento que você conecta a API key.
Você não precisa fazer nada manualmente. A Kontato chama a API Asaas em seu nome, lista webhooks existentes, remove os antigos e cadastra o novo apontando pro endpoint correto. Em ~2 segundos pós-conexão, está tudo pronto.
Confirmação: ao conectar a API key, se aparecer mensagem "Conectado!" sem aviso adicional = webhook foi cadastrado com sucesso. Se aparecer aviso "API key conectada mas webhook falhou" = sua API key não tem permissão de webhooks (raro). Reconecte ou peça suporte da Kira pra investigar.
Token por negócio (v0.28.5+): cada negócio Kontato tem um token único (UUID) salvo em
negocios.asaas_webhook_token. A URL cadastrada inclui esse token, garantindo que vazamento de credenciais isole o blast radius a 1 dono apenas (atacante que descobrir token do João não consegue forjar webhooks de outros).
Email pra alertas Asaas
No formulário de conexão você verá o campo "Email pra alertas Asaas" pré-preenchido com o email da sua conta Kontato. Esse email é usado pelo Asaas (não pela Kontato) pra te avisar quando o webhook entrar em modo de falha persistente — por exemplo, se nosso servidor cair e o Asaas ficar tentando notificar várias vezes seguidas sem resposta.
- Editável: você pode trocar pra outro email (ex: financeiro@suaempresa.com) se preferir receber alertas técnicos em endereço dedicado
- Notificações são raras: só quando há problema real persistente. Não é canal de marketing do Asaas
- Independente do email da conta Kontato: trocar aqui não afeta seu login na Kontato
Salva. Asaas começa a notificar a Kontato em tempo real.
Sandbox vs produção
Asaas oferece sandbox (chave começa com $aact_TEST_) pra testar sem cobrança real. Se você colar uma chave sandbox na Kontato, as cobranças vão pra ambiente de teste do Asaas — nada é cobrado de verdade. Útil pra explorar antes de "ir ao vivo".
Não há indicação visual na Kontato de qual ambiente está conectado: confira no painel Asaas se ficar em dúvida.
Multi-dono — chave compartilhada
Como a Kontato é multi-dono sem roles, todos os donos do negócio veem a chave Asaas e operam na mesma conta. Não tem como segregar "Maria só vê suas cobranças" — todo mundo vê tudo.
Se precisa segregação financeira, considere negócios separados (1 Asaas por dono).
Trocar de chave
Em qualquer momento você pode trocar a chave (ex: se gerou nova no Asaas, ou suspeita de vazamento). Em Configurações → Cobranças → Desconectar seguido de Conectar com a nova chave.
Cobranças antigas continuam vinculadas à chave anterior no Asaas, mas a Kontato só consegue operar com a chave atual.