Close an Infraction Report

curl --request POST \
  --url https://plugin-pix-indirect.api.lerian.net/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://plugin-pix-indirect.api.lerian.net/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://plugin-pix-indirect.api.lerian.net/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://plugin-pix-indirect.api.lerian.net/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"
}

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

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

{
  "message": "<string>",
  "code": "<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://plugin-pix-indirect.api.lerian.net/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://plugin-pix-indirect.api.lerian.net/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://plugin-pix-indirect.api.lerian.net/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://plugin-pix-indirect.api.lerian.net/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"
}

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

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

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

Authorizations

Authorization

string

header

required

JWT bearer token issued by the identity provider.

Path Parameters

infraction_id

string<uuid>

required

Unique identifier of the infraction report (UUID format)

Body

application/json

analysisResult

enum<string>

required

Analysis result: AGREED or DISAGREED

Available options:

AGREED,

DISAGREED

Minimum string length: 1

Example:

"AGREED"

analysisDetails

string

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

Maximum string length: 2000

Example:

"Fraud pattern confirmed through transaction history analysis"

fraudType

enum<string>

Type of fraud detected. Required if analysisResult is AGREED

Available options:

APPLICATION_FRAUD,

MULE_ACCOUNT,

SCAMMER_ACCOUNT,

OTHER,

UNKNOWN,

Example:

"SCAMMER_ACCOUNT"

Response

accountId

string

required

Account ID (UUID)

Example:

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

contactInformation

object

required

Contact information of the person reporting the fraud

Show child attributes

counterpartyParticipant

string

required

ISPB of the counterparty PSP involved in the transaction

Example:

"87654321"

createdAt

string<date-time>

required

Timestamp when the report was created (ISO 8601 UTC)

Example:

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

string

required

Unique identifier for the infraction report (UUID)

Example:

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

reason

string

required

Report reason type

Example:

"REFUND_REQUEST"

reporterParticipant

string

required

ISPB of the PSP reporting the infraction

Example:

"12345678"

situationType

string

required

Type of fraud situation

Example:

"SCAM"

status

enum<string>

required

Current status of the infraction report

Available options:

OPEN,

ACKNOWLEDGED,

CLOSED,

CANCELLED

Example:

"CLOSED"

transactionId

string

required

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

Example:

"E12345678202411241430ABCDEFGHIJK"

updatedAt

string<date-time>

required

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

Example:

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

analysisDetails

string

Detailed analysis from counterparty

Example:

"Analysis confirms fraudulent activity pattern"

analysisResult

enum<string>

Analysis result from counterparty

Available options:

AGREED,

DISAGREED

Example:

"AGREED"

bacenFundsRecoveryId

string

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

Example:

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

fraudMarkerId

string

Unique fraud marker identifier from BACEN

Example:

"FM123456789"

infractionAmount

string

Monetary amount of the infraction in BRL

Example:

"1500.00"

reportDetails

string

Detailed description of the fraud incident

Example:

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

DICT API

Claims API

MED · Infractions

MED · Fraud markers

MED · Refund requests

MED · Statistics

Transactions API

QR Codes API

Collections API

Funds Recovery API

Reconciliation API

Pix Automático API

Schedules API

Transaction Reports API

Transaction times

Webhooks API

Error handling

Close an Infraction Report

Authorizations

Path Parameters

Body

Response