> ## 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. # Comunicar uma fraude e recuperar fundos > Abra uma recuperação de fundos do MED no DICT para um Pix que seu cliente pagou em uma fraude, acompanhe-a e peça a devolução, com o Pix Lerian e o Lerian SPI. Comunique um Pix que seu cliente pagou em uma fraude e peça ao DICT que recupere os fundos. > [!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 do cliente pagador. Abre a recuperação e a acompanha. * **Pix Lerian.** Guarda a recuperação e publica cada mudança. * **Lerian SPI.** Troca a recuperação com o DICT e lê as mudanças dela no DICT. * **DICT.** O diretório do BACEN. Rastreia os fundos e conduz a recuperação com os participantes recebedores. ## Antes de começar *** * O Pix saiu de uma conta da sua instituição nos últimos 80 dias. Guarde o ID end-to-end dele. * 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 *** ### Abrir a recuperação ![Comunicar uma fraude e recuperar fundos: Abrir a recuperação](https://mintcdn.com/lerian-49cb71fc/AR-wpjGp5R6xEqsz/images/pt/d2/id-report-a-fraud-and-recover-funds-1.svg?fit=max\&auto=format\&n=AR-wpjGp5R6xEqsz\&q=85\&s=62d298457f5d6357e9572d17e7763163) | # | Origem | Destino | Mensagem | API da Lerian | O que acontece | | - | - | - | - | - | - | | 1 | Sua instituição | Pix Lerian | API da Lerian | [`POST /dict/funds-recoveries`](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/create-funds-recovery) | Abra a recuperação com a conta, o ID end-to-end do Pix em `rootTransactionId`, o `situationType` e o contato do seu cliente. Envie o cabeçalho `X-Idempotency`. | | 2 | Pix Lerian | Lerian SPI | Chamada interna | | O Pix Lerian envia a recuperação ao Lerian SPI. | | 3 | Lerian SPI | DICT | API do DICT | | O Lerian SPI abre a recuperação no DICT. | | 4 | Pix Lerian | Sua instituição | API da Lerian | Resposta ao passo 1 | O Pix Lerian responde `201` com a recuperação em `CREATED`. Um `202` significa que o DICT ainda não a confirmou: a recuperação fica `PENDING`. | | 5 | DICT | DICT | Passo interno | | O DICT rastreia para onde os fundos foram e abre os relatórios de infração da recuperação. | | 6 | Lerian SPI | DICT | API do DICT | | O Lerian SPI lê as mudanças da recuperação. | | 7 | Lerian SPI | Pix Lerian | Chamada interna | | O Lerian SPI repassa cada mudança ao Pix Lerian. | | 8 | Pix Lerian | Sua instituição | API da Lerian | Evento `funds_recovery.updated` | A recuperação mudou de status, por exemplo para `TRACKED` ou `ANALYSED`. | | 9 | Sua instituição | Pix Lerian | API da Lerian | [`GET /dict/funds-recoveries/{id}/tracking-graph`](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/get-funds-recovery-tracking-graph) | Leia para onde os fundos foram. | | 10 | Sua instituição | Pix Lerian | API da Lerian | [`GET /dict/funds-recoveries/{id}/infraction-reports`](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/list-funds-recovery-infraction-reports) | Leia os relatórios de infração da recuperação. | ### Pedir a devolução ![Comunicar uma fraude e recuperar fundos: Pedir a devolução](https://mintcdn.com/lerian-49cb71fc/AR-wpjGp5R6xEqsz/images/pt/d2/id-report-a-fraud-and-recover-funds-2.svg?fit=max\&auto=format\&n=AR-wpjGp5R6xEqsz\&q=85\&s=d11342bd6e04538b2bbc837f032e7c16) | # | Origem | Destino | Mensagem | API da Lerian | O que acontece | | - | - | - | - | - | - | | 1 | Sua instituição | Pix Lerian | API da Lerian | [`POST /dict/funds-recoveries/{id}/refund`](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/refund-funds-recovery) | Peça a devolução de uma recuperação em `ANALYSED`. Envie o cabeçalho `X-Idempotency`. | | 2 | Pix Lerian | Lerian SPI | Chamada interna | | O Pix Lerian envia o pedido de devolução ao Lerian SPI. | | 3 | Lerian SPI | DICT | API do DICT | | O Lerian SPI envia o pedido de devolução ao DICT. | | 4 | Pix Lerian | Sua instituição | API da Lerian | Resposta ao passo 1 | O Pix Lerian responde `200` com a recuperação em `REFUNDING`. | | 5 | Lerian SPI | DICT | API do DICT | | O Lerian SPI lê as mudanças da recuperação. | | 6 | Lerian SPI | Pix Lerian | Chamada interna | | O Lerian SPI repassa cada mudança ao Pix Lerian. | | 7 | Pix Lerian | Sua instituição | API da Lerian | Evento `funds_recovery.updated` | A recuperação fica `COMPLETED`. | ## Regras *** * `situationType` é um de `SCAM`, `ACCOUNT_TAKEOVER`, `COERCION`, `FRAUDULENT_ACCESS`, `OTHER` ou `UNKNOWN`. Com `OTHER`, descreva o caso em `reportDetails`. * Um Pix aceita uma recuperação. Uma recuperação cancelada também conta. * Uma recuperação é um caso no DICT. O status dela, sozinho, não mostra que os fundos voltaram. * Para encerrar uma recuperação, cancele-a com [`POST /dict/funds-recoveries/{id}/cancel`](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/cancel-funds-recovery). ## Como saber que terminou *** O Pix Lerian publica `funds_recovery.updated`, e [`GET /dict/funds-recoveries/{id}`](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/get-funds-recovery) mostra a recuperação em `COMPLETED`. ## O que pode dar errado *** | Situação | O que você vê | O que fazer | | - | - | - | | O Pix já tem uma recuperação. | `409`, código `PIX-0113`. | Acompanhe a recuperação que já existe. | | O Pix é mais antigo que o prazo do DICT. | `422`, código `PIX-0117`. | O DICT não aceita a recuperação. | | O DICT ainda não resolveu a operação. | `409`, código `PIX-0118`. | Guarde o `operationId`. Leia a recuperação mais tarde. Não envie um novo pedido. | | A recuperação não está em `ANALYSED`. | `409`, código `PIX-0114`. | Aguarde `funds_recovery.updated` com `ANALYSED`. | | A resposta a um pedido não chega. | Nenhuma resposta, ou um timeout. | Envie o mesmo pedido de novo com a mesma chave `X-Idempotency`. | 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 *** * [Devolver um Pix recebido](https://docs.lerian.studio/pt/diagrams/native-rails/return-a-received-pix.md) * [Usar o DICT com o Pix Lerian](https://docs.lerian.studio/pt/interfaces/pix-lerian/pix-lerian-dict.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.