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

# Devolver un Pix recibido

> Devuelve todo o parte de un Pix que tu institución recibió, como una devolución Pix en el SPI, con Pix Lerian y Lerian SPI.

Devuelve todo o parte de un Pix que una de tus cuentas recibió.

> [!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 que recibió el Pix original. Llama a la API de Pix Lerian y recibe sus eventos.
* **Pix Lerian.** Conecta Midaz con Lerian SPI. Registra la devolución en Midaz y la entrega a Lerian SPI.
* **Midaz.** El ledger que guarda la cuenta que recibió el Pix original.
* **Lerian SPI.** Intercambia los mensajes de Pix con el SPI.
* **SPI.** El sistema de pagos instantáneos del BACEN. Liquida la devolución.

## Antes de empezar

***

* El Pix original es una transferencia recibida en `COMPLETED`. Consulta [Enviar y recibir Pix](https://docs.lerian.studio/es/diagrams/native-rails/send-and-receive-pix.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

***

![Devolver un Pix recibido](https://mintcdn.com/lerian-49cb71fc/l2YPqqB1Osw1XPuf/images/es/d2/id-return-a-received-pix.svg?fit=max\&auto=format\&n=l2YPqqB1Osw1XPuf\&q=85\&s=83297f01a38d40c73d143e9c2bf7bfa8)

## Pasos

***

| # | Origen | Destino | Mensaje | API de Lerian | Qué ocurre |
| - | - | - | - | - | - |
| 1 | Tu institución | Pix Lerian | API de Lerian | [`POST /transfers/{id}/refunds`](https://docs.lerian.studio/es/reference/interfaces/pix-lerian/spi/create-refund) | Solicita la devolución de la transferencia original, con el monto, `reasonCode` y `reason`. Envía el encabezado `X-Idempotency`. |
| 2 | Pix Lerian | Pix Lerian | Paso interno | | Pix Lerian verifica que la transferencia original admite una devolución de ese monto. |
| 3 | Pix Lerian | Midaz | Llamada interna | | Pix Lerian debita la cuenta que recibió el Pix original. La transacción acredita `@external/BRL`. |
| 4 | Pix Lerian | Lerian SPI | Llamada interna | | Pix Lerian envía la devolución. |
| 5 | Lerian SPI | SPI | `pacs.004` | | Lerian SPI envía la devolución al SPI. |
| 6 | Pix Lerian | Tu institución | API de Lerian | Respuesta al paso 1 | Pix Lerian responde `201` con la devolución en `PROCESSING`. |
| 7 | SPI | Lerian SPI | `pacs.002` | | El SPI informa la liquidación o el rechazo de la devolución. |
| 8 | Lerian SPI | Pix Lerian | Llamada interna | | Lerian SPI pasa el resultado a Pix Lerian. |
| 9 | Pix Lerian | Midaz | Llamada interna | | Solo para una devolución rechazada: Pix Lerian revierte el débito con una nueva transacción inversa. |
| 10 | Pix Lerian | Tu institución | API de Lerian | Evento `refund.completed` | La devolución se liquidó. Para una devolución que falló, el evento es `refund.failed`. |

## Reglas

***

* `reasonCode` es uno de `MD06` (devolución del Pix original), `SL02` (devolución de un Pix Saque o Pix Troco), `FR01` (fraude, MED) o `BE08` (falla operativa, MED).
* Las devoluciones de una transferencia suman como máximo el monto original.
* El BACEN acepta una devolución dentro de los 90 días de la liquidación del Pix original.
* Una devolución es un nuevo Pix y una nueva transacción en Midaz. La transferencia original y su transacción no cambian.

## Cómo saber que terminó

***

Pix Lerian publica `refund.completed` o `refund.failed`. [`GET /refunds/{id}`](https://docs.lerian.studio/es/reference/interfaces/pix-lerian/spi/get-refund) muestra el mismo resultado.

## Qué puede salir mal

***

| Situación | Qué ves | Qué hacer |
| - | - | - |
| El riel rechazó la devolución. | `422`, código `PIX-0013`. | La devolución no salió. Revisa la solicitud antes de enviar una nueva. |
| La solicitud terminó con un error, o no llegó ninguna respuesta. | `5xx`, `409` con código `PIX-0406`, o un timeout. | La devolución todavía puede estar en `PROCESSING`. Lista las devoluciones de la transferencia con [`GET /refunds`](https://docs.lerian.studio/es/reference/interfaces/pix-lerian/spi/list-refunds) y `transferId`. Envía una nueva solicitud solo cuando la devolución no esté ahí. |

La [lista de errores de Pix Lerian](https://docs.lerian.studio/es/reference/interfaces/pix-lerian/pix-lerian-error-list.md) describe cada código.

## Relacionados

***

* [Enviar y recibir Pix](https://docs.lerian.studio/es/diagrams/native-rails/send-and-receive-pix.md)
* [Reportar un fraude y recuperar fondos](https://docs.lerian.studio/es/diagrams/native-rails/report-a-fraud-and-recover-funds.md)
* [Usa SPI con Pix Lerian](https://docs.lerian.studio/es/interfaces/pix-lerian/pix-lerian-spi.md)


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