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 monorepo do 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. Isso oferece flexibilidade para integrar 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 tanto a autenticação quanto a autorização em todo o seu ecossistema Lerian, incluindo o Midaz e todos os outros produtos Lerian.
O Access Manager aceita padrões de identidade comuns como OAuth2 e OIDC e se integra nativamente a todos os produtos Lerian. 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

Cada organização deve ter pelo menos um Ledger. No entanto, você pode ter vários Ledgers dentro de cada Organização, 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

Sua Organização pode ter vários Ativos. No entanto, cada Ativo deve ser criado individualmente, o que permite configurações específicas, como casas decimais.
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

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. Você precisará criar uma conta para cada 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?