Sistema para cobrar aluguel pelo gateway do corretor

Cobrar pelo gateway do corretor significa criar operações vinculadas à conta de pagamento que ele conectou ao sistema. Esse modelo não é o mesmo que concentrar todos os recebimentos na conta do fornecedor do SaaS. Antes de ativar qualquer cobrança, confira titularidade, ambiente e destino de recebimento. Uma chave válida prova comunicação com a API, mas não substitui a conferência da conta que efetivamente receberá os valores.

Quem recebe o dinheiro precisa estar identificado

O pagador deve identificar o beneficiário e a obrigação no fluxo de pagamento. O corretor precisa conservar o identificador da transação junto do contrato e do imóvel. Esse vínculo é mais importante do que o método utilizado: Pix, cartão e boleto podem gerar eventos e prazos diferentes, mas todos devem corresponder à obrigação correta.

Conexão não é divisão automática do dinheiro

Receber um aluguel na conta conectada não significa que o proprietário já recebeu seu repasse. O sistema pode calcular a taxa e o saldo devido sem executar uma transferência. Split, transferência bancária e registro manual são operações diferentes; a interface e o demonstrativo devem refletir o que realmente ocorreu.

A proposta da eencia inclui Asaas, Mercado Pago, iugu e Pagar.me no mesmo escopo de integração. Isso não significa que toda conta tenha os mesmos métodos ou condições habilitados. A implementação deve consultar as capacidades disponíveis e o usuário deve observar os termos do provedor. Não é adequado prometer aceitação de qualquer cobrança apenas porque uma API existe.

Roteiro de ativação sem misturar contas

Identifique o provedor, gere a credencial apropriada, guarde-a somente no ambiente seguro do sistema e execute um teste no ambiente correspondente. Em seguida, configure a recepção de eventos e vincule a conexão à empresa correta. O mesmo pagador pode ter identificadores diferentes em provedores distintos; não reutilize um código externo fora da conexão que o criou.

Confira também a desconexão. Revogar uma credencial não apaga o histórico financeiro e não prova que títulos antigos foram cancelados. Antes de trocar de gateway, consulte cobranças abertas, assinaturas recorrentes e possíveis recebimentos tardios. A continuidade da conciliação precisa ser planejada para não abandonar pagamentos ainda vinculados ao provedor anterior.

Exemplo de teste de titularidade

Um corretor administra duas empresas e conecta, por engano, a conta da empresa B no ambiente da A. Uma cobrança de teste pode ser criada normalmente, embora o dinheiro siga para o destinatário errado. Por isso, mostre a identificação da conta conectada antes da ativação e confira a operação de ponta a ponta. A validação técnica sem essa conferência é insuficiente.

Perguntas frequentes

Preciso entregar minha senha do gateway?

Não é o modelo adequado. Use a credencial de integração ou autorização suportada pelo provedor, com guarda segura e possibilidade de revogação.

O proprietário recebe automaticamente?

Somente se houver uma operação de transferência ou divisão efetivamente implementada e autorizada. No fluxo de repasse manual, o sistema calcula e registra; o corretor realiza a transferência.