Close an infraction report

curl --request POST \
  --url https://api.example.com/dict-hub/v1/dict/infraction-reports/{id}/close \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "analysisResult": "AGREED",
  "analysisDetails": "Mule account confirmed by anti-fraud analysis.",
  "fraudType": "MULE_ACCOUNT"
}
'

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"analysisResult\": \"AGREED\",\n  \"analysisDetails\": \"Mule account confirmed by anti-fraud analysis.\",\n  \"fraudType\": \"MULE_ACCOUNT\"\n}")

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

	req.Header.Add("X-Idempotency", "<x-idempotency>")
	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: {
    'X-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    analysisResult: 'AGREED',
    analysisDetails: 'Mule account confirmed by anti-fraud analysis.',
    fraudType: 'MULE_ACCOUNT'
  })
};

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

import requests

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

payload = {
    "analysisResult": "AGREED",
    "analysisDetails": "Mule account confirmed by anti-fraud analysis.",
    "fraudType": "MULE_ACCOUNT"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "bacenInfractionReportId": "018f8c1d-aaaa-7abc-9def-000000000010",
  "balanceBlocks": [
    {
      "amount": "1000.00",
      "attemptNumber": 1,
      "createdAt": "2026-06-18T12:00:00Z",
      "id": "018f8c1d-1234-7abc-9def-000000000002",
      "status": "PENDING",
      "updatedAt": "2026-06-18T12:05:00Z",
      "failureReason": "balance-lock group settle exceeds the settle ceiling",
      "spiBlockId": "018f8c1d-5678-7abc-9def-000000000003"
    }
  ],
  "contactInformation": {
    "email": "user@example.com",
    "phone": "+5511999999999"
  },
  "createdAt": "2026-06-18T12:00:00Z",
  "id": "018f8c1d-1234-7abc-9def-000000000001",
  "monitorAccount": false,
  "situationType": "SCAM",
  "status": "OPEN",
  "transactionId": "E12345678202601011200abcdef01234",
  "updatedAt": "2026-06-18T12:05:00Z",
  "analysisDetails": "Mule account confirmed by anti-fraud analysis.",
  "analysisResult": "AGREED",
  "bacenFundsRecoveryId": "018f8c1d-1111-7abc-9def-000000000001",
  "correlationId": "9f3a8b7e2c1d4e5a8b6f1a2b3c4d5e6f",
  "counterpartyParticipant": "87654321",
  "fraudMarkerId": "018f8c1d-bbbb-7abc-9def-000000000020",
  "fraudType": "MULE_ACCOUNT",
  "infractionAmount": "1500.00",
  "reportDetails": "conta usada repetidamente em golpes",
  "reporterParticipant": "12345678",
  "transactionDepth": 1
}

{
  "code": "PIX-0030",
  "title": "Idempotency Key Required",
  "message": "The Idempotency-Key header is required for this operation and must be within the accepted length."
}

{
  "type": "https://errors.lerian.studio/v1/PIX-0005",
  "title": "Forbidden",
  "status": 403,
  "detail": "You do not have permission to perform this operation.",
  "code": "PIX-0005"
}

{
  "type": "https://errors.lerian.studio/v1/PIX-0011",
  "title": "Not Found",
  "status": 404,
  "detail": "No entity was found for the given ID. Please make sure to use the correct ID.",
  "code": "PIX-0011"
}

{
  "type": "https://errors.lerian.studio/v1/PIX-0012",
  "title": "Conflict",
  "status": 409,
  "detail": "The entity already exists or conflicts with an existing resource.",
  "code": "PIX-0012"
}

{
  "code": "PIX-0031",
  "title": "Idempotency Key Conflict",
  "message": "The Idempotency-Key was already used with a different request."
}

{
  "type": "https://errors.lerian.studio/v1/PIX-0013",
  "title": "Unprocessable Entity",
  "status": 422,
  "detail": "The operation could not be processed due to a business rule violation.",
  "code": "PIX-0013"
}

{
  "type": "https://errors.lerian.studio/v1/PIX-0000",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "internal error",
  "code": "PIX-0000"
}

{
  "type": "https://errors.lerian.studio/v1/PIX-0071",
  "title": "Bad Gateway",
  "status": 502,
  "detail": "internal error",
  "code": "PIX-0071"
}

