> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# API e modelo de deploy do Midaz v4

> O Midaz v4 documenta a API atual do Ledger, o modelo de integração de CRM e Fees e a fronteira de runtime separada do Tracer.

<Badge stroke icon="calendar-days" iconType="regular">3 de setembro de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Atualização do produto</Badge> <Badge color="purple" size="lg" stroke icon="eye" iconType="regular">Ação necessária</Badge>

## Afeta

***

Equipes que integram com as APIs de CRM ou Fees do Midaz, que fazem deploy do Midaz com Helm ou que usam o Tracer com o Midaz v4.

## O que mudou

***

A referência do Midaz v4 agora identifica o Ledger `/v2` como a superfície de API atual para Core, CRM e Fees. O Ledger `/v1` continua disponível apenas para compatibilidade. A referência autônoma do Fees Engine foi aposentada; as URLs legadas dela redirecionavam para os destinos no Midaz até 10 de setembro de 2026 (veja [As URLs das páginas agora espelham a navegação](/pt/news/2026/september/page-urls-mirror-navigation)).

CRM e Fees rodam como módulos do runtime unificado do Midaz Ledger; eles não são deploys autônomos. As associações de conta do CRM usam Instruments, e a referência de erros do Fees usa os códigos numéricos canônicos.

O Tracer é source-available sob a ELv2 no repositório do Midaz v4, mas continua sendo um serviço com deploy separado. Sua API HTTP pública é `/v1`. O Ledger `/v2` pode optar pela integração de reserva; o Ledger `/v1` não a usa.

## Impacto

***

**Classificação: Ação necessária.**

## O que você precisa fazer

***

<Steps>
  <Step>Mova as integrações ativas de CRM e Fees para a referência do Ledger `/v2` e trate `/v1` como uma superfície de compatibilidade.</Step>
  <Step>Atualize os values do Helm e os runbooks para que CRM e Fees tenham deploy junto com o Midaz, e não como serviços autônomos. Valide qualquer integração de reserva do Tracer contra a orientação de deploy da v4.</Step>
</Steps>

### Prazo

Conclua isso antes da próxima integração ou deploy do Midaz v4.