> ## 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 um Pix recebido > Devolva todo ou parte de um Pix que sua instituição recebeu, como uma devolução Pix no SPI, com o Pix Lerian e o Lerian SPI. Devolva todo ou parte de um Pix que uma das suas contas recebeu. > [!NOTE] > > Este fluxo é uma leitura sugerida dos manuais do BACEN para o Pix. Os manuais prevalecem sobre esta página. Sua instituição, como participante, valida o fluxo e o implementa sobre as APIs da Lerian. Veja [como ler os diagramas](https://docs.lerian.studio/pt/diagrams/introduction.md). ## Participantes *** * **Sua instituição.** O participante do Pix que recebeu o Pix original. Chama a API do Pix Lerian e recebe os eventos dele. * **Pix Lerian.** Conecta o Midaz ao Lerian SPI. Lança a devolução no Midaz e a entrega ao Lerian SPI. * **Midaz.** O ledger que guarda a conta que recebeu o Pix original. * **Lerian SPI.** Troca as mensagens do Pix com o SPI. * **SPI.** O sistema de pagamentos instantâneos do BACEN. Liquida a devolução. ## Antes de começar *** * O Pix original é uma transferência recebida em `COMPLETED`. Veja [Enviar e receber Pix](https://docs.lerian.studio/pt/diagrams/native-rails/send-and-receive-pix.md). * Seus sistemas recebem os eventos do Pix Lerian. Veja [Eventos do Pix Lerian](https://docs.lerian.studio/pt/interfaces/pix-lerian/pix-lerian-events.md). ## Diagrama *** ![Devolver um Pix recebido](https://mintcdn.com/lerian-49cb71fc/moPIbGcvckksJUDi/images/pt/d2/id-return-a-received-pix.svg?fit=max\&auto=format\&n=moPIbGcvckksJUDi\&q=85\&s=aefad06fe898ce25c6dde533d71ddcd5) ## Passo a passo *** | # | Origem | Destino | Mensagem | API da Lerian | O que acontece | | - | - | - | - | - | - | | 1 | Sua instituição | Pix Lerian | API da Lerian | [`POST /transfers/{id}/refunds`](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/spi/create-refund) | Peça a devolução da transferência original, com o valor, `reasonCode` e `reason`. Envie o cabeçalho `X-Idempotency`. | | 2 | Pix Lerian | Pix Lerian | Passo interno | | O Pix Lerian verifica se a transferência original aceita uma devolução desse valor. | | 3 | Pix Lerian | Midaz | Chamada interna | | O Pix Lerian debita a conta que recebeu o Pix original. A transação credita `@external/BRL`. | | 4 | Pix Lerian | Lerian SPI | Chamada interna | | O Pix Lerian envia a devolução. | | 5 | Lerian SPI | SPI | `pacs.004` | | O Lerian SPI envia a devolução ao SPI. | | 6 | Pix Lerian | Sua instituição | API da Lerian | Resposta ao passo 1 | O Pix Lerian responde `201` com a devolução em `PROCESSING`. | | 7 | SPI | Lerian SPI | `pacs.002` | | O SPI informa a liquidação ou a rejeição da devolução. | | 8 | Lerian SPI | Pix Lerian | Chamada interna | | O Lerian SPI repassa o resultado ao Pix Lerian. | | 9 | Pix Lerian | Midaz | Chamada interna | | Só para uma devolução rejeitada: o Pix Lerian reverte o débito com uma nova transação reversa. | | 10 | Pix Lerian | Sua instituição | API da Lerian | Evento `refund.completed` | A devolução foi liquidada. Para uma devolução que falhou, o evento é `refund.failed`. | ## Regras *** * `reasonCode` é um de `MD06` (devolução do Pix original), `SL02` (devolução de um Pix Saque ou Pix Troco), `FR01` (fraude, MED) ou `BE08` (falha operacional, MED). * As devoluções de uma transferência somam no máximo o valor original. * O BACEN aceita uma devolução em até 90 dias da liquidação do Pix original. * Uma devolução é um novo Pix e uma nova transação no Midaz. A transferência original e a transação dela não mudam. ## Como saber que terminou *** O Pix Lerian publica `refund.completed` ou `refund.failed`. [`GET /refunds/{id}`](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/spi/get-refund) mostra o mesmo resultado. ## O que pode dar errado *** | Situação | O que você vê | O que fazer | | - | - | - | | O trilho recusou a devolução. | `422`, código `PIX-0013`. | A devolução não saiu. Verifique o pedido antes de enviar um novo. | | O pedido terminou com erro, ou nenhuma resposta chegou. | `5xx`, `409` com código `PIX-0406`, ou um timeout. | A devolução ainda pode estar em `PROCESSING`. Liste as devoluções da transferência com [`GET /refunds`](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/spi/list-refunds) e `transferId`. Envie um novo pedido só quando a devolução não estiver lá. | A [lista de erros do Pix Lerian](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/pix-lerian-error-list.md) descreve cada código. ## Relacionados *** * [Enviar e receber Pix](https://docs.lerian.studio/pt/diagrams/native-rails/send-and-receive-pix.md) * [Comunicar uma fraude e recuperar fundos](https://docs.lerian.studio/pt/diagrams/native-rails/report-a-fraud-and-recover-funds.md) * [Usar o SPI com o Pix Lerian](https://docs.lerian.studio/pt/interfaces/pix-lerian/pix-lerian-spi.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.