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

# Pix indirecto (BTG) con Helm

> Despliega el plugin de Pix de participante indirecto con el chart plugin-br-pix-indirect-btg-helm, incluidos los values sin los cuales el chart se niega a renderizar.

El plugin de Pix indirecto procesa pagos instantáneos Pix brasileños como participante indirecto a través de BTG Pactual. Úsalo cuando tu institución llega a la red Pix a través de un participante directo en lugar de conectarse a BACEN por sí misma. El nombre del chart es `plugin-br-pix-indirect-btg-helm`.

<Note>
  El plugin de Pix indirecto requiere una licencia Enterprise. Contacta a Lerian para obtener acceso a las imágenes del plugin y a las credenciales de despliegue.
</Note>

## Qué instala el chart

***

El chart instala cinco cargas de trabajo, cada una con su propio Deployment, Service, ConfigMap, Secret, HorizontalPodAutoscaler y PodDisruptionBudget:

* **Pix**: el servicio de pagos, con un Ingress opcional.
* **Inbound**: el worker que procesa los mensajes recibidos del participante directo.
* **Outbound**: el worker que envía los mensajes de pago y llama a tu webhook.
* **Reconciliation**: el worker que concilia los movimientos liquidados.
* **Schedule**: el worker que ejecuta los pagos programados.

El chart también renderiza un Secret de TLS mutuo cuando habilitas ese transporte. Incluye subcharts de PostgreSQL, Valkey y MongoDB.

## Prerrequisitos

***

* Un despliegue de Midaz en ejecución.
* Una asociación con BTG Pactual para la participación indirecta en Pix.
* Licencia Enterprise y credenciales del registry.
* Helm 3.8 o posterior para la compatibilidad con registries OCI.

## Values que debes definir

***

El chart falla la validación sin ellos. Defínelos en tu propio archivo de values antes de instalar.

En `pix.configmap`:

| Clave                                       | Propósito                                   |
| :------------------------------------------ | :------------------------------------------ |
| `BTG_BASE_URL`                              | El host de la API del participante directo. |
| `PIX_ISPB`                                  | El ISPB de ocho dígitos de tu institución.  |
| `MIDAZ_ORGANIZATION_ID` y `MIDAZ_LEDGER_ID` | El ledger que registra los movimientos.     |
| `ORGANIZATION_IDS`                          | Las organizaciones que cubre la licencia.   |

En `pix.secrets`:

| Clave                                     | Propósito                                                                                        |
| :---------------------------------------- | :----------------------------------------------------------------------------------------------- |
| `LICENSE_KEY`                             | Validación de la licencia Enterprise.                                                            |
| `BTG_CLIENT_ID` y `BTG_CLIENT_SECRET`     | Acceso a la API del participante directo.                                                        |
| `MIDAZ_CLIENT_ID` y `MIDAZ_CLIENT_SECRET` | Acceso máquina a máquina a Midaz.                                                                |
| `INTERNAL_WEBHOOK_SECRET`                 | Firma los mensajes que el servicio de pagos envía al worker inbound. Usa al menos 32 caracteres. |

Define también `outbound.configmap.WEBHOOK_CLIENT_URL` con el endpoint que recibe las notificaciones de pago.

Deja vacías las contraseñas de las bases de datos mientras los subcharts incluidos estén habilitados. Cada subchart genera su contraseña en su propio Secret, y las cargas de trabajo la leen de ahí. Define `DB_PASSWORD` y `MONGO_PASSWORD` solo cuando apuntas el chart a bases de datos externas.

## Instalación

***

Lee primero la versión actual del chart y luego instala:

```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
```

## Actualización y desinstalación

***

```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

***

* [Documentación de Pix](/es/interfaces/pix/pix-overview)
* [Helm charts de plugins](/es/platform/deploy/plugins/plugins-helm-overview)
* [Repositorio de Helm charts](https://github.com/LerianStudio/helm)