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.