Close an Infraction Report

curl --request POST \
  --url https://api.example.com/v1/dict/infraction-reports/{infraction_id}/close \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "analysisResult": "AGREED",
  "analysisDetails": "Fraud pattern confirmed through transaction history analysis",
  "fraudType": "SCAMMER_ACCOUNT"
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/dict/infraction-reports/{infraction_id}/close"

	payload := strings.NewReader("{\n  \"analysisResult\": \"AGREED\",\n  \"analysisDetails\": \"Fraud pattern confirmed through transaction history analysis\",\n  \"fraudType\": \"SCAMMER_ACCOUNT\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    analysisResult: 'AGREED',
    analysisDetails: 'Fraud pattern confirmed through transaction history analysis',
    fraudType: 'SCAMMER_ACCOUNT'
  })
};

fetch('https://api.example.com/v1/dict/infraction-reports/{infraction_id}/close', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/v1/dict/infraction-reports/{infraction_id}/close"

payload = {
    "analysisResult": "AGREED",
    "analysisDetails": "Fraud pattern confirmed through transaction history analysis",
    "fraudType": "SCAMMER_ACCOUNT"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "contactInformation": {
    "email": "customer@example.com",
    "phone": "+5511999999999"
  },
  "counterpartyParticipant": "87654321",
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "reason": "REFUND_REQUEST",
  "reporterParticipant": "12345678",
  "situationType": "SCAM",
  "status": "CLOSED",
  "transactionId": "E12345678202411241430ABCDEFGHIJK",
  "updatedAt": "2023-11-07T06:45:30Z",
  "analysisDetails": "Analysis confirms fraudulent activity pattern",
  "analysisResult": "AGREED",
  "bacenFundsRecoveryId": "91d65e98-97c0-4b0f-b577-73625da1f9fc",
  "fraudMarkerId": "FM123456789",
  "infractionAmount": "1500.00",
  "reportDetails": "Customer reported receiving a call from fake bank employee requesting PIX payment for supposed security verification",
  "transactionDepth": 1
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "fields": {},
  "headers": {},
  "paths": {},
  "queryParams": {},
  "raw": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "fields": {},
  "headers": {},
  "paths": {},
  "queryParams": {},
  "raw": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "fields": {},
  "headers": {},
  "paths": {},
  "queryParams": {},
  "raw": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "fields": {},
  "headers": {},
  "paths": {},
  "queryParams": {},
  "raw": "<string>"
}

Close an Infraction Report

deprecated

DEPRECATED: This endpoint is deprecated and will be removed in a future release due to MED 2.0 changes. MED 2.0 manages infraction report updates through the Funds Recovery lifecycle.

Use this endpoint to submit the closure analysis for an infraction report received. This endpoint must be used to respond to infractions reported to your PSP, meaning when the account was the receiver of the transaction reported as fraud, within 7 days with the analysis result.

Notes:

Closing a report sets its status to CLOSED and records the analysis result
Once closed, the report cannot be modified
For REFUND_REQUEST infractions, the report must be closed by the payee’s PSP
For REFUND_CANCELLED infractions, the report must be closed by the payer’s PSP

POST

dict

infraction-reports

{infraction_id}

Close an Infraction Report

curl --request POST \
  --url https://api.example.com/v1/dict/infraction-reports/{infraction_id}/close \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "analysisResult": "AGREED",
  "analysisDetails": "Fraud pattern confirmed through transaction history analysis",
  "fraudType": "SCAMMER_ACCOUNT"
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/dict/infraction-reports/{infraction_id}/close"

	payload := strings.NewReader("{\n  \"analysisResult\": \"AGREED\",\n  \"analysisDetails\": \"Fraud pattern confirmed through transaction history analysis\",\n  \"fraudType\": \"SCAMMER_ACCOUNT\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    analysisResult: 'AGREED',
    analysisDetails: 'Fraud pattern confirmed through transaction history analysis',
    fraudType: 'SCAMMER_ACCOUNT'
  })
};

