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

# Deploy do Pix Indireto (BTG) via Helm

> Faça o deploy do plugin Pix de participante indireto com o chart plugin-br-pix-indirect-btg-helm, incluindo os values sem os quais o chart recusa a renderização.

O plugin Pix Indireto processa pagamentos instantâneos Pix brasileiros como participante indireto por meio do BTG Pactual. Use-o quando a sua instituição alcança a rede Pix por meio de um participante direto, em vez de se conectar ao próprio BACEN. O nome do chart é `plugin-br-pix-indirect-btg-helm`.

<Note>
  O plugin Pix Indireto exige uma licença Enterprise. Entre em contato com a Lerian para obter acesso às imagens do plugin e às credenciais de deploy.
</Note>

## O que o chart instala

***

O chart instala cinco cargas de trabalho, cada uma com o próprio Deployment, Service, ConfigMap, Secret, HorizontalPodAutoscaler e PodDisruptionBudget:

* **Pix**: o serviço de pagamento, com um Ingress opcional.
* **Inbound**: o worker que processa as mensagens recebidas do participante direto.
* **Outbound**: o worker que envia as mensagens de pagamento e chama o seu webhook.
* **Reconciliation**: o worker que concilia as movimentações liquidadas.
* **Schedule**: o worker que roda os pagamentos agendados.

O chart também renderiza um Secret de TLS mútuo quando você habilita esse transporte. Ele empacota os subcharts PostgreSQL, Valkey e MongoDB.

## Pré-requisitos

***

* Um deploy do Midaz em execução.
* Uma parceria com o BTG Pactual para a participação indireta no Pix.
* Licença Enterprise e credenciais de registry.
* Helm 3.8 ou posterior para o suporte a registry OCI.

## Values que você deve definir

***

O chart falha na validação sem eles. Defina-os no seu próprio arquivo de values antes de instalar.

Em `pix.configmap`:

| Chave                                       | Finalidade                                 |
| :------------------------------------------ | :----------------------------------------- |
| `BTG_BASE_URL`                              | O host da API do participante direto.      |
| `PIX_ISPB`                                  | O ISPB de oito dígitos da sua instituição. |
| `MIDAZ_ORGANIZATION_ID` e `MIDAZ_LEDGER_ID` | O ledger que registra as movimentações.    |
| `ORGANIZATION_IDS`                          | As organizações que a licença cobre.       |

Em `pix.secrets`:

| Chave                                     | Finalidade                                                                                            |
| :---------------------------------------- | :---------------------------------------------------------------------------------------------------- |
| `LICENSE_KEY`                             | Validação da licença Enterprise.                                                                      |
| `BTG_CLIENT_ID` e `BTG_CLIENT_SECRET`     | Acesso à API do participante direto.                                                                  |
| `MIDAZ_CLIENT_ID` e `MIDAZ_CLIENT_SECRET` | Acesso máquina a máquina ao Midaz.                                                                    |
| `INTERNAL_WEBHOOK_SECRET`                 | Assina as mensagens que o serviço de pagamento envia ao worker inbound. Use pelo menos 32 caracteres. |

Defina também `outbound.configmap.WEBHOOK_CLIENT_URL` com o endpoint que recebe as notificações de pagamento.

Deixe as senhas dos bancos de dados vazias enquanto os subcharts empacotados estiverem habilitados. Cada subchart gera a própria senha no próprio Secret, e as cargas de trabalho a leem de lá. Defina `DB_PASSWORD` e `MONGO_PASSWORD` apenas quando você apontar o chart para bancos de dados externos.

## Instalação

***

Leia primeiro a versão atual do chart e depois instale:

```bash theme={null}
helm show chart oci://registry-1.docker.io/lerianstudio/plugin-br-pix-indirect-btg-helm
```

```bash theme={null}
helm install plugin-br-pix-indirect-btg \
  oci://registry-1.docker.io/lerianstudio/plugin-br-pix-indirect-btg-helm \
  --version <version> -n midaz-plugins --create-namespace -f values-custom.yaml
```

## Upgrade e desinstalação

***

```bash theme={null}
helm upgrade plugin-br-pix-indirect-btg \
  oci://registry-1.docker.io/lerianstudio/plugin-br-pix-indirect-btg-helm \
  --version <new-version> -n midaz-plugins -f values-custom.yaml
```

```bash theme={null}
helm uninstall plugin-br-pix-indirect-btg -n midaz-plugins
```

## Recursos

***

* [Documentação do Pix](/pt/interfaces/pix/pix-overview)
* [Charts Helm dos plugins](/pt/platform/deploy/plugins/plugins-helm-overview)
* [Repositório de charts Helm](https://github.com/LerianStudio/helm)