pdvpos-knowledge-base


README ConnectTEF | Índice da Seção | Anterior | Próximo

Caminho: Início / Arquitetura / Eventos

Eventos

O ConnectTEF é uma plataforma orientada a eventos.

Durante o processamento de uma operação, diversos acontecimentos podem ocorrer.

Cada um desses acontecimentos representa um evento dentro da arquitetura da plataforma.

Os eventos permitem que aplicações acompanhem o ciclo de vida das operações sem depender de consultas constantes ao sistema.


Objetivo

Apresentar o conceito de eventos no ConnectTEF e demonstrar como eles são utilizados para representar mudanças de estado ao longo do processamento das operações.


O que é um evento?

Um evento representa um fato ocorrido dentro da plataforma.

Por exemplo:

Eventos representam mudanças de estado.


Por que utilizar eventos?

Em arquiteturas modernas, diferentes componentes precisam acompanhar o processamento das operações.

Sem eventos, cada sistema precisaria consultar continuamente a plataforma para descobrir se alguma alteração ocorreu.

Com uma arquitetura orientada a eventos, cada mudança é registrada e pode ser comunicada automaticamente aos sistemas interessados.


Fluxo Conceitual

Solicitação

      │

      ▼

Evento

      │

      ▼

Processamento

      │

      ▼

Novo Evento

      │

      ▼

Resposta

Uma única operação pode gerar diversos eventos ao longo do seu ciclo de vida.


Ciclo de Vida de uma Operação

Um pagamento, por exemplo, pode produzir eventos como:

Operação Criada

        │

        ▼

Validação

        │

        ▼

Enviada ao SmartPOS

        │

        ▼

Em Processamento

        │

        ▼

Autorizada

        │

        ▼

Concluída

Cada etapa representa um estado diferente da operação.


Eventos Internos

Além das operações de pagamento, a plataforma pode gerar eventos relacionados ao seu funcionamento.

Exemplos:

Esses eventos auxiliam no monitoramento e na auditoria da plataforma.


Eventos x Webhooks

É importante diferenciar esses conceitos.

Evento Webhook
Representa uma mudança de estado É um mecanismo para entregar um evento
Existe dentro da plataforma Comunica o evento para aplicações externas
Pode gerar logs, auditoria ou notificações Envia uma requisição HTTP
Faz parte do processamento interno Faz parte da comunicação externa

Em outras palavras:

Todo Webhook entrega um evento.

Mas nem todo evento precisa gerar um Webhook.


Eventos e APIs

As APIs são utilizadas para iniciar operações.

Os eventos representam o andamento dessas operações.

ERP

 │

 ▼

API

 │

 ▼

ConnectTEF

 │

 ▼

Eventos

 │

 ▼

Webhook (quando aplicável)

 │

 ▼

ERP

Essa arquitetura desacopla a execução da operação do acompanhamento do seu processamento.


Benefícios

A utilização de eventos oferece diversas vantagens.


Eventos e Auditoria

Os eventos também constituem a base para recursos como:

Cada mudança de estado pode ser registrada para posterior análise.


Filosofia da Plataforma

O ConnectTEF foi projetado para que toda operação seja composta por uma sequência de eventos.

Essa abordagem permite acompanhar o ciclo de vida completo das operações, aumentar a transparência do processamento e facilitar integrações com sistemas modernos baseados em arquitetura orientada a eventos.


Resumo

Eventos representam mudanças de estado ocorridas durante o funcionamento do ConnectTEF.

Eles descrevem o ciclo de vida das operações e permitem que diferentes componentes acompanhem o processamento da plataforma de forma organizada, escalável e desacoplada.

Os Webhooks são um dos mecanismos utilizados para comunicar esses eventos às aplicações integradas.


Próximo capítulo

Agora conheceremos como a arquitetura do ConnectTEF foi projetada para evoluir continuamente, suportando novos fabricantes, dispositivos, funcionalidades e formas de integração sem alterar os sistemas já conectados.


Veja também