Pular para o conteúdo principal

pagamentos-transacoes

Cenários de teste e debug - Pagamentos & Transações​

Escopo principal:

  • config/transacoes/*.php
  • config/transacoes/logs/*.log
  • config/graficos/dashboard/buscar_transacoes_*.php
  • dashboard/gestao/transacoes.php
  • Integrações: config/movingpay_tokens.php, config/entrepay/*.php

Checklist geral​

  • Criação de transação com sucesso (aprovada).
  • Transação recusada (motivo financeiro).
  • Transação recusada (motivo técnico/interno).
  • Transação pendente aguardando retorno de gateway.
  • Estorno/chargeback (se existir fluxo).
  • Cancelamento antes da captura.
  • Cancelamento depois da captura (se suportado).
  • Consulta de transações por:
    • Data
    • Estabelecimento
    • Status
  • Visualização de gráficos de transações no dashboard.

Fluxo: Criação de transação​

Pontos de entrada

  • APIs em config/transacoes/api_transacoes*.php (nomes exatos podem variar).
  • Telas de gestão em dashboard/gestao/transacoes.php.

Cenários

  1. Transação aprovada

    • Ação:
      • Criar transação com dados válidos, dentro dos limites de plano/taxas.
    • Expectativa:
      • Status final aprovado.
      • Registro persistido na base.
      • Aparição correta em relatórios/gráficos.
    • Logs sugeridos:
      • Módulo: PAGAMENTOS
        • CRIACAO_INICIO (DEBUG/INFO) com ['estabelecimentoId' => ..., 'valor' => ..., 'bandeira' => ...]
        • CRIACAO_SUCESSO (INFO) com ['transactionId' => $id, 'status' => 'aprovado']
      • Módulo: MOVINGPAY / ENTREPAY
        • CHAMADA_GATEWAY (DEBUG) com ['transactionId' => $id, 'endpoint' => $url]
        • RETORNO_GATEWAY (DEBUG/INFO) com ['transactionId' => $id, 'status' => $statusGateway, 'httpStatus' => $codigo]

  2. Transação recusada (limite/saldo/antifraude)

    • Ação:
      • Forçar cenário de recusa (usar parâmetros que levem a recusa, se disponíveis).
    • Expectativa:
      • Status final recusado, com motivo.
    • Logs sugeridos:
      • Módulo: PAGAMENTOS
        • CRIACAO_RECUSA (INFO) com ['transactionId' => $id, 'motivo' => $motivo]
      • Módulo: MOVINGPAY / ENTREPAY
        • RETORNO_GATEWAY_RECUSA (INFO) com status e códigos retornados.

  3. Erro técnico (timeout, exceção, falha de comunicação)

    • Ação:
      • Simular indisponibilidade do gateway (alterar URL em ambiente de teste ou derrubar o serviço).
    • Expectativa:
      • Registro de erro, transação marcada adequadamente (erro/pendente).
    • Logs sugeridos:
      • Módulo: MOVINGPAY / ENTREPAY
        • CHAMADA_GATEWAY_ERRO (ERROR) com ['transactionId' => $id, 'mensagem' => $e->getMessage()]
      • Módulo: TRANSACOES
        • ATUALIZACAO_STATUS_ERRO (ERROR) com contexto da falha.

Fluxo: Consulta de transações e relatórios​

Pontos de entrada

  • Scripts de gráficos: config/graficos/dashboard/buscar_transacoes_*.php
  • Tela: dashboard/gestao/transacoes.php

Cenários

  • Consulta por intervalo de datas.
  • Consulta por estabelecimento.
  • Consulta por status (aprovado/recusado/pendente).
  • Combinação de filtros.

Logs sugeridos

  • Módulo: TRANSACOES
    • CONSULTA_INICIO (DEBUG) com filtros recebidos.
    • CONSULTA_RESULTADO (INFO) com ['total' => $total, 'tempoMs' => $tempoExecucao].

Fluxo: Estornos / Cancelamentos​

Caso existam arquivos específicos (ex.: estorno_transacao.php, cancelar_transacao.php), aplicar:

  • Cenários

    • Estorno de transação aprovada.
    • Cancelamento antes da captura.
    • Cancelamento após captura (se permitido pelo adquirente).

  • Logs sugeridos

    • Módulo: PAGAMENTOS
      • ESTORNO_INICIO, ESTORNO_SUCESSO, ESTORNO_ERRO
      • CANCELAMENTO_INICIO, CANCELAMENTO_SUCESSO, CANCELAMENTO_ERRO
      • Contexto: ['transactionId' => $id, 'motivo' => $motivo ?? null]

Integrações específicas: Movingpay e Entrepay​

  • Movingpay

    • Config: config/movingpay_tokens.php
    • Usos em gráficos/transações: arquivos buscar_transacoes_movingpay*.php
    • Cenários:
      • Uso de token válido.
      • Token inválido/expirado.
    • Logs sugeridos:
      • Módulo: MOVINGPAY
        • AUTENTICACAO_SUCESSO / AUTENTICACAO_ERRO
        • Atenção: nunca logar o token em texto puro.

  • Entrepay

    • Config/API: config/entrepay/api_entrepay.php, config/entrepay/*.php
    • Polling: config/entrepay/polling_*.php
    • Cenários:
      • Credenciamento criado e sincronizado.
      • Polling atualiza corretamente o status.
    • Logs sugeridos:
      • Módulo: ENTREPAY
        • CHAMADA_API, RETORNO_API, POLLING_INICIO, POLLING_FIM, POLLING_ERRO