Atualizar a recuperação de valores

Atualiza dados de uma Recuperação de Valores.

Este endpoint permite ao participante atualizar os campos SituationType, ContactInformatione ReportDetailsde uma Recuperação de Valores.

Importante saber que a atualização só é possível realizar quando o status da recuperação de valores estiver nos estados CREATED, TRACKEDou AWAITING_ANALYSIS. Qualquer outro estado não será possível realizar atualização utilizando esse endpoint.

Se caso você não saiba em qual estado se encontra sua recuperação de valores, poderá consultar através do endpoint de consultar recuperação de valores, lá trará através do campo "status" o estado atual e assim poderá saber se é possível fazer atualização ainda ou não na recuperação de valores desejada.

Atualiza uma recuperação de valores

Endpoint PUT /funds-recoveries/(FundsRecoveryId)

Exemplo de request

{
  "situationType":"SCAM",
  "reportDetails":"Transação feita através de QR Code falso em boleto",
  "contactInformation":{
    "email":"[email protected]",
    "phone":"+5561988887777"
  }
}

Exemplo de response sucesso

{
    "status": 200,
    "version": "string",
    "body": {
        "fundsRecoveryId": "ca1b9c01-ff9e-4a58-90ab-d31512e15ce0",
        "status": "AWAITING_ANALYSIS",
         "flowType": "AUTOMATED",
        "rootEndToEnd": "E9999901012341234123412345678900",
        "situationType": "SCAM",
        "reportDetails": "Transação feita através de QR Code falso em boleto",
        "contactInformation": {
            "email": "[email protected]",
            "phone": "+5561988887777"
        },
        "creationTime": "2020-01-17T10:00:00.000Z",
        "lastModified": "2020-01-17T10:00:00.000Z",
        "trackingGraph": {
            "minTransactionAmount": 200.00,
            "maxTransactions": 500,
            "hopWindow": "PT24H",
            "maxHops": 10
        }
    }
}

Exemplo de erro

{
    "status": 400,
    "version": "string",
    "error": {
        "errorCode": "string",
        "message": "string"
    }
}

Tabela de apoio

campo	obrigatoriedade	tipo	padrão / Enum / Detalhes	descrição
flowType	Obrigatório	string	Enum: "AUTOMATED"	Tipo de fluxo de trabalho.
rootEndToEnd	Obrigatório	string	(32 caracteres alfanuméricos)	Transação Raiz reportada como fraudulenta.
situationType	Obrigatório	string	Enum: "SCAM", "ACCOUNT_TAKEOVER", "COERCION", "FRAUDULENT_ACCESS", "OTHER", "UNKNOWN"	Tipo de situação que deu origem à Recuperação de Valores.
reportDetails	Opcional	string	Max. 2000 caracteres. Obrigatório se situationType = "OTHER".	Detalhes para ajudar na análise do PSP contraparte.
contactInformation	Obrigatório	object	-	Informações de contato do PSP participante criador do registro.
trackingGraphParameters	Opcional	object	Não deve ser preenchido se FlowType = "INTERACTIVE".	Parâmetros de geração do Grafo de Rastreamento.

contactInformation

campo	obrigatoriedade	tipo	Restrições/Detalhes
email	Obrigatório	string	Deve seguir um padrão de e-mail. E-mail para contato.
phone	Obrigatório	string	Padrão: (Ex: +5511987654321). Telefone para contato.

TrackingGraphParameters

campo	tipo	padrão (Default)	descrição
minTransactionAmount	number	Default: "200.00"	Valor mínimo da transação para ser considerada e incluída no grafo de rastreamento.
maxTransactions	integer	Default: 500	Número máximo de transações que o sistema deve rastrear.
hopWindow	string	Default: "PT24H"	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. (PT24H = 24 horas).
maxHops	integer	Max: 10 / Default: 5	Profundidade máxima do grafo de rastreamento, ou seja, quantas "camadas" de contas o dinheiro pode passar a partir da transação raiz.

Updated about 7 hours ago