Como conectar gateway próprio em SaaS de aluguéis
O modelo de gateway próprio permite que o administrador utilize sua conta financeira no SaaS. A plataforma recebe uma autorização de integração, não a senha pessoal de acesso ao banco ou ao provedor. A forma concreta pode ser token de API ou fluxo de autorização suportado pelo serviço.
Conectar é autorizar operações em uma conta
A eencia foi definida com Asaas, Mercado Pago, iugu e Pagar.me no mesmo escopo. Isso não significa que uma única credencial funcione para todos nem que cada conta já esteja habilitada para todos os meios. A conexão precisa identificar provedor, ambiente e titularidade.
Conferência antes de salvar
Verifique a conta que será vinculada, as permissões concedidas e o ambiente. Uma credencial de testes deve permanecer claramente separada da produção. O sistema precisa proteger o segredo no servidor e impedir sua exposição em páginas, logs ou respostas de API.
O teste de conexão deve confirmar informações suficientes para evitar vincular a conta errada, sem mostrar dados sensíveis desnecessários. Uma mensagem genérica de sucesso não substitui identificação do recebedor e dos recursos disponíveis.
Isolamento entre administradores
Cada conexão pertence à empresa correspondente. A consulta de uma cobrança deve usar a credencial dessa empresa, não um token global de outro corretor. A autorização deve ser verificada no servidor em cada operação relevante. Esse cuidado corresponde ao problema de controle de acesso por objeto destacado pela OWASP. [OWASP]
No exemplo de duas imobiliárias com um cliente de mesmo nome, as transações continuam separadas por empresa, conta e identificador. Coincidência de nome ou valor não autoriza cruzamento de dados.
Troca de gateway não move o passado automaticamente
Ao escolher outro provedor para novas cobranças, preserve o vínculo das antigas com a conta em que foram emitidas. Pagamentos, estornos e consultas posteriores podem continuar chegando pelo provedor anterior. Desconectar sem planejar esse acompanhamento deixa operações sem conciliação.
Defina uma data de corte e identifique agendas futuras. Não reemita todas as cobranças pendentes no novo gateway antes de tratar os instrumentos antigos. Uma migração financeira exige evitar dupla quitação e manter rastreabilidade.
Revogação e segurança
Se houver exposição de credencial, revogue ou rotacione pelo procedimento do provedor e atualize a integração de forma controlada. Não envie tokens em conversa de suporte. Registre a ocorrência e confira operações pertinentes.
A vantagem do modelo não está em dispensar controles, mas em separar os recebimentos de cada cliente da conta comercial do SaaS. A conta da plataforma cobra sua assinatura; a conta do administrador processa suas operações autorizadas. Essa distinção deve ser visível no cadastro, nos testes e nos relatórios.
Perguntas frequentes
Posso usar a mesma chave para duas empresas diferentes?
Não como atalho para misturar operações. Cada vínculo precisa corresponder à conta e à empresa autorizadas, com isolamento efetivo.
Trocar o gateway muda automaticamente boletos já emitidos?
Não. Os instrumentos antigos permanecem ligados ao provedor original e precisam de acompanhamento ou substituição controlada.
Continue a leitura
- Integração Asaas para cobranças imobiliárias
- Integração Mercado Pago para aluguel e comissões
- Integração iugu para cobrança recorrente
- Integração Pagar.me com Pix, boleto e cartão
- Segurança ao conectar API de gateway de pagamento