Transações
Visão Geral
Seção intitulada “Visão Geral”O módulo de Transações permite consultar e acompanhar todos os pagamentos online processados pelos gateways de pagamento integrados ao Sigeflex. Cada transação representa uma operação financeira realizada por meio de cartao de credito, PIX ou boleto bancario, registrando todas as etapas do processamento junto ao intermediador de pagamento.
Este módulo e exclusivamente de consulta e acompanhamento — as transações são criadas automaticamente pelo sistema quando um pagamento online e iniciado a partir de um pedido ou outra origem. Não e possível criar ou editar transações manualmente.
Como Acessar
Seção intitulada “Como Acessar”- No menu lateral, acesse Vendas > Transações
- A tela de listagem será exibida com todas as transações registradas
Permissão necessaria: vendas.transaction
Consultando Transações
Seção intitulada “Consultando Transações”A tela de listagem exibe as transações em formato de grade com as seguintes colunas:
| Coluna | Descrição |
|---|---|
| Criado em | Data e hora de criação da transação |
| Número | Número interno da transação |
| Transação | ID da transação no gateway (exibido junto com o status) |
| Contato | Nome, documento e e-mail do pagador |
| Pagamento | Tipo de pagamento (Cartao, PIX, Boleto), valor e parcelamento |
| Gateway | Nome do gateway de pagamento e tempo de resposta |
Filtros disponiveis
Seção intitulada “Filtros disponiveis”Para refinar a busca, utilize os filtros na barra superior:
- Consulta geral — pesquisa por número de origem, ID da origem ou ID da transação
- Status — filtra por Todos, Aberta, Autorizada, Falha, Cancelada ou Estornada
- Metodo de Pagamento — filtra pela forma de pagamento utilizada
- Gateway — filtra pelo intermediador (PagHiper, Pagar.me, MercadoPago, BrazilPays, GerenciaNet, Cielo, Sicredi, Stripe)
- Tipo de Pagamento — filtra por Cartao de Credito, Boleto ou PIX
Informações da Transação
Seção intitulada “Informações da Transação”Ao selecionar uma transação na listagem, o detalhe e exibido em cards organizados por categoria.
Dados da Transação
Seção intitulada “Dados da Transação”Informações principais sobre o processamento:
| Campo | Descrição |
|---|---|
| Status | Situação atual: Autorizada, Pendente, Falha, Cancelada ou Estornada |
| Número | Número interno da transação no Sigeflex |
| ID Transação no Gateway | Identificador único atribuido pelo gateway de pagamento |
| Codigo do Gateway | Codigo interno do gateway |
| Codigo de Autorização | Codigo retornado pela operadora ao autorizar o pagamento |
| Codigo de Retorno | Mensagem de retorno do gateway (pode conter detalhes de erro) |
| NSU | Número Sequencial Único — identificador da transação na rede adquirente |
| TID | Transaction ID — identificador único na rede de pagamentos |
| Criado | Data e hora em que a transação foi registrada |
| Atualizado | Data e hora da última atualização |
| Confirmado | Data e hora da confirmação do pagamento |
| Vencimento | Data limite para pagamento (quando aplicavel) |
Gateway de Pagamento
Seção intitulada “Gateway de Pagamento”Detalhes sobre o intermediador que processou a transação:
| Campo | Descrição |
|---|---|
| Gateway de Pagamento | Nome do intermediador (ex: Pagar.me, Cielo, MercadoPago) |
| Timeout | Indica se a requisicao ao gateway excedeu o tempo limite |
| Tempo de Resposta | Tempo em segundos que o gateway levou para responder |
| Data/Hora da Resposta | Momento exato em que o gateway retornou a resposta |
| Retorno da Transação | Conteudo completo da resposta retornada pelo gateway |
Informações do Pagamento
Seção intitulada “Informações do Pagamento”Dados financeiros da transação:
| Campo | Descrição |
|---|---|
| Valor | Valor monetario da transação |
| Tipo de Pagamento | Cartao de Credito, Boleto ou PIX |
| Moeda | Moeda utilizada (Real Brasileiro, Dolar Americano, Euro ou Libra Esterlina) |
| Forma de Pagamento | Nome da forma de pagamento configurada no sistema |
| Parcelamento | Quantidade de parcelas ou “A vista” |
Dados do Cartao
Seção intitulada “Dados do Cartao”Exibido somente para transações do tipo Cartao de Credito:
| Campo | Descrição |
|---|---|
| Nome no Cartao | Nome do titular impresso no cartao |
| Ultimos 4 Digitos | Ultimos quatro números do cartao utilizado |
| Bandeira | Bandeira do cartao (Visa, Mastercard, Elo, etc.) |
| Vencimento | Data de validade do cartao |
Informações PIX
Seção intitulada “Informações PIX”Exibido somente para transações do tipo PIX:
| Campo | Descrição |
|---|---|
| QR Code | String do QR Code para copia e cola |
| ID PIX | Identificador único da cobrança PIX |
| URL PIX | Link para pagamento via PIX |
| Vencimento | Data limite para realizacao do pagamento |
Caso não haja informações adicionais de PIX, a mensagem “Nenhuma informação adicional de PIX disponivel” será exibida.
Informações Boleto
Seção intitulada “Informações Boleto”Exibido somente para transações do tipo Boleto:
| Campo | Descrição |
|---|---|
| Codigo de Barras | Codigo de barras do boleto bancario |
| Linha Digitavel | Representacao numerica do codigo de barras para digitacao |
| URL do Boleto | Link para visualização e impressao do boleto |
Caso não haja informações adicionais de boleto, a mensagem “Nenhuma informação adicional de Boleto disponivel” será exibida.
Dados do Contato
Seção intitulada “Dados do Contato”Informações do pagador associado a transação:
| Campo | Descrição |
|---|---|
| Nome | Nome completo do pagador |
| Documento | CPF ou CNPJ |
| Endereco de e-mail | |
| Telefone | Número de telefone |
| Endereco | Endereco completo (logradouro, número, bairro, cidade, estado e CEP) |
Origem da Transação
Seção intitulada “Origem da Transação”Indica de onde a transação foi originada:
| Campo | Descrição |
|---|---|
| Tipo de Origem | Descrição do módulo de origem (ex: Pedido, Contrato) |
| ID da Origem | Identificador único do registro de origem |
| Número de Referencia | Número legivel do documento de origem |
Detalhes do Cancelamento
Seção intitulada “Detalhes do Cancelamento”Exibido somente quando a transação foi cancelada. O card e destacado visualmente com uma borda vermelha:
| Campo | Descrição |
|---|---|
| Codigo | Codigo de cancelamento retornado pelo gateway |
| Usuario | Nome do usuario que solicitou o cancelamento |
| Data do Cancelamento | Data e hora em que o cancelamento foi processado |
| Motivo do Cancelamento | Justificativa informada pelo usuario |
Ações Disponiveis
Seção intitulada “Ações Disponiveis”As ações ficam na barra de ferramentas acima da listagem. Para utiliza-las, selecione uma transação na lista.
Sincronizar
Seção intitulada “Sincronizar”Atualiza o status da transação consultando diretamente o gateway de pagamento.
Quando usar:
- Quando o status da transação parece desatualizado
- Quando houve uma falha de comunicação e o retorno do gateway não foi registrado
- Para verificar se um pagamento pendente ja foi confirmado
Como usar:
- Selecione a transação desejada na listagem
- Clique no botão Sincronizar (icone de sincronização verde)
- Aguarde o processamento — um indicador de carregamento será exibido
- O sistema consultara o gateway e atualizara os dados da transação
Cancelar
Seção intitulada “Cancelar”Solicita o cancelamento (estorno) de uma transação junto ao gateway de pagamento.
Quando usar:
- Para estornar um pagamento autorizado
- Para cancelar uma cobrança pendente
Restricoes:
- Transações que ja estão canceladas não podem ser canceladas novamente
- O cancelamento depende do suporte do gateway ao estorno da operação
Como usar:
- Selecione a transação desejada na listagem
- Clique no botão Cancelar (icone de proibicao vermelho)
- Na janela de confirmação, informe o motivo do cancelamento (mínimo 5 caracteres)
- Clique em Confirmar Cancelamento
- Aguarde o processamento junto ao gateway
Histórico da Transação
Seção intitulada “Histórico da Transação”Na parte inferior do detalhe, o card Histórico da Transação exibe uma tabela com todos os eventos registrados para aquela transação, em ordem cronologica. O contador de registros e exibido ao lado do titulo.
| Coluna | Descrição |
|---|---|
| Status | Status da transação naquele momento (Autorizada, Pendente, Falha, Cancelada, Estornada) |
| Data/Hora | Data e hora em que o evento ocorreu |
| Usuario | Nome do usuario que disparou a ação (quando aplicavel) |
| Descrição | Descrição detalhada do evento |
| Tempo (s) | Tempo de resposta do gateway naquela operação, em segundos |
| Disparo | Indica como a sincronização foi acionada: Manual (pelo usuario), Webhook (notificação automática do gateway) ou Sistema (processamento automático) |
Gateways de Pagamento Compativeis
Seção intitulada “Gateways de Pagamento Compativeis”O Sigeflex possui integrações com diversos gateways de pagamento. Cada gateway suporta diferentes tipos de pagamento:
| Gateway | Cartao | PIX | Boleto | Observacoes |
|---|---|---|---|---|
| Pagar.me | ✓ | ✓ | ✓ | Suporte completo a todos os tipos |
| Asaas | ✓ | ✓ | ✓ | Suporte completo a todos os tipos |
| Sicredi | — | ✓ | ✓ | PIX com OAuth2, cobrança bancaria |
| PagHiper | — | ✓ | ✓ | Especializado em PIX e boleto |
| Cielo | ✓ | — | — | Somente cartao de credito |
| Stripe | ✓ | — | — | Suporta BRL e USD |
| Mercado Pago | ✓ | — | — | Somente cartao de credito |
| BrazilPays | ✓ | — | — | Focado em transações em USD |
| Gerencianet (Efi) | — | ✓ | — | PIX com certificado mTLS |
Tipos de pagamento online
Seção intitulada “Tipos de pagamento online”- Cartao de Credito — pagamento via cartao com autorização em tempo real
- PIX — pagamento instantaneo via QR Code ou copia-e-cola
- Boleto Bancario — cobrança com codigo de barras e linha digitavel
Como configurar
Seção intitulada “Como configurar”Os gateways são configurados em Formas de Pagamento > aba Intermediadores para Pagamentos Online. Para que um gateway apareca disponivel, a integração correspondente deve estar conectada no Hub de Integrações.
As transações são atualizadas automaticamente via webhooks quando o gateway envia notificações de mudanca de status. Porem, em situacoes de instabilidade de rede, o webhook pode não ser recebido. Nesses casos, utilize o botão Sincronizar para forcar a consulta ao gateway e atualizar o status manualmente.