Checkout, baixa e integrações

Pasta /pagamentos do BarberBot

Esta página reescreve a documentação de pagamentos com base na estrutura real do projeto. O foco não é só Mercado Pago: aqui entram também conta a receber, assinatura, baixa financeira, mensageria auxiliar e o ponto de entrada assíncrono do webhook.

Checkout Conta a receber Webhook Mensageria

17

Arquivos PHP em /pagamentos

1 bloco assets

Subpastas em /pagamentos

4

Fluxos principais mapeados

0

Lacunas no recorte /pagamentos

Como enxergar a pasta /pagamentos

O recorte mistura páginas públicas, endpoints JSON, helpers e callbacks externos. Para manutenção, o dev deve separar mentalmente entrada do usuário, processamento do checkout, baixa/efeitos financeiros e integrações auxiliares.

Entradas públicas

index.php, pagar.php e receber.php recebem parâmetros da URL e decidem o tipo de cobrança.

Processamento

Os arquivos process_payment*.php respondem em JSON e conversam com a API de pagamento.

Consolidação

pagamento_aprovado.php e baixar_conta.php refletem o pagamento em agendamentos, receber, caixas e comissão.

Entradas e páginas públicas de pagamento

Arquivos que recebem o usuário final e decidem se o fluxo vai para Mercado Pago, Asaas, assinatura ou baixa direta.

pagamentos/index.php Entrada principal de pagamento de agendamento. Decide redirecionamento, consulta agendamentos_temp e monta a página do checkout. Parâmetros: id_conta, total • Tabelas: agendamentos_temp, clientes, servicos • Uso: checkout de agendamento.
pagamentos/pagar.php Entrada de assinatura/plano. Consulta assinaturas e itens_assinaturas e pode redirecionar para Asaas. Parâmetros: id_conta • Tabelas: assinaturas, itens_assinaturas, clientes • Uso: checkout de assinatura.
pagamentos/receber.php Entrada de conta a receber avulsa; consulta receber, cliente e renderiza a cobrança. Parâmetros: id_conta • Tabelas: receber, clientes • Uso: cobrança de conta a receber.

Processamento Mercado Pago / checkout

Endpoints que criam ou consolidam pagamentos aprovados, pendentes ou rejeitados.

pagamentos/process_payment.php Checkout de agendamento temporário com retorno JSON. Parâmetros: acc, id, id_conta • Tabelas: agendamentos_temp • Extras: JSON • cURL.
pagamentos/process_payment2.php Variação do processamento com baixa em receber. Parâmetros: acc, id, id_conta • Tabelas: agendamentos_temp, receber • Extras: JSON • cURL.
pagamentos/process_payment_assinatura.php Fluxo de pagamento de assinatura/plano. Parâmetros: acc, id, id_conta • Tabelas: assinaturas, receber • Extras: JSON • cURL.
pagamentos/process_payment_conta.php Fluxo de pagamento de conta a receber. Parâmetros: acc, id, id_conta • Tabelas: receber • Extras: JSON • cURL.
pagamentos/confirmacao.php Confirmação de envio/mensagem após ações de pagamento. Extras: JSON • cURL • Uso: confirma/agrega envio de mensagens pós-pagamento/agendamento.

Consulta, baixa e confirmação

Arquivos responsáveis por consultar status, marcar pagamento e refletir isso no financeiro/agendamento.

pagamentos/consultar_pagamento.php Consulta status do pagamento no Mercado Pago usando ref_pix. Extras: JSON • cURL • Uso: consulta Mercado Pago via ref_pix.
pagamentos/pagamento_aprovado.php Consolida o agendamento e cria receber/comissão após aprovação. Parâmetros: id_agd • Tabelas: agendamentos_temp, agendamentos, receber, horarios_agd, clientes, servicos • Uso: consolidação final.
pagamentos/baixar_conta.php Efetiva baixa financeira em receber e caixas e remove agendamento pendente quando aplicável. Sessão: id • Tabelas: receber, caixas, clientes • Uso: baixa financeira pós-pagamento.
pagamentos/webhook.php Entrada assíncrona do Mercado Pago para topic/type + id, consultando status remoto. Parâmetros: topic, type, id • Tabelas: receber • Extras: JSON • cURL • Uso: webhook Mercado Pago.

Conectores e auxiliares

Arquivos auxiliares de tokens, configuração e mensageria usados pelos fluxos principais.

pagamentos/config.php Carrega credenciais/tokens e define flags do checkout. Uso: carrega conexão, tokens e flags do checkout; contém decisões de produção/teste.
pagamentos/tokens.php Mapeia tokens públicos/privados a partir da configuração do sistema. Uso: espelha access_token_mp/public_key_mp em variáveis locais.
pagamentos/api-agendar.php Agenda mensagem no provedor externo. Extras: JSON • cURL • Uso: agendar mensagem de WhatsApp/Menuia/EnviaMe.
pagamentos/api-texto.php Envia texto simples no provedor externo. Extras: JSON • cURL • Uso: envio simples de texto.
pagamentos/agendar-delete.php Cancela mensagem agendada no provedor externo. Extras: JSON • cURL • Uso: cancelar agendamento de mensagem externa.

Fluxos principais que o dev precisa decorar

Estes são os caminhos reais de execução mais importantes da pasta.

  • Agendamento online: index.php → process_payment.php/process_payment2.php → pagamento_aprovado.php
  • Assinatura/plano: pagar.php → process_payment_assinatura.php → receber
  • Conta a receber: receber.php → process_payment_conta.php → baixar_conta.php
  • Webhook assíncrono: webhook.php → consulta Mercado Pago → atualização em receber

Pontos críticos de manutenção

Onde mudanças pequenas costumam quebrar efeitos grandes.

  • config.php e tokens.php concentram credenciais e flags de operação; qualquer mudança nessa camada impacta todos os fluxos.
  • pagamento_aprovado.php mistura consolidação de agendamento, financeiro e notificação; é um dos arquivos mais sensíveis do recorte.
  • baixar_conta.php depende de sessão e pode chamar agendar-delete.php; mexer nele afeta financeiro e cancelamento de mensagens.
  • index.php, pagar.php e receber.php redirecionam para Asaas quando configurado; por isso o fluxo real também toca /asaas e /asaas_contas.

Relações com outras áreas

A pasta /pagamentos não vive sozinha; ela se conecta com financeiro, agendamento e integrações externas.

index.php
→ agendamentos_temp
→ checkout / redirecionamento
→ process_payment*.php
receber.php
→ receber + clientes
→ cobrança pública
→ process_payment_conta.php
pagamento_aprovado.php
→ agendamentos_temp → agendamentos
→ receber, horarios_agd, comissão
webhook.php
→ Mercado Pago
→ consulta remota
→ atualização de receber e efeitos derivados
Abrir cobertura conjunta de /cron + /pagamentos