> ## 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. # Reportar un fraude y recuperar fondos > Abre una recuperación de fondos del MED en el DICT para un Pix que tu cliente pagó en un fraude, síguela y solicita la devolución, con Pix Lerian y Lerian SPI. Reporta un Pix que tu cliente pagó en un fraude y pide al DICT que recupere los fondos. > [!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 cliente pagador. Abre la recuperación y la sigue. * **Pix Lerian.** Guarda la recuperación y publica cada cambio. * **Lerian SPI.** Intercambia la recuperación con el DICT y lee sus cambios en el DICT. * **DICT.** El directorio del BACEN. Rastrea los fondos y lleva la recuperación con los participantes receptores. ## Antes de empezar *** * El Pix salió de una cuenta de tu institución en los últimos 80 días. Guarda su ID end-to-end. * 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 *** ### Abrir la recuperación ![Reportar un fraude y recuperar fondos: Abrir la recuperación](https://mintcdn.com/lerian-49cb71fc/l2YPqqB1Osw1XPuf/images/es/d2/id-report-a-fraud-and-recover-funds-1.svg?fit=max\&auto=format\&n=l2YPqqB1Osw1XPuf\&q=85\&s=00441cc4b6cb25c8b7addf8633ab4feb) | # | Origen | Destino | Mensaje | API de Lerian | Qué ocurre | | - | - | - | - | - | - | | 1 | Tu institución | Pix Lerian | API de Lerian | [`POST /dict/funds-recoveries`](https://docs.lerian.studio/es/reference/interfaces/pix-lerian/dict/create-funds-recovery) | Abre la recuperación con la cuenta, el ID end-to-end del Pix en `rootTransactionId`, el `situationType` y el contacto de tu cliente. Envía el encabezado `X-Idempotency`. | | 2 | Pix Lerian | Lerian SPI | Llamada interna | | Pix Lerian envía la recuperación a Lerian SPI. | | 3 | Lerian SPI | DICT | API del DICT | | Lerian SPI abre la recuperación en el DICT. | | 4 | Pix Lerian | Tu institución | API de Lerian | Respuesta al paso 1 | Pix Lerian responde `201` con la recuperación en `CREATED`. Un `202` significa que el DICT todavía no la confirmó: la recuperación queda en `PENDING`. | | 5 | DICT | DICT | Paso interno | | El DICT rastrea adónde fueron los fondos y abre los informes de infracción de la recuperación. | | 6 | Lerian SPI | DICT | API del DICT | | Lerian SPI lee los cambios de la recuperación. | | 7 | Lerian SPI | Pix Lerian | Llamada interna | | Lerian SPI pasa cada cambio a Pix Lerian. | | 8 | Pix Lerian | Tu institución | API de Lerian | Evento `funds_recovery.updated` | La recuperación cambió de estado, por ejemplo a `TRACKED` o `ANALYSED`. | | 9 | Tu institución | Pix Lerian | API de Lerian | [`GET /dict/funds-recoveries/{id}/tracking-graph`](https://docs.lerian.studio/es/reference/interfaces/pix-lerian/dict/get-funds-recovery-tracking-graph) | Lee adónde fueron los fondos. | | 10 | Tu institución | Pix Lerian | API de Lerian | [`GET /dict/funds-recoveries/{id}/infraction-reports`](https://docs.lerian.studio/es/reference/interfaces/pix-lerian/dict/list-funds-recovery-infraction-reports) | Lee los informes de infracción de la recuperación. | ### Solicitar la devolución ![Reportar un fraude y recuperar fondos: Solicitar la devolución](https://mintcdn.com/lerian-49cb71fc/l2YPqqB1Osw1XPuf/images/es/d2/id-report-a-fraud-and-recover-funds-2.svg?fit=max\&auto=format\&n=l2YPqqB1Osw1XPuf\&q=85\&s=df1706bd664a07203f821b461924a0b3) | # | Origen | Destino | Mensaje | API de Lerian | Qué ocurre | | - | - | - | - | - | - | | 1 | Tu institución | Pix Lerian | API de Lerian | [`POST /dict/funds-recoveries/{id}/refund`](https://docs.lerian.studio/es/reference/interfaces/pix-lerian/dict/refund-funds-recovery) | Solicita la devolución de una recuperación en `ANALYSED`. Envía el encabezado `X-Idempotency`. | | 2 | Pix Lerian | Lerian SPI | Llamada interna | | Pix Lerian envía la solicitud de devolución a Lerian SPI. | | 3 | Lerian SPI | DICT | API del DICT | | Lerian SPI envía la solicitud de devolución al DICT. | | 4 | Pix Lerian | Tu institución | API de Lerian | Respuesta al paso 1 | Pix Lerian responde `200` con la recuperación en `REFUNDING`. | | 5 | Lerian SPI | DICT | API del DICT | | Lerian SPI lee los cambios de la recuperación. | | 6 | Lerian SPI | Pix Lerian | Llamada interna | | Lerian SPI pasa cada cambio a Pix Lerian. | | 7 | Pix Lerian | Tu institución | API de Lerian | Evento `funds_recovery.updated` | La recuperación queda en `COMPLETED`. | ## Reglas *** * `situationType` es uno de `SCAM`, `ACCOUNT_TAKEOVER`, `COERCION`, `FRAUDULENT_ACCESS`, `OTHER` o `UNKNOWN`. Con `OTHER`, describe el caso en `reportDetails`. * Un Pix admite una recuperación. Una recuperación cancelada también cuenta. * Una recuperación es un caso en el DICT. Su estado, por sí solo, no muestra que los fondos regresaron. * Para detener una recuperación, cancélala con [`POST /dict/funds-recoveries/{id}/cancel`](https://docs.lerian.studio/es/reference/interfaces/pix-lerian/dict/cancel-funds-recovery). ## Cómo saber que terminó *** Pix Lerian publica `funds_recovery.updated`, y [`GET /dict/funds-recoveries/{id}`](https://docs.lerian.studio/es/reference/interfaces/pix-lerian/dict/get-funds-recovery) muestra la recuperación en `COMPLETED`. ## Qué puede salir mal *** | Situación | Qué ves | Qué hacer | | - | - | - | | El Pix ya tiene una recuperación. | `409`, código `PIX-0113`. | Sigue la recuperación que ya existe. | | El Pix es más antiguo que el plazo del DICT. | `422`, código `PIX-0117`. | El DICT no acepta la recuperación. | | El DICT todavía no resolvió la operación. | `409`, código `PIX-0118`. | Guarda el `operationId`. Lee la recuperación más tarde. No envíes una nueva solicitud. | | La recuperación no está en `ANALYSED`. | `409`, código `PIX-0114`. | Espera `funds_recovery.updated` con `ANALYSED`. | | La respuesta a una solicitud no llega. | Ninguna respuesta, o un timeout. | Envía la misma solicitud otra vez con la misma clave `X-Idempotency`. | 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 *** * [Devolver un Pix recibido](https://docs.lerian.studio/es/diagrams/native-rails/return-a-received-pix.md) * [Usa DICT con Pix Lerian](https://docs.lerian.studio/es/interfaces/pix-lerian/pix-lerian-dict.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.