Pular para o conteúdo principal
POST
/
v1
/
dict
/
funds-recoveries
Criar uma Solicitação de Recuperação de Recursos
curl --request POST \
  --url https://plugin-pix-indirect.api.lerian.net/v1/dict/funds-recoveries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contactInformation": {
    "email": "customer@example.com",
    "phone": "+5511999999999"
  },
  "rootTransactionId": "E12345678202411241430ABCDEFGHIJK",
  "situationType": "SCAM",
  "reportDetails": "Cliente reportou ter recebido uma ligação de um falso funcionário do banco",
  "trackingGraphParameters": {
    "hopWindow": "PT24H",
    "maxHops": 5,
    "maxTransactions": 500,
    "minTransactionAmount": "200.00"
  }
}
'
{
  "bacenFundsRecoveryId": "91d65e98-97c0-4b0f-b577-73625da1f9fc",
  "contactInformation": {
    "email": "customer@example.com",
    "phone": "+5511999999999"
  },
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "reportDetails": "Cliente reportou ter recebido uma ligação de um falso funcionário do banco",
  "reporterParticipant": "12345678",
  "rootTransactionId": "E12345678202411241430ABCDEFGHIJK",
  "situationType": "SCAM",
  "status": "CREATED",
  "trackingGraph": {
    "accounts": [
      {
        "id": 1,
        "openingDate": "2020-01-15",
        "ownerId": 1,
        "participant": "12345678"
      }
    ],
    "creationTime": "2023-11-07T05:31:56Z",
    "fundsRecoveryId": "550e8400-e29b-41d4-a716-446655440000",
    "parameters": {
      "hopWindow": "PT24H",
      "maxHops": 5,
      "maxTransactions": 500,
      "minTransactionAmount": "200.00"
    },
    "persons": [
      {
        "entityCreationDate": "2020-01-15",
        "id": 1,
        "type": "NATURAL_PERSON"
      }
    ],
    "rootTransactionId": "E12345678202411241430ABCDEFGHIJK",
    "transactions": [
      {
        "amount": 1000.5,
        "creditorAccountId": 2,
        "debtorAccountId": 1,
        "id": "E12345678202411241430ABCDEFGHIJK",
        "refundableAmount": 1000.5,
        "settlementTime": "2023-11-07T05:31:56Z"
      }
    ]
  },
  "updatedAt": "2023-11-07T05:31:56Z"
}

Autorizações

​
Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Corpo

application/json
​
contactInformation
object
obrigatório

ContactInformation contém as informações de contato da pessoa que reporta a fraude

​
rootTransactionId
string
obrigatório

RootTransactionID é o ID da transação Pix Fim a Fim original

Exemplo:

"E12345678202411241430ABCDEFGHIJK"

​
situationType
enum<string>
obrigatório

SituationType é o tipo de situação de fraude

Opções disponíveis:
SCAM,
ACCOUNT_TAKEOVER,
COERCION,
FRAUDULENT_ACCESS,
OTHER,
UNKNOWN
Exemplo:

"SCAM"

​
reportDetails
string

ReportDetails é a descrição detalhada do incidente de fraude

Maximum string length: 2000
Exemplo:

"Cliente reportou ter recebido uma ligação de um falso funcionário do banco"

​
trackingGraphParameters
object

TrackingGraphParameters contém parâmetros opcionais para a geração do grafo de rastreamento

Resposta

Created

​
bacenFundsRecoveryId
string
Exemplo:

"91d65e98-97c0-4b0f-b577-73625da1f9fc"

​
contactInformation
object
​
createdAt
string<date-time>
Exemplo:

"2023-11-07T05:31:56Z"

​
id
string
Exemplo:

"550e8400-e29b-41d4-a716-446655440000"

​
reportDetails
string
Exemplo:

"Cliente reportou ter recebido uma ligação de um falso funcionário do banco"

​
reporterParticipant
string
Exemplo:

"12345678"

​
rootTransactionId
string
Exemplo:

"E12345678202411241430ABCDEFGHIJK"

​
situationType
enum<string>
Opções disponíveis:
SCAM,
ACCOUNT_TAKEOVER,
COERCION,
FRAUDULENT_ACCESS,
OTHER,
UNKNOWN
Exemplo:

"SCAM"

​
status
enum<string>
Opções disponíveis:
CREATED,
TRACKED,
AWAITING_ANALYSIS,
ANALYSED,
REFUNDING,
COMPLETED,
CANCELLED
Exemplo:

"CREATED"

​
trackingGraph
object

TrackingGraph é o grafo de rastreamento gerado durante a criação (PRD 4.1 / US-01) Presente quando trackingGraphParameters foram fornecidos na requisição

​
updatedAt
string<date-time>
Exemplo:

"2023-11-07T05:31:56Z"