Skip to main content
Este guia é indicado para desenvolvedores que estão configurando o Midaz pela primeira vez. Se você busca uma visão geral de negócio sobre como o Midaz funciona, veja O que é o Midaz?. Para opções de deploy, veja SaaS e BYOC.
Siga estas etapas para configurar o Midaz.

Etapa 1 - Configure seu ambiente


Para configurar seu ambiente Midaz, siga as etapas na página Instalando o Midaz.
  • Isso instala o Midaz Ledger.

Autenticação e autorização

O Midaz não inclui um sistema de autenticação ou autorização integrado. Você pode integrar o Midaz com seu provedor de identidade ou pilha de segurança existente. Se você precisar de uma solução pronta para uso, pode habilitar o Access Manager, um recurso opcional desenvolvido pela Lerian. Ele trata a autenticação e a autorização do Midaz e de outros produtos Lerian.
O Access Manager aceita padrões de identidade comuns como OAuth2 e OIDC. Para mais detalhes, consulte o guia Access Manager.

Etapa 2 - Crie a estrutura do Midaz


Comece criando a estrutura de dados que seus workflows usam.

Etapa 2.1 - Crie uma Organização

A primeira etapa é criar sua Organização dentro do Midaz.
Se sua organização tiver várias filiais, você pode criar várias Organizações e designar uma Organização Pai.Por exemplo, se a Empresa XYZ tem filiais em Nova York e no Brasil, você pode criar uma Organização para a Empresa XYZ e defini-la como a organização pai da XYZ Nova York e da XYZ Brasil.
Para uma lista completa de endpoints para gerenciar sua Organização, expanda a seção abaixo:

Etapa 2.2 - Crie um Ledger

Crie pelo menos um Ledger em cada Organização. Você pode criar vários Ledgers, se necessário. Para uma lista completa de endpoints para gerenciar seu Ledger, expanda a seção abaixo:
  • Recupere todos os Ledgers usando o endpoint List Ledgers.
  • Recupere um Ledger específico com o endpoint Retrieve a Ledger.
  • Atualize os detalhes do Ledger usando o endpoint Update a Ledger.
  • Exclua um Ledger em Homologação usando o endpoint Delete a Ledger.
    • Para Ledgers em Produção, a exclusão exige contato com o suporte da Lerian por motivos de segurança.

Etapa 2.3 - Crie os Ativos

Cada Ledger pode ter vários Ativos. Crie cada Ativo individualmente.
Quando você cria um Ativo, o Midaz configura automaticamente uma Conta Externa, caso ainda não exista uma. A Conta Externa respalda todas as transações que entram e saem do Ledger.
Para uma lista completa de endpoints para gerenciar seus Ativos, expanda a seção abaixo:

Etapa 2.4 - Crie um Segmento (opcional)

Se quiser, você pode usar o ID do Segmento como um rótulo de agrupamento personalizado que reúne contas de acordo com políticas definidas pelo usuário. Para uma lista completa de endpoints para gerenciar seu Segmento, expanda a seção abaixo:

Etapa 2.5 - Crie um Portfólio (opcional)

Crie um Portfólio para agrupar suas contas de diferentes Ativos. Para uma lista completa de endpoints para gerenciar seus Portfólios, expanda a seção abaixo:

Etapa 2.6 - Crie as Contas

Agora você pode adicionar as contas relacionadas aos Ativos que quer usar com o Ledger. Cada Conta guarda um Ativo. Para uma lista completa de endpoints para gerenciar suas Contas, expanda a seção abaixo:

Etapa 3 - Explore nossas APIs


Consulte a Referência da API para saber mais sobre o Midaz, desde o tratamento de metadados até a idempotência.

Precisa de ajuda?