💳

Módulo de Pagamentos – BaberBeBot

Controle completo de cobranças, confirmações e auditoria de pagamentos de planos e serviços.

Este módulo gerencia os fluxos de cobrança, confirmação e controle de pagamentos associados a planos e serviços contratados dentro do sistema.

📁 Arquivos Relacionados

pagamentos/consultar_pagamento.php – Consulta o status de pagamento no gateway
pagamentos/pagamento_aprovado.php – Callback após confirmação de pagamento
pagamentos/process_payment_assinatura.php – Geração de requisição de pagamento
ajax/consultar_pagamento.php – Consulta dinâmica via Ajax

🔁 Fluxo de Pagamento

Usuário seleciona um plano/serviço com custo
O sistema chama process_payment_assinatura.php, que gera uma requisição de pagamento
Usuário é redirecionado ao gateway (ex: Mercado Pago)
Ao pagar, o gateway envia um retorno para pagamento_aprovado.php
Este arquivo atualiza o status da assinatura para ATIVO no banco de dados
O script consultar_pagamento.php pode ser utilizado para verificar manualmente o status

🧾 Estrutura Esperada no Banco

As informações de pagamento são armazenadas associadas ao ID do cliente e ID do plano. Campos recomendados:

id_assinatura, valor, status_pagamento, data_pagamento

🔐 Segurança

Confirmação de pagamento validada com hash de autenticação ou token seguro
Verificações no retorno do gateway (status = aprovado, valor conferido, etc.)
Pagamentos devem ser registrados via transação (PDO + beginTransaction())

📈 Logs e Auditoria

Recomenda-se manter log de todos os pagamentos com:

Referência externa (ID do gateway)
Status completo (pendente, aprovado, cancelado)
Responsável pela mudança (cliente/sistema)