Integração Pagar.me com Pix, boleto e cartão

Pagar.me pode processar a transação enquanto a eencia mantém pessoas, imóvel, contrato e categoria. A relação entre esses registros precisa existir antes da emissão. Um pedido financeiro sem referência à competência dificulta a conciliação quando há vários pagamentos do mesmo cliente.

O checkout é uma etapa do fluxo, não o cadastro da locação

O administrador conecta sua conta autorizada, e a integração deve conferir ambiente, recebedor e recursos disponíveis. A mensalidade da eencia e os aluguéis administrados são operações diferentes e não devem compartilhar credenciais por conveniência.

Link de pagamento e métodos

A documentação de checkout link contempla criação de pedido ou recorrência e configurações para cartão, boleto e Pix. No fluxo de recorrência por link, a documentação estabelece vínculo com plano. Não generalize essa estrutura como se qualquer tipo de link criasse automaticamente uma agenda imobiliária completa. ^{[PAGARME_LINK]}

A implementação deve escolher o fluxo compatível com a obrigação. Uma cobrança pontual de comissão não precisa virar assinatura; um aluguel mensal não deve ser duplicado por um plano externo e uma agenda local simultâneos.

Objeto interno e transações externas

Guarde identificadores de pedido, cobrança e eventos correspondentes conforme os recursos utilizados. Tentativas, autorização, confirmação e estorno precisam continuar ligados à mesma obrigação. O valor final dos relatórios deve resultar dos fatos financeiros, não da quantidade de eventos recebidos.

Exemplo: uma cobrança de R$ 1.500,00 recebe uma tentativa de cartão recusada e depois é paga por Pix no fluxo permitido. O sistema deve reconhecer o resultado real e tratar os instrumentos pendentes, sem registrar dois valores devidos ao proprietário.

Webhooks e conferência

Os eventos de webhook disponíveis no Pagar.me têm significados próprios. A integração precisa validar e processar os eventos relevantes, com consulta ao provedor quando houver dúvida, e não confiar em uma mensagem enviada pelo navegador do pagador. ^{[PAGARME_EVENTS]}

Reenvios de eventos não podem duplicar a baixa. Eventos atrasados também não devem sobrescrever um estado mais recente sem análise. A trilha deve mostrar a sequência efetiva e permitir reconciliação com o painel financeiro.

Uso na carteira administrada

Antes de oferecer o meio ao cliente, valide a conta e o caminho de pagamento. Depois, confira tarifas, liquidação e disponibilidade conforme as condições reais. Um repasse manual registrado no sistema só deve ser marcado como realizado após a transferência efetiva e o registro do comprovante.

Ao avaliar essa integração na eencia, confirme essas relações sem presumir parceria comercial, certificação ou tarifa universal. O valor do software está em organizar a cobrança imobiliária e a prestação de contas sobre o processamento do provedor, não em substituir suas condições operacionais.

Perguntas frequentes

Qualquer link Pagar.me cria uma recorrência?

Não. O tipo e a configuração do link importam; a documentação estabelece requisitos próprios para recorrência vinculada a plano.

Uma notificação repetida pode duplicar a receita?

Não deve. O processamento precisa reconhecer o evento e a transação já registrados.