{
  "code": "ERR-0001",
  "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"
  }
}

Close an infraction report

Closes an ACKNOWLEDGED infraction report with the reporter verdict (AGREED or DISAGREED) and changes its status to CLOSED. DISAGREED attempts to release all PENDING balance blocks; failure to release an individual block does not fail the close. AGREED leaves the blocks unchanged. fraudType is required when analysisResult is AGREED, and analysisDetails is required when fraudType is OTHER. Any pre-state other than ACKNOWLEDGED returns 409. Reusing the original Idempotency-Key returns the first attempt response instead of re-evaluating the current state. The report must belong to the authenticated organization, otherwise 404 is returned.

POST

dict

infraction-reports

{id}

Close an infraction report

curl --request POST \
  --url https://api.example.com/dict-hub/v1/dict/infraction-reports/{id}/close \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "analysisResult": "AGREED",
  "analysisDetails": "Mule account confirmed by anti-fraud analysis.",
  "fraudType": "MULE_ACCOUNT"
}
'

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"analysisResult\": \"AGREED\",\n  \"analysisDetails\": \"Mule account confirmed by anti-fraud analysis.\",\n  \"fraudType\": \"MULE_ACCOUNT\"\n}")

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

	req.Header.Add("X-Idempotency", "<x-idempotency>")
	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: {
    'X-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    analysisResult: 'AGREED',
    analysisDetails: 'Mule account confirmed by anti-fraud analysis.',
    fraudType: 'MULE_ACCOUNT'
  })
};

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

import requests

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

payload = {
    "analysisResult": "AGREED",
    "analysisDetails": "Mule account confirmed by anti-fraud analysis.",
    "fraudType": "MULE_ACCOUNT"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "bacenInfractionReportId": "018f8c1d-aaaa-7abc-9def-000000000010",
  "balanceBlocks": [
    {
      "amount": "1000.00",
      "attemptNumber": 1,
      "createdAt": "2026-06-18T12:00:00Z",
      "id": "018f8c1d-1234-7abc-9def-000000000002",
      "status": "PENDING",
      "updatedAt": "2026-06-18T12:05:00Z",
      "failureReason": "balance-lock group settle exceeds the settle ceiling",
      "spiBlockId": "018f8c1d-5678-7abc-9def-000000000003"
    }
  ],
  "contactInformation": {
    "email": "user@example.com",
    "phone": "+5511999999999"
  },
  "createdAt": "2026-06-18T12:00:00Z",
  "id": "018f8c1d-1234-7abc-9def-000000000001",
  "monitorAccount": false,
  "situationType": "SCAM",
  "status": "OPEN",
  "transactionId": "E12345678202601011200abcdef01234",
  "updatedAt": "2026-06-18T12:05:00Z",
  "analysisDetails": "Mule account confirmed by anti-fraud analysis.",
  "analysisResult": "AGREED",
  "bacenFundsRecoveryId": "018f8c1d-1111-7abc-9def-000000000001",
  "correlationId": "9f3a8b7e2c1d4e5a8b6f1a2b3c4d5e6f",
  "counterpartyParticipant": "87654321",
  "fraudMarkerId": "018f8c1d-bbbb-7abc-9def-000000000020",
  "fraudType": "MULE_ACCOUNT",
  "infractionAmount": "1500.00",
  "reportDetails": "conta usada repetidamente em golpes",
  "reporterParticipant": "12345678",
  "transactionDepth": 1
}

{
  "code": "PIX-0030",
  "title": "Idempotency Key Required",
  "message": "The Idempotency-Key header is required for this operation and must be within the accepted length."
}

{
  "type": "https://errors.lerian.studio/v1/PIX-0005",
  "title": "Forbidden",
  "status": 403,
  "detail": "You do not have permission to perform this operation.",
  "code": "PIX-0005"
}

{
  "type": "https://errors.lerian.studio/v1/PIX-0011",
  "title": "Not Found",
  "status": 404,
  "detail": "No entity was found for the given ID. Please make sure to use the correct ID.",
  "code": "PIX-0011"
}

{
  "type": "https://errors.lerian.studio/v1/PIX-0012",
  "title": "Conflict",
  "status": 409,
  "detail": "The entity already exists or conflicts with an existing resource.",
  "code": "PIX-0012"
}