fetch('https://api.example.com/v1/dict/infraction-reports/{infraction_id}/close', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/v1/dict/infraction-reports/{infraction_id}/close"

payload = {
    "analysisResult": "AGREED",
    "analysisDetails": "Fraud pattern confirmed through transaction history analysis",
    "fraudType": "SCAMMER_ACCOUNT"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "contactInformation": {
    "email": "customer@example.com",
    "phone": "+5511999999999"
  },
  "counterpartyParticipant": "87654321",
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "reason": "REFUND_REQUEST",
  "reporterParticipant": "12345678",
  "situationType": "SCAM",
  "status": "CLOSED",
  "transactionId": "E12345678202411241430ABCDEFGHIJK",
  "updatedAt": "2023-11-07T06:45:30Z",
  "analysisDetails": "Analysis confirms fraudulent activity pattern",
  "analysisResult": "AGREED",
  "bacenFundsRecoveryId": "91d65e98-97c0-4b0f-b577-73625da1f9fc",
  "fraudMarkerId": "FM123456789",
  "infractionAmount": "1500.00",
  "reportDetails": "Customer reported receiving a call from fake bank employee requesting PIX payment for supposed security verification",
  "transactionDepth": 1
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "fields": {},
  "headers": {},
  "paths": {},
  "queryParams": {},
  "raw": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "fields": {},
  "headers": {},
  "paths": {},
  "queryParams": {},
  "raw": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "fields": {},
  "headers": {},
  "paths": {},
  "queryParams": {},
  "raw": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "fields": {},
  "headers": {},
  "paths": {},
  "queryParams": {},
  "raw": "<string>"
}

Autorizaciones

Authorization

string

header

requerido

JWT bearer token issued by the identity provider.

Parámetros de ruta

infraction_id

string<uuid>

requerido

Unique identifier of the infraction report (UUID format)

Cuerpo

application/json

analysisResult

enum<string>

requerido

Analysis result: AGREED or DISAGREED

Opciones disponibles:

AGREED,

DISAGREED

Minimum string length: 1

Ejemplo:

"AGREED"

analysisDetails

string

Detailed analysis notes. Max 2000 characters. Required if fraudType is OTHER

Maximum string length: 2000

Ejemplo:

"Fraud pattern confirmed through transaction history analysis"

fraudType

enum<string>

Type of fraud detected. Required if analysisResult is AGREED

Opciones disponibles:

APPLICATION_FRAUD,

MULE_ACCOUNT,

SCAMMER_ACCOUNT,

OTHER,

UNKNOWN,

Ejemplo:

"SCAMMER_ACCOUNT"

Respuesta

accountId

string

requerido

Account ID (UUID) of the contested Pix transfer when the report arrived through BTG; empty when it was opened through this API

Ejemplo:

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

contactInformation

object

requerido

Contact information of the person reporting the fraud

Show child attributes

counterpartyParticipant

string

requerido

ISPB of the counterparty PSP involved in the transaction

Ejemplo:

"87654321"

createdAt

string<date-time>

requerido

Timestamp when the report was created (ISO 8601 UTC)

Ejemplo:

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

string

requerido

Unique identifier for the infraction report (UUID)

Ejemplo:

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

reason

string

requerido

Report reason type

Ejemplo:

"REFUND_REQUEST"

reporterParticipant

string

requerido

ISPB of the PSP reporting the infraction

Ejemplo:

"12345678"

situationType

string

requerido

Type of fraud situation

Ejemplo:

"SCAM"

status

enum<string>

requerido

Current status of the infraction report

Opciones disponibles:

OPEN,

ACKNOWLEDGED,

CLOSED,

CANCELLED

Ejemplo:

"CLOSED"

transactionId

string

requerido

PIX End-to-End transaction ID (32 alphanumeric characters)

Ejemplo:

"E12345678202411241430ABCDEFGHIJK"

updatedAt

string<date-time>

requerido

Timestamp when the report was last updated (ISO 8601 UTC)

Ejemplo:

"2023-11-07T06:45:30Z"

analysisDetails

string

Detailed analysis from counterparty

Ejemplo:

"Analysis confirms fraudulent activity pattern"

analysisResult

enum<string>

Analysis result from counterparty

Opciones disponibles:

AGREED,

DISAGREED

Ejemplo:

"AGREED"

bacenFundsRecoveryId

string

BACEN/BTG funds-recovery identifier linking this infraction to its MED Funds Recovery process

Ejemplo:

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

fraudMarkerId

string

Unique fraud marker identifier from BACEN

Ejemplo:

"FM123456789"

infractionAmount

string

Monetary amount of the infraction in BRL

Ejemplo:

"1500.00"

reportDetails

string

Detailed description of the fraud incident

Ejemplo:

"Customer reported receiving a call from fake bank employee requesting PIX payment for supposed security verification"

transactionDepth

integer<int64>

Depth of the infraction's transaction in the DICT tracking graph (root = 1). Set by DICT; absent until DICT provides it.

Ejemplo:

1

API de DICT

API de Reclamaciones

MED · Infracciones

MED · Marcadores de fraude

MED · Solicitudes de devolución

MED · Estadísticas

API de Transacciones

API de Códigos QR

API de Cobros

API de Recuperación de Fondos

API de Conciliación

API de Pix Automático

API de Programaciones

API de Informes de Transacción

Tiempos de transacciones

API de Webhooks

Manejo de errores

Eventos

Close an Infraction Report

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta