Refresh DICT infraction from BACEN

curl --request POST \
  --url https://api.example.com/api/v1/dict/infractions/{id}/refresh \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Idempotency: <x-idempotency>'

package main

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

func main() {

	url := "https://api.example.com/api/v1/dict/infractions/{id}/refresh"

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

	req.Header.Add("X-Idempotency", "<x-idempotency>")
	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {'X-Idempotency': '<x-idempotency>', Authorization: 'Bearer <token>'}
};

fetch('https://api.example.com/api/v1/dict/infractions/{id}/refresh', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/api/v1/dict/infractions/{id}/refresh"

headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>"
}

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

print(response.text)

{
  "createdAt": "2026-06-14T12:00:00Z",
  "endToEndId": "E12345678202607101200D3E4F5A6B7C",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "reason": "REFUND_REQUEST",
  "reportStatus": "SENT",
  "reportedByISPB": "12345678",
  "situationType": "SCAM",
  "status": "OPEN",
  "updatedAt": "2026-06-14T12:00:00Z",
  "acknowledgedAt": "2026-06-20T10:00:00Z",
  "analysisDeadlineAt": "2026-06-21T12:00:00Z",
  "analysisDetails": "<string>",
  "analysisResult": "AGREED",
  "bacen": {
    "correlationId": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
    "lastModified": "2026-06-14T12:00:00Z",
    "responseTime": "2026-06-14T12:00:00Z"
  },
  "bacenCreationTime": "2026-06-14T12:00:00Z",
  "contactInformation": {
    "email": "compliance@participant.example",
    "phone": "+5511999999999"
  },
  "counterpartyISPB": "87654321",
  "discoveredAt": "2026-06-20T09:00:00Z",
  "fraudMarkerId": "550e8400-e29b-41d4-a716-446655440002",
  "fundsRecoveryId": "550e8400-e29b-41d4-a716-446655440003",
  "infractionAmount": 1500,
  "originOperationId": "01930000-0000-7000-8000-000000000000",
  "reportDetails": "<string>",
  "reporterISPB": "12345678",
  "transactionDepth": 1
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

POST

api

dict

infractions

{id}

refresh

Refresh DICT infraction from BACEN

curl --request POST \
  --url https://api.example.com/api/v1/dict/infractions/{id}/refresh \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Idempotency: <x-idempotency>'

package main

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

func main() {

	url := "https://api.example.com/api/v1/dict/infractions/{id}/refresh"

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

	req.Header.Add("X-Idempotency", "<x-idempotency>")
	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {'X-Idempotency': '<x-idempotency>', Authorization: 'Bearer <token>'}
};

fetch('https://api.example.com/api/v1/dict/infractions/{id}/refresh', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/api/v1/dict/infractions/{id}/refresh"

headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>"
}

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

print(response.text)

{
  "createdAt": "2026-06-14T12:00:00Z",
  "endToEndId": "E12345678202607101200D3E4F5A6B7C",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "reason": "REFUND_REQUEST",
  "reportStatus": "SENT",
  "reportedByISPB": "12345678",
  "situationType": "SCAM",
  "status": "OPEN",
  "updatedAt": "2026-06-14T12:00:00Z",
  "acknowledgedAt": "2026-06-20T10:00:00Z",
  "analysisDeadlineAt": "2026-06-21T12:00:00Z",
  "analysisDetails": "<string>",
  "analysisResult": "AGREED",
  "bacen": {
    "correlationId": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
    "lastModified": "2026-06-14T12:00:00Z",
    "responseTime": "2026-06-14T12:00:00Z"
  },
  "bacenCreationTime": "2026-06-14T12:00:00Z",
  "contactInformation": {
    "email": "compliance@participant.example",
    "phone": "+5511999999999"
  },
  "counterpartyISPB": "87654321",
  "discoveredAt": "2026-06-20T09:00:00Z",
  "fraudMarkerId": "550e8400-e29b-41d4-a716-446655440002",
  "fundsRecoveryId": "550e8400-e29b-41d4-a716-446655440003",
  "infractionAmount": 1500,
  "originOperationId": "01930000-0000-7000-8000-000000000000",
  "reportDetails": "<string>",
  "reporterISPB": "12345678",
  "transactionDepth": 1
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Autorizaciones

Authorization

string

header

requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Idempotency

string

requerido

Required key used to prevent replaying the mutation.

Parámetros de ruta

string<uuid>

requerido

BACEN-assigned infraction resource UUID; a local record UUID never resolves here

Respuesta

Persisted local DICT infraction record

createdAt

string

requerido

Record creation timestamp (RFC 3339, UTC)

Ejemplo:

"2026-06-14T12:00:00Z"

endToEndId

string

requerido

BACEN end-to-end identifier (E2E ID) of the disputed PIX transaction

Ejemplo:

"E12345678202607101200D3E4F5A6B7C"

string

requerido

BACEN-assigned infraction resource UUID — the public, canonical identity of this record

Ejemplo:

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

reason

string

requerido

BACEN infraction notification reason: REFUND_REQUEST or REFUND_CANCELLED

Ejemplo:

"REFUND_REQUEST"

reportStatus

string

requerido

BACEN report delivery state. Always SENT at rest (a resource row is persisted only once BACEN has confirmed it; a rejected or ambiguous attempt creates no row).

Ejemplo:

"SENT"

reportedByISPB

string

requerido

ISPB (8 digits or uppercase letters) of the participant that reported the infraction

Ejemplo:

"12345678"

situationType

string

requerido

Situation that gave rise to the infraction: SCAM, ACCOUNT_TAKEOVER, COERCION, FRAUDULENT_ACCESS, OTHER, or UNKNOWN

Ejemplo:

"SCAM"

status

string

requerido

Local infraction lifecycle state: OPEN, ACKNOWLEDGED, CLOSED, or CANCELLED

Ejemplo:

"OPEN"

updatedAt

string

requerido

Last update timestamp (RFC 3339, UTC)

Ejemplo:

"2026-06-14T12:00:00Z"

acknowledgedAt

string

When a human acknowledged the notification (RFC 3339, UTC) — the local evidence that a person, not a scheduler, declared it received. Absent while status is OPEN.

Ejemplo:

"2026-06-20T10:00:00Z"

analysisDeadlineAt

string

When the DICT 8.4 §20.3 seven-day analysis window closes (RFC 3339, UTC), counted from bacenCreationTime. Absent while BACEN's creation instant has not been observed — an unknown anchor is not a deadline, and a local clock would put the deadline later than the one BACEN counts.

Ejemplo:

"2026-06-21T12:00:00Z"

analysisDetails

string

Free-text analysis details accompanying analysisResult; omitted until close (ours or the counterparty's, via refresh)

analysisResult

enum<string>

closeInfractionReport analysis outcome: AGREED or DISAGREED; omitted until close (ours or the counterparty's, via refresh)

Opciones disponibles:

AGREED,

DISAGREED

Ejemplo:

"AGREED"

bacen

object

BACEN's own operational envelope for its most recent interaction on this infraction, including its LastModified version; omitted when no BACEN interaction has ever landed on it.

Show child attributes

bacenCreationTime

string

When BACEN created this infraction notification (RFC 3339, UTC); distinct from createdAt

Ejemplo:

"2026-06-14T12:00:00Z"

contactInformation

object

BACEN-echoed regulator-facing contact

Show child attributes

counterpartyISPB

string

BACEN-assigned counterparty participant ISPB (ExtendedInfractionReport.CounterpartyParticipant)

Ejemplo:

"87654321"

discoveredAt

string

When THIS deployment first observed a notification created elsewhere (RFC 3339, UTC). Read against analysisDeadlineAt it separates an operator who did not act on a notification held for six days from a rail that discovered it minutes ago already six days old — a blocked feed or a deployment that was down. Absent for a notification this rail itself reported.

Ejemplo:

"2026-06-20T09:00:00Z"

fraudMarkerId

string

BACEN-assigned fraud marker id, present only after an AGREED close

Ejemplo:

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

fundsRecoveryId

string

BACEN-assigned funds-recovery id this infraction is linked to (MED 2.0); omitted for a standalone infraction

Ejemplo:

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

infractionAmount

number

BACEN-reported blockable amount, exact decimal (ExtendedInfractionReport.InfractionAmount); absent when BACEN's response omitted it

Ejemplo:

1500

originOperationId

string

Durable operation-intent id that produced this snapshot's current state, when known

Ejemplo:

"01930000-0000-7000-8000-000000000000"

reportDetails

string

Detail supplied for the counterparty PSP's analysis; present when the situation carries one

reporterISPB

string

BACEN-assigned reporter (payer) participant ISPB (ExtendedInfractionReport.ReporterParticipant)

Ejemplo:

"12345678"

transactionDepth

integer<int64>

MED tracking-graph layer of the disputed transaction (DICT 8.5 TransactionDepth): 1 for the root transaction, 2 for the second layer, and so on. Absent when BACEN has not stated a layer — notably for notifications answered before the 2026-10-26 vigencia.

Rango requerido: x >= 1

Ejemplo:

1