{
  "code": "PIX-0031",
  "title": "Idempotency Key Conflict",
  "message": "The Idempotency-Key was already used with a different request."
}

{
  "type": "https://errors.lerian.studio/v1/PIX-0013",
  "title": "Unprocessable Entity",
  "status": 422,
  "detail": "The operation could not be processed due to a business rule violation.",
  "code": "PIX-0013"
}

{
  "type": "https://errors.lerian.studio/v1/PIX-0000",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "internal error",
  "code": "PIX-0000"
}

{
  "type": "https://errors.lerian.studio/v1/PIX-0071",
  "title": "Bad Gateway",
  "status": 502,
  "detail": "internal error",
  "code": "PIX-0071"
}

{
  "code": "ERR-0001",
  "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. Client-supplied replay key, at most 64 bytes. A request without it is refused with PIX-0030 @ 400 before the handler runs. Replaying the same key with a divergent method, URL or body is PIX-0031 @ 412.

Required string length: 1 - 64

Parámetros de ruta

string

requerido

Infraction report internal ID (UUID format)

Ejemplo:

"018f8c1d-1234-7abc-9def-000000000001"

Cuerpo

application/json

analysisResult

enum<string>

requerido

Opciones disponibles:

AGREED,

DISAGREED

Ejemplo:

"AGREED"

analysisDetails

string

Ejemplo:

"Mule account confirmed by anti-fraud analysis."

fraudType

enum<string>

Opciones disponibles:

APPLICATION_FRAUD,

MULE_ACCOUNT,

SCAMMER_ACCOUNT,

OTHER

Ejemplo:

"MULE_ACCOUNT"

Respuesta

bacenInfractionReportId

string

requerido

Ejemplo:

"018f8c1d-aaaa-7abc-9def-000000000010"

balanceBlocks

object[] | null

requerido

Show child attributes

contactInformation

object

requerido

Show child attributes

createdAt

string<date-time>

requerido

Ejemplo:

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

string

requerido

Ejemplo:

"018f8c1d-1234-7abc-9def-000000000001"

monitorAccount

boolean

requerido

Ejemplo:

false

situationType

enum<string>

requerido

Opciones disponibles:

SCAM,

ACCOUNT_TAKEOVER,

COERCION,

FRAUDULENT_ACCESS,

OTHER,

UNKNOWN

Ejemplo:

"SCAM"

status

enum<string>

requerido

Opciones disponibles:

OPEN,

ACKNOWLEDGED,

CLOSED,

CANCELLED

Ejemplo:

"OPEN"

transactionId

string

requerido

Ejemplo:

"E12345678202601011200abcdef01234"

updatedAt

string<date-time>

requerido

Ejemplo:

"2026-06-18T12:05:00Z"

analysisDetails

string

Ejemplo:

"Mule account confirmed by anti-fraud analysis."

analysisResult

enum<string>

Opciones disponibles:

AGREED,

DISAGREED

Ejemplo:

"AGREED"

bacenFundsRecoveryId

string

Ejemplo:

"018f8c1d-1111-7abc-9def-000000000001"

correlationId

string

Ejemplo:

"9f3a8b7e2c1d4e5a8b6f1a2b3c4d5e6f"

counterpartyParticipant

string

Ejemplo:

"87654321"

fraudMarkerId

string

Ejemplo:

"018f8c1d-bbbb-7abc-9def-000000000020"

fraudType

enum<string>

Opciones disponibles:

APPLICATION_FRAUD,

MULE_ACCOUNT,

SCAMMER_ACCOUNT,

OTHER

Ejemplo:

"MULE_ACCOUNT"

infractionAmount

string

Ejemplo:

"1500.00"

reportDetails

string

Ejemplo:

"conta usada repetidamente em golpes"

reporterParticipant

string

Ejemplo:

"12345678"

transactionDepth

integer<int64>

Rango requerido: 1 <= x <= 2147483647

Ejemplo:

1

DICT y claves Pix

Cobros y códigos BR

Pagos y devoluciones

Manejo de errores

Close an infraction report

Autorizaciones

Encabezados

Parámetros de ruta

Cuerpo

Respuesta