Integração Asaas para cobranças imobiliárias
Na integração prevista para a eencia, o corretor utiliza a própria conta Asaas para processar cobranças. O SaaS organiza a operação e se comunica com o provedor, sem transformar a mensalidade da plataforma em destino dos aluguéis administrados.
A conta Asaas é do administrador
Antes de conectar, confira titularidade da conta, ambiente utilizado e recursos habilitados. Credenciais de teste e produção não são intercambiáveis. Acesso à API deve ser fornecido pelo mecanismo autorizado, sem compartilhar a senha pessoal de entrada na conta.
O que a API oferece e o que o SaaS organiza
A documentação do Asaas contempla fluxos de cobrança para boleto, Pix e cartão, com cadastros e estados próprios. O sistema imobiliário precisa relacionar essas transações às pessoas, imóveis e competências da carteira. [ASAAS_GUIDE]
Essa relação não surge automaticamente do nome do pagador. Uma pessoa pode pagar vários imóveis ou realizar uma transferência em nome de outra. A integração deve preservar identificadores e a conta recebedora, permitindo localizar a operação correta.
Conferência antes da primeira cobrança
Valide a conexão e a identificação da conta. Depois, confira cadastro do pagador, composição da cobrança, vencimento e meios disponíveis. A página ou link retornado precisa corresponder à transação emitida, e a comunicação deve apresentar o mesmo valor.
Um cenário de teste útil inclui emissão, consulta, confirmação e tratamento de uma falha. Um botão “conectado” sem transação verificável não demonstra que o fluxo financeiro inteiro está funcionando. A homologação real exige evidências no ambiente correspondente, não apenas respostas simuladas.
Recebimento e conciliação
Os eventos do provedor devem atualizar a cobrança certa e ser tratados de forma idempotente: receber duas notificações sobre o mesmo fato não pode duplicar a receita. Também é necessário consultar periodicamente situações que ficaram sem atualização.
No exemplo de um aluguel de R$ 2.500,00, o relatório deve distinguir o bruto, as tarifas efetivas e o saldo disponível. Uma despesa do provedor não deve virar automaticamente taxa adicional do inquilino nem ser descontada do proprietário sem base definida.
Limites de responsabilidade
A integração não significa que a eencia seja o Asaas, uma instituição financeira ou uma conta de custódia. O cadastro e as condições do provedor continuam aplicáveis. Repasse manual registrado no SaaS também não equivale a transferência automática executada pelo gateway.
A seleção do Asaas deve considerar a conta concreta e as necessidades da carteira, sem promessa de aprovação, tarifa ou prazo universal. O objetivo desta página é explicar o fluxo e os critérios de conferência, não apresentar uma parceria comercial ou certificação que não foi comprovada.
Perguntas frequentes
Conectar Asaas exige fornecer a senha pessoal ao SaaS?
Não. Utilize credenciais ou autorização de integração apropriadas, com proteção e possibilidade de revogação.
Receber um webhook duas vezes deve gerar dois recebimentos?
Não. O processamento precisa reconhecer o mesmo evento ou transação e evitar duplicidade.
Continue a leitura
- Sistema para cobrar aluguel pelo gateway do corretor
- Como gerar cobrança de aluguel online
- Como conectar gateway próprio em SaaS de aluguéis
- Segurança ao conectar API de gateway de pagamento