> ## 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.

# Conectar o Fees Engine ao Midaz

> Como o Fees Engine se conecta ao Midaz — o que ele lê do ledger e a configuração de deploy que liga os dois.

O **Fees Engine** faz parte do Midaz, implantado como um serviço independente, e funciona por **cálculo**: a sua aplicação pede que ele calcule as taxas de uma transação, e ele devolve o resultado. A sua aplicação então submete a transação — já com as taxas — ao Midaz. O Fees Engine **lê** do Midaz para fazer seu trabalho, mas nunca grava no ledger; registrar a transação é um passo da sua aplicação.

Para ver onde isso se encaixa no quadro geral, veja [Montando um core banking completo](/pt/building-a-complete-core-banking).

## O que o Fees Engine usa do Midaz

***

O Fees Engine **lê** do Midaz para duas coisas — ele não posta nada de volta:

* **Resolver as contas** — busca as contas envolvidas, por alias, pela **Onboarding API** do Midaz, para que a taxa atinja contas reais.
* **Billing por volume** — conta as transações por rota pela **Transaction API** do Midaz, o que alimenta o billing por período e por volume.

A taxa em si é **calculada e devolvida ao chamador**. A sua aplicação a registra no ledger quando submete a transação — o Fees Engine não grava no Midaz.

## Configuração da conexão

***

A conexão é definida por variáveis de ambiente quando o Fees Engine é implantado (no ConfigMap dele) — não pela sua aplicação. A sua app só chama a API do próprio Fees Engine.

| Variável                | Default / Obrigatória     | Descrição                                                                                                                                            |
| ----------------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MIDAZ_ONBOARDING_URL`  | **Obrigatória**           | URL base da Onboarding API do Midaz, usada para resolver contas por alias. Em setups locais: `http://midaz-ledger:3002/v1/`.                         |
| `MIDAZ_TRANSACTION_URL` | **Obrigatória**           | URL base da Transaction API do Midaz, usada para contar transações por rota no billing por volume. Em setups locais: `http://midaz-ledger:3002/v1/`. |
| `CLIENT_ID`             | Usada na auth             | Client ID que o plugin usa para autenticar no Midaz (machine-to-machine).                                                                            |
| `CLIENT_SECRET`         | Usada na auth             | Client secret pareado com `CLIENT_ID`.                                                                                                               |
| `PLUGIN_AUTH_ENABLED`   | `false`                   | Habilita autenticação via Access Manager. Use `true` em produção.                                                                                    |
| `PLUGIN_AUTH_ADDRESS`   | `http://plugin-auth:4000` | URL do serviço Access Manager (`plugin-auth`) que emite os tokens.                                                                                   |

<Note>
  As duas variáveis `MIDAZ_ONBOARDING_URL` e `MIDAZ_TRANSACTION_URL` são obrigatórias — o plugin não sobe sem elas. Em setups locais, ambas apontam para o mesmo host do Midaz (`midaz-ledger:3002`); em produção, apontam para as suas APIs do Midaz implantadas.
</Note>

## Autenticação

***

O Fees Engine autentica no Midaz através do **Access Manager**. Ele troca o seu `CLIENT_ID` / `CLIENT_SECRET` por um application token e chama o Midaz com esse token — o mesmo padrão machine-to-machine usado em toda a plataforma.

Em deployments **multi-tenant**, as credenciais por tenant vêm do **AWS Secrets Manager** em vez do `CLIENT_ID` / `CLIENT_SECRET` estáticos; o Access Manager então emite o token a partir dessas credenciais, para que as chamadas de cada tenant cheguem ao ledger certo. O modo multi-tenant exige a autenticação habilitada.

→ [Access Manager](/pt/platform/access-manager/access-manager)

## Veja na Lerian

***

* A jornada completa de integração entre as peças: [Montando um core banking completo](/pt/building-a-complete-core-banking)
* O que o Fees Engine faz: [O que é Fees Engine?](/pt/midaz/fees/fees-engine-overview)
* Implante a stack: [Helm charts](/pt/platform/helm/helm-overview)