Esta página define os principais conceitos e termos utilizados na Autra, servindo como referência para a integração e o desenvolvimento.
Tenant
O Tenant representa a empresa ou organização que utiliza a plataforma da Autra para oferecer produtos financeiros com sua própria identidade.
É o tenant quem define:
- a marca e identidade da solução;
- as regras de negócio e de produto;
- a configuração de integrações, credenciais e webhooks.
Na arquitetura da Autra, o tenant é a entidade central de relacionamento com:
- merchants (estabelecimentos, parceiros ou clientes finais);
- contas financeiras operadas dentro do ecossistema;
- usuários e aplicações que interagem com a plataforma.
Na Autra, o tenant é também a unidade primária de isolamento e governança.
Todos os recursos e operações são sempre associados a um tenant específico, garantindo separação lógica, segurança e controle operacional.
Tudo na Autra é isolado por tenant:
- Credenciais e chaves de acesso
- Dados e registros financeiros
- Eventos e notificações
- Webhooks e integrações externas
- Webhooks
Account
A Account representa uma conta financeira utilizada para operar produtos como Pix e boleto dentro da plataforma Autra.
A account é o elemento responsável pela movimentação financeira e pode estar associada a:
- Um merchant
- Um produto financeiro específico
- Um fluxo financeiro determinado pelo tenant
Dependendo do modelo de negócio, uma account pode representar, por exemplo:
- uma conta de liquidação;
- uma conta operacional;
- uma conta vinculada a um merchant específico.
Merchant
O Merchant representa o estabelecimento, parceiro ou entidade que realiza operações financeiras dentro do ecossistema do tenant.
O merchant é normalmente o responsável comercial pelas transações e pode estar associado a uma ou mais accounts.
Dependendo do modelo de negócio, um tenant pode possuir:
- Um único merchant
- Múltiplos merchants, cada um com suas próprias contas e regras
Funcionalidade
Uma Funcionalidade representa um fluxo financeiro executável disponibilizado pela Autra.
Cada funcionalidade corresponde a uma operação financeira realizada dentro da plataforma, como:
- Pagamento via Pix
- Pagamento com cartão
- Liquidação de boleto
Ao ser executada, uma funcionalidade gera uma instância operacional que possui:
- Um identificador único
- Um estado atual
- Um ciclo de vida (lifecycle)
- Um conjunto de eventos associados
O estado de uma funcionalidade evolui ao longo do tempo, sendo sempre refletido por meio de eventos.
Event
Um Event representa uma mudança relevante no estado de uma funcionalidade financeira.
Exemplos de eventos:
- Funcionalidade criada
- Funcionalidade autorizada
- Funcionalidade confirmada
- Funcionalidade expirada
Na Autra, os eventos são a fonte de verdade sobre o estado das operações financeiras.
Isso significa que:
- o estado atual é sempre derivado dos eventos;
- integrações devem reagir a eventos, e não apenas a respostas síncronas;
- o modelo é consistente com uma arquitetura orientada a eventos.