Nossa plataforma foi projetada com uma arquitetura event-driven, focada em confiabilidade, escalabilidade e rastreabilidade das operações financeiras.
Esse modelo se aplica tanto para integrações via API quanto para o uso de aplicações white label fornecidas pela Autra.
Arquitetura orientada a eventos
Na Autra, toda operação relevante gera eventos financeiros.
Isso significa que:
- Nem todas as respostas síncronas representam o estado final de uma operação
- O estado definitivo é sempre confirmado por meio de eventos
- Webhooks fazem parte essencial do modelo de integração e operação da plataforma
Fluxo de eventos
O fluxo padrão de uma operação financeira é:
- O ecossistema do cliente cria uma operação via API ou por meio das aplicações white label
- A Autra valida e processa a requisição
- Um ou mais eventos são gerados ao longo do ciclo de vida da operação
- Os eventos são disponibilizados via webhooks
- O ecossistema do cliente atualiza seu estado interno ou experiência do usuário com base nos eventos
Webhooks
Webhooks são chamadas HTTP enviadas pela Autra para notificar eventos financeiros relevantes.
Eles permitem que o ecossistema do cliente reaja a mudanças de estado de forma assíncrona, confiável e desacoplada.
Boas práticas
- Utilize HTTPS
- Responda rapidamente às notificações (ACK)
- Processe eventos de forma idempotente
- Não dependa da ordem de entrega dos eventos
Fonte de verdade
Na Autra:
- A resposta síncrona indica apenas a aceitação da requisição
- Os eventos confirmam o estado efetivo da operação
- Uma operação nunca deve ser considerada concluída apenas com base na resposta do endpoint
Esse modelo se aplica igualmente a integrações customizadas e às aplicações white label operadas sobre a plataforma.
Benefícios desse modelo
- Escalabilidade
- Observabilidade
- Resiliência a falhas
- Facilidade de auditoria
- Evolução da plataforma sem quebra de integração