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

# Autorizar y pagar con Pix Automático

> Como institución del pagador, acepta una solicitud de autorización de Pix Automático y paga sus débitos programados desde una cuenta de Midaz, con Pix Lerian y Lerian SPI.

Deja que tu cliente autorice un Pix recurrente y paga cada débito programado desde la cuenta del cliente.

> [!NOTE]
>
> Este flujo es una lectura sugerida de los manuales del BACEN para Pix. Los manuales prevalecen sobre esta página. Tu institución, como participante, valida el flujo y lo implementa sobre las API de Lerian. Consulta [cómo leer los diagramas](https://docs.lerian.studio/es/diagrams/introduction.md).

## Participantes

***

* **Tu institución.** El participante de Pix del pagador. Muestra cada solicitud al pagador y envía la decisión del pagador.
* **Pix Lerian.** Guarda las autorizaciones y los débitos programados del pagador. Debita la cuenta del pagador en Midaz en la fecha de liquidación.
* **Midaz.** El ledger que guarda la cuenta del pagador.
* **Lerian SPI.** Intercambia los mensajes de Pix Automático y los pagos con el SPI.
* **SPI.** El sistema de pagos instantáneos del BACEN. Lleva los mensajes de la institución del receptor y liquida cada pago.

## Antes de empezar

***

* La cuenta del pagador existe en Midaz, está activa y tiene un titular.
* Tu backend comprueba que el pagador puede usar la cuenta. Envía esa cuenta en `X-Account-Id`. Consulta [Usa Pix Automático con Pix Lerian](https://docs.lerian.studio/es/interfaces/pix-lerian/pix-lerian-pix-automatico.md).
* Tus sistemas reciben los eventos de Pix Lerian. Consulta [Eventos de Pix Lerian](https://docs.lerian.studio/es/interfaces/pix-lerian/pix-lerian-events.md).

## Diagrama

***

### Autorizar

![Autorizar y pagar con Pix Automático: Autorizar](https://mintcdn.com/lerian-49cb71fc/l2YPqqB1Osw1XPuf/images/es/d2/id-authorize-and-pay-pix-automatico-1.svg?fit=max\&auto=format\&n=l2YPqqB1Osw1XPuf\&q=85\&s=9b14f95d8c63034b0e356198a6790d34)

| # | Origen | Destino | Mensaje | API de Lerian | Qué ocurre |
| - | - | - | - | - | - |
| 1 | SPI | Lerian SPI | `pain.009` | | La institución del receptor pide una autorización. |
| 2 | Lerian SPI | Pix Lerian | Llamada interna | | Lerian SPI pasa la solicitud a Pix Lerian. |
| 3 | Pix Lerian | Pix Lerian | Paso interno | | Pix Lerian encuentra la cuenta del pagador. |
| 4 | Pix Lerian | Tu institución | API de Lerian | Evento `pix_auto_request.received` | La solicitud espera la decisión del pagador. Léela con [`GET /payer/authorization-requests/{authorization_request_id}`](https://docs.lerian.studio/es/reference/interfaces/pix-lerian/pix-automatico/get-authorization-request). |
| 5 | Tu institución | Tu institución | Paso interno | | Muestra la solicitud al pagador y obtén la decisión. |
| 6 | Tu institución | Pix Lerian | API de Lerian | [`POST /payer/authorization-requests/{authorization_request_id}/decide`](https://docs.lerian.studio/es/reference/interfaces/pix-lerian/pix-automatico/decide-authorization-request) | Envía `decision` `ACCEPT`, con los parámetros del pagador, si los hay. Envía el encabezado `X-Idempotency`. |
| 7 | Pix Lerian | Tu institución | API de Lerian | Respuesta al paso 6 | Pix Lerian responde `202` con la solicitud en `ACCEPTED` y el `authorizationId`. La autorización queda en `AWAITING_CONCLUSION`. Pix Lerian publica `pix_auto_authorization.granted` y `pix_auto_authorization.awaiting_conclusion`. |
| 8 | Pix Lerian | Lerian SPI | Llamada interna | | Pix Lerian envía la aceptación. |
| 9 | Lerian SPI | SPI | `pain.012` | | Lerian SPI envía la aceptación a la institución del receptor. |
| 10 | SPI | Lerian SPI | `pain.012` | | La institución del receptor concluye la autorización. |
| 11 | Lerian SPI | Pix Lerian | Llamada interna | | Lerian SPI pasa la conclusión a Pix Lerian. |
| 12 | Pix Lerian | Tu institución | API de Lerian | Evento `pix_auto_authorization.concluded` | El evento trae el resultado. Con `APPROVED`, la autorización está activa. |

### Pagar los débitos programados

![Autorizar y pagar con Pix Automático: Pagar los débitos programados](https://mintcdn.com/lerian-49cb71fc/l2YPqqB1Osw1XPuf/images/es/d2/id-authorize-and-pay-pix-automatico-2.svg?fit=max\&auto=format\&n=l2YPqqB1Osw1XPuf\&q=85\&s=b72584ca7328ba134a358abb692d65f4)

| # | Origen | Destino | Mensaje | API de Lerian | Qué ocurre |
| - | - | - | - | - | - |
| 1 | SPI | Lerian SPI | `pain.013` | | La institución del receptor envía la instrucción de un débito. |
| 2 | Lerian SPI | Pix Lerian | Llamada interna | | Lerian SPI pasa la instrucción a Pix Lerian. |
| 3 | Pix Lerian | Pix Lerian | Paso interno | | Pix Lerian compara la instrucción con la autorización y programa el débito. |
| 4 | Pix Lerian | Lerian SPI | Llamada interna | | Pix Lerian acepta o rechaza la instrucción. |
| 5 | Lerian SPI | SPI | `pain.014` | | Lerian SPI envía la respuesta a la institución del receptor. |
| 6 | Pix Lerian | Pix Lerian | Paso interno | | En la fecha de liquidación, entre las 00:00 y las 08:00, Pix Lerian inicia el débito. |
| 7 | Pix Lerian | Midaz | Llamada interna | | Pix Lerian debita la cuenta del pagador. La transacción acredita `@external/BRL`. |
| 8 | Pix Lerian | Lerian SPI | Llamada interna | | Pix Lerian envía el pago. |
| 9 | Lerian SPI | SPI | `pacs.008` | | Lerian SPI envía la orden de pago al SPI. |
| 10 | SPI | Lerian SPI | `pacs.002` | | El SPI informa la liquidación o el rechazo del pago. |
| 11 | Lerian SPI | Pix Lerian | Llamada interna | | Lerian SPI pasa el resultado a Pix Lerian. |
| 12 | Pix Lerian | Midaz | Llamada interna | | Solo para un pago rechazado: Pix Lerian revierte el débito con una nueva transacción inversa. |
| 13 | Pix Lerian | Tu institución | API de Lerian | Evento `outbound_transfer.completed` | La transferencia tiene `initiationType` `AUTO`. Para un pago rechazado, el evento es `outbound_transfer.rejected`. |

## Reglas

***

### Autorizar

* Para rechazar, envía `decision` `REJECT` con `rejectionReason`. Pix Lerian publica `pix_auto_request.rejected`. La institución del receptor no responde a un rechazo.
* Cuando ninguna conclusión llega en una hora, Pix Lerian publica `pix_auto_authorization.conclusion_timed_out`. La autorización sigue esperando la conclusión.

### Pagar los débitos programados

* Pix Lerian rechaza una instrucción por encima del monto máximo del pagador (`AM02`), o una que difiere de un monto fijo (`AM09`).
* Lista los débitos programados con [`GET /payer/scheduled-payments`](https://docs.lerian.studio/es/reference/interfaces/pix-lerian/pix-automatico/list-scheduled-payments).
* El pagador puede cancelar un débito programado con [`POST /payer/scheduled-payments/{scheduled_payment_id}/cancel`](https://docs.lerian.studio/es/reference/interfaces/pix-lerian/pix-automatico/cancel-scheduled-payment) hasta las 00:00 de la fecha de liquidación. La autorización sigue activa.
* Cuando la ventana de 00:00 a 08:00 cierra sin liquidación, Pix Lerian publica `pix_auto_scheduled_payment.settlement_deferred`. Lo intenta otra vez el mismo día, entre las 18:00 y las 21:00.
* Los horarios de esta página están en la zona horaria America/Sao\_Paulo.

## Cómo saber que terminó

***

* **Autorizar.** Pix Lerian publica `pix_auto_authorization.concluded` con `APPROVED`.
* **Pagar los débitos programados.** Para cada débito, Pix Lerian publica `outbound_transfer.completed` con `initiationType` `AUTO`.

## Qué puede salir mal

***

| Situación | Qué ves | Qué hacer |
| - | - | - |
| La conclusión no llega en una hora. | Evento `pix_auto_authorization.conclusion_timed_out`. | Avisa al pagador que la autorización todavía no está activa. |
| La cancelación de un débito llega a las 00:00 de la fecha de liquidación o después. | `409`, código `PIX-0825`. | El débito sigue programado. |
| El débito no se liquidó ese día, y la autorización permite más intentos. | Evento `pix_auto_scheduled_payment.settlement_retry_permitted`. | Avisa al pagador que puede haber más intentos en los próximos días. |
| El débito no se liquidó ese día, y la autorización no permite más intentos. | Evento `pix_auto_scheduled_payment.settlement_failed`. | Avisa al pagador que Pix Automático no pagó este débito. |
| La respuesta a una llamada no llega. | Ninguna respuesta, o un timeout. | Envía la misma llamada otra vez con la misma clave `X-Idempotency`. |

## Relacionados

***

* [Enviar y recibir Pix](https://docs.lerian.studio/es/diagrams/native-rails/send-and-receive-pix.md)
* [Usa Pix Automático con Pix Lerian](https://docs.lerian.studio/es/interfaces/pix-lerian/pix-lerian-pix-automatico.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.