Integração Mercado Pago para aluguel e comissões

Mercado Pago pode integrar o processamento financeiro, enquanto o sistema de administração mantém contrato, competência e categoria. A cobrança de aluguel e a comissão não devem se tornar indistinguíveis apenas porque o mesmo cliente paga ambas.

Uma cobrança imobiliária precisa de referência própria

Na conexão prevista para a eencia, cada administrador utiliza sua conta autorizada. O recebedor deve ser identificado e os ambientes de teste e produção precisam ficar separados. Nunca use credenciais de uma empresa para consultar pagamentos de outra.

Pedido, pagamento e cliente não são sinônimos

A documentação do Mercado Pago apresenta diferentes recursos de checkout e APIs, inclusive estruturas de pedidos e pagamentos. A integração precisa seguir a versão e o produto escolhidos, sem misturar exemplos antigos com operações atuais. ^{[MP_OVERVIEW]}

Para o corretor, o resultado esperado é simples: uma obrigação interna ligada às referências externas correspondentes. Se houver tentativa recusada e nova tentativa aprovada, o histórico deve mostrar as transações sem registrar dois aluguéis recebidos.

Meios de pagamento e checkout

Confirme quais métodos estão disponíveis para a conta e a integração utilizadas. A escolha entre checkout hospedado e experiência integrada afeta a implementação e o tratamento de dados, mas não deve alterar o valor ou a descrição da obrigação sem aviso.

A página de retorno após o pagamento não é prova suficiente de quitação. O estado precisa ser consultado ou confirmado pelos eventos legítimos do provedor. Um visitante não pode marcar uma cobrança como paga apenas acessando a URL de sucesso.

Notificações e segurança

Configure notificações conforme a documentação da integração escolhida e valide sua autenticidade. Eventos precisam ser associados à conta correta e consultados quando necessário. Uma chamada recebida na API com texto “aprovado” não deve ser aceita sem verificação. ^{[MP_NOTIFICATIONS]}

No exemplo de uma comissão de R$ 900,00, uma tentativa recusada seguida de pagamento aprovado representa uma obrigação quitada, não receita de R$ 1.800,00. Estornos posteriores também precisam retornar ao mesmo histórico para corrigir o saldo de forma rastreável.

Prestação de contas e disponibilidade

Diferencie valor pago pelo cliente, taxas da conta e dinheiro disponível para movimentação. As condições efetivas dependem do serviço contratado e do estado da operação. Não prometa repasse ao proprietário em uma data que não considera essa disponibilidade.

A eencia foi estruturada para conectar a informação financeira ao imóvel e ao cliente. Esta integração deve permitir ao administrador explicar a origem de cada entrada, sem centralizar os recebimentos na conta da plataforma nem anunciar vínculo oficial com o provedor que não exista.

Perguntas frequentes

Voltar à página de sucesso confirma o pagamento?

Não por si só. A confirmação deve ser obtida de forma confiável junto ao provedor.

Duas tentativas de cartão são dois aluguéis?

Não. Tentativas pertencem ao histórico da obrigação; apenas os eventos financeiros efetivos devem compor os recebimentos.