Autorizar y pagar con Pix Automático

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

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.

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.
Tus sistemas reciben los eventos de Pix Lerian. Consulta Eventos de Pix Lerian.

Diagrama

Autorizar

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

#	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.
El pagador puede cancelar un débito programado con POST /payer/scheduled-payments/{scheduled_payment_id}/cancel 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`.

Resumen

Crédito con garantía

Pagos

Liquidación y operación diaria

Consignado CLT (Dataprev)

Autorizar y pagar con Pix Automático

Participantes

Antes de empezar

Diagrama

Autorizar

Pagar los débitos programados

Reglas

Autorizar

Pagar los débitos programados

Cómo saber que terminó

Qué puede salir mal

Relacionados

​Participantes

​Antes de empezar

​Diagrama

​Autorizar

​Pagar los débitos programados

​Reglas

​Autorizar

​Pagar los débitos programados

​Cómo saber que terminó

​Qué puede salir mal

​Relacionados

Participantes

Antes de empezar

Diagrama

Autorizar

Pagar los débitos programados

Reglas

Autorizar

Pagar los débitos programados

Cómo saber que terminó

Qué puede salir mal

Relacionados