Consulta Manual de Pagamentos
O Sistema oferece a funcionalidade de consulta manual de pagamentos como uma medida de contingência para situações em que ocorrem instabilidades na comunicação com a API do gateway de pagamento. Essa rotina permite que os pagamentos realizados pelos clientes sejam devidamente identificados e registrados no Sistema mesmo quando o recebimento automático — executado pelas tarefas de rotina — falha ou não é processado no tempo esperado. Com isso, a integridade das informações financeiras é preservada e os títulos são atualizados com os status corretos sem necessidade de intervenção manual registro a registro.
Processo de Consulta Manual
A execução da consulta manual de pagamentos segue uma sequência estruturada, que envolve tanto a análise da situação quanto a operação da rotina no Sistema. As etapas estão descritas a seguir.
1. Identificação da Instabilidade
A equipe de suporte identifica falhas ou comportamentos inesperados na comunicação com a API do gateway de pagamento. Isso pode se manifestar como títulos que permanecem em aberto no Sistema mesmo após o pagamento confirmado pelo cliente, ausência de retorno da API nas tarefas automáticas ou inconsistências entre o extrato do gateway e os registros no Sistema.
2. Análise da Situação
É realizada uma análise técnica para determinar a origem e o impacto da falha no processo de recebimento. Nessa etapa, os logs de comunicação disponíveis na aba Logs consulta de pagamentos podem ser consultados para verificar os endpoints acessados, os status HTTP retornados e o conteúdo das respostas recebidas da API, auxiliando no diagnóstico preciso do problema.
3. Confirmação da Necessidade
Com base na análise, a equipe de suporte avalia se a execução da rotina manual é necessária e autoriza o procedimento. A consulta manual deve ser utilizada como medida pontual de contingência, e não como substituta do processo automático.
4. Execução da Rotina
A rotina de consulta manual é executada por usuário autorizado no Sistema, mediante autenticação por senha. O processo força a verificação dos pagamentos junto ao gateway para o período definido nos filtros, consultando as transações registradas na instituição financeira ou gateway e comparando com os títulos presentes no Sistema.
5. Verificação dos Pagamentos
O Sistema realiza a checagem dos pagamentos junto ao gateway dentro do intervalo de datas estabelecido nos filtros da consulta. Os resultados retornados pela API são processados e analisados para identificar quais transações foram efetivadas e ainda não estão refletidas nos registros do Sistema.
6. Atualização dos Registros
Os pagamentos identificados são registrados no Sistema e os títulos correspondentes são atualizados com os respectivos status. Essa atualização garante que cobranças efetivadas pelo cliente sejam baixadas corretamente, evitando bloqueios indevidos e divergências no controle financeiro.
Importância da Consulta Manual
A rotina de consulta manual é essencial para manter a operação financeira íntegra em situações excepcionais. Seus principais benefícios são:
Garantir a continuidade do serviço
- Sem a atualização dos pagamentos no Sistema, títulos quitados pelo cliente podem permanecer como pendentes, gerando cobranças indevidas, bloqueios de acesso ou notificações de inadimplência para clientes que já realizaram o pagamento. A consulta manual evita esse cenário ao forçar a sincronização com o gateway quando o processo automático não ocorre.
Assegurar a precisão dos dados financeiros
- A rotina elimina discrepâncias entre as informações registradas no gateway e os dados do Sistema, garantindo que os lançamentos financeiros reflitam com fidelidade as transações efetivamente realizadas. Isso é especialmente relevante para a conferência de movimentações, relatórios de fluxo de caixa e conciliação bancária.
Preservar a experiência do cliente
- A atualização tempestiva dos recebimentos impede que clientes sofram impactos operacionais — como bloqueios de acesso ao serviço de internet — decorrentes de falhas de integração que não foram originadas por inadimplência real. Isso protege a relação com o cliente e reduz acionamentos desnecessários ao suporte.
Restrições e Segurança
Para assegurar o uso responsável e controlado da rotina, as seguintes restrições são aplicadas:
Acesso restrito
- Somente usuários com permissão específica no Sistema podem acessar e executar a rotina de consulta manual. O controle de acesso evita execuções não autorizadas que possam comprometer a consistência dos dados financeiros.
Confirmação via senha
- A execução da rotina exige o preenchimento de uma senha de autenticação no campo correspondente do formulário. Essa etapa garante que o operador esteja ciente de que está iniciando um processo que impactará os registros financeiros do Sistema.
Procedimento controlado
- Toda execução deve seguir o protocolo padrão e, quando necessário, ser acompanhada pela equipe de suporte financeiro. Em caso de dúvidas sobre a carteira de cobrança a ser utilizada nos filtros ou sobre o escopo da consulta, o atendimento deve ser solicitado ao SAC - Suporte Financeiro antes de iniciar a rotina.
O Sistema armazena todos os logs de requisições e respostas trafegados com as APIs das instituições financeiras e gateways, seja durante uma consulta manual pelo formulário ou por uma execução automática via tarefa de rotina.
Estes registros centralizam as informações de comunicação — como endpoints, cabeçalhos, status HTTP e o corpo da resposta —, o que simplifica e agiliza a análise técnica e o diagnóstico em casos de instabilidades ou falhas de compensação.
Para mais detalhes sobre os campos, regras e o uso desta funcionalidade, consulte a seção
Aba Logs consulta de pagamentosnos artigos:
Passo a Passo – Rotina de Consulta Manual
Executando a Consulta de Recebimento em Gateways/API
- Acesse o menu Configurações.
- Clique em Rotinas Financeiro.
- Vá para o submenu Rotinas Gateway.
- Selecione a aba Consultar Recebimento.
- Preencha os filtros disponíveis:
- Carteira de cobrança — informe a carteira associada ao gateway que será consultado. Em caso de dúvidas sobre qual carteira utilizar, entre em contato com o SAC - Suporte Financeiro.
- Data inicial — defina a data de início do período de consulta, considerando quando a instabilidade foi identificada ou quando os pagamentos não registrados foram realizados.
- Data final — defina a data de término do período de consulta.
- Senha — digite a senha da rotina para autenticação e autorização da execução.
- Clique em Consultar Recebimentos.
- Clique em Executar para iniciar a rotina.
- Aguarde o retorno da consulta com o status da operação e verifique se os títulos foram atualizados conforme esperado.
Para obter auxílio na execução da rotina e tirar dúvidas sobre carteiras específicas, entre em contato com o SAC - Suporte Financeiro.
Fluxo do Processo
Considerações Finais
A rotina de consulta manual de pagamentos é um recurso de contingência fundamental para situações em que a integração automática com o gateway apresenta instabilidades. Sua execução correta garante que os pagamentos realizados pelos clientes sejam devidamente registrados no Sistema, evitando falhas no controle financeiro, bloqueios indevidos e divergências nos relatórios.
Por se tratar de uma operação que impacta diretamente os registros financeiros, seu uso deve ser restrito a situações que realmente justifiquem a execução manual, sempre com acompanhamento da equipe de suporte e respeitando os protocolos de autenticação e autorização definidos. A consulta à aba Logs consulta de pagamentos antes e após a execução é recomendada para embasar o diagnóstico e confirmar que a operação foi concluída com sucesso.