---
title: "Criar recuperação de valores"
method: POST
path: "/funds-recovery"
---

# Criar recuperação de valores

`POST /funds-recovery`

## Request body

- object
  - `flowType` 'AUTOMATED', required — Tipo de fluxo de trabalho "AUTOMATED" é criado e gerenciado pelo DICT
  - `rootEndToEnd` string, required — Transação Raiz reportada como fraudulenta. (32 caracteres alfanuméricos)
  - `situationType` 'SCAM' | 'FRAUDULENT_ACCESS' | 'OTHER' | 'UNKNOWN' | 'UNAUTHORIZED_TRANSACTION' | 'COERCION', required — Tipo de situação que deu origem à Recuperação de Valores.
  - `reportDetails` string — Detalhes para ajudar na análise do PSP contraparte. Max. 2000 caracteres. Obrigatório se situationType = "OTHER".
  - `contactInformation` object, required — Informações de contato do PSP participante criador do registro.
    - `email` string, required
    - `phone` string, required
  - `trackingGraphParameters` object, required
    - `minTransactionAmount` number — Valor mínimo da transação para ser considerada e incluída no grafo de rastreamento.
    - `maxTransactions` integer — Número máximo de transações que o sistema deve rastrear. podendo ser <=5
    - `hopWindow` string — Janela de tempo (duração) máxima permitida entre a entrada de um valor em uma conta e sua saída para ser considerada como parte do fluxo fraudulento. Podendo ser <=2h
    - `maxHops` integer — Profundidade máxima do grafo de rastreamento, ou seja, quantas "camadas" de contas o dinheiro pode passar a partir da transação raiz. Podendo ser <=10

## Response `200`

- object
  - `status` integer
  - `version` string
  - `body` object
    - `fundsRecoveryId` string
    - `status` string
    - `flowType` string
    - `rootEndToEnd` string
    - `situationType` string
    - `reportDetails` string
    - `contactInformation` object
      - `email` string
      - `phone` string
    - `creationTime` string
    - `lastModified` string
    - `trackingGraph` object
      - `minTransactionAmount` integer
      - `maxTransactions` integer
      - `hopWindow` string
      - `maxHops` integer

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/celcoin/apis/api-para-transa-es.md) · [All operations](https://skmtc.net/celcoin/apis/api-para-transa-es/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/celcoin/api-para-transa-es/revisions/85dd6188a37b/schema)
