Acknowledge an Infraction Report

Use this endpoint to acknowledge receipt of an infraction report notification. This endpoint is used by the counterparty participant to acknowledge that they have received and are aware of the infraction report filed against a transaction. The report must be in OPEN status to be acknowledged. This operation is idempotent.

POST /v1/dict/infraction-reports/{infraction_id}/acknowledge

Acknowledge an Infraction Report

cURL

curl --request POST \
  --url https://api.example.com/v1/dict/infraction-reports/{infraction_id}/acknowledge \
  --header 'Authorization: Bearer <token>'

200

{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "bacenInfractionReportId": "91d65e98-97c0-4b0f-b577-73625da1f9fc",
  "contactInformation": {
    "email": "[e-mail]",
    "phone": "[phone]"
  },
  "counterpartyParticipant": "87654321",
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "reason": "REFUND_REQUEST",
  "reporterParticipant": "12345678",
  "situationType": "SCAM",
  "status": "OPEN",
  "transactionId": "E12345678202411241430ABCDEFGHIJK",
  "updatedAt": "2023-11-07T05:31:56Z",
  "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",
  "transactionDepth": 1
}

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 to acknowledge (UUID format)

Respuesta

200

application/json

OK

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"

bacenInfractionReportId · string · requerido

BACEN/BTG infraction report external identifier

Ejemplo:

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

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"

id · 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:

"OPEN"

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-07T05:31:56Z"

analysisDetails · string

Detailed analysis from counterparty

Ejemplo:

"Analysis confirms fraudulent activity pattern"

analysisResult · enum<string>

Analysis result from counterparty (if closed)

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"

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