Create an Infraction Report

curl --request POST \
  --url https://plugin-pix-indirect.api.lerian.net/v1/dict/infraction-reports \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contactInformation": {
    "email": "customer@example.com",
    "phone": "+5511999999999"
  },
  "reason": "REFUND_REQUEST",
  "situationType": "SCAM",
  "transactionId": "E12345678202411241430ABCDEFGHIJK",
  "reportDetails": "Customer reported receiving a call from fake bank employee requesting PIX payment for supposed security verification"
}
'

package main

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

func main() {

	url := "https://plugin-pix-indirect.api.lerian.net/v1/dict/infraction-reports"

	payload := strings.NewReader("{\n  \"contactInformation\": {\n    \"email\": \"customer@example.com\",\n    \"phone\": \"+5511999999999\"\n  },\n  \"reason\": \"REFUND_REQUEST\",\n  \"situationType\": \"SCAM\",\n  \"transactionId\": \"E12345678202411241430ABCDEFGHIJK\",\n  \"reportDetails\": \"Customer reported receiving a call from fake bank employee requesting PIX payment for supposed security verification\"\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({
    contactInformation: {email: 'customer@example.com', phone: '+5511999999999'},
    reason: 'REFUND_REQUEST',
    situationType: 'SCAM',
    transactionId: 'E12345678202411241430ABCDEFGHIJK',
    reportDetails: 'Customer reported receiving a call from fake bank employee requesting PIX payment for supposed security verification'
  })
};

fetch('https://plugin-pix-indirect.api.lerian.net/v1/dict/infraction-reports', 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"

payload = {
    "contactInformation": {
        "email": "customer@example.com",
        "phone": "+5511999999999"
    },
    "reason": "REFUND_REQUEST",
    "situationType": "SCAM",
    "transactionId": "E12345678202411241430ABCDEFGHIJK",
    "reportDetails": "Customer reported receiving a call from fake bank employee requesting PIX payment for supposed security verification"
}
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": "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 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>"
}

Create an Infraction Report

deprecated

DEPRECATED: This endpoint is deprecated and will be removed in a future release due to MED 2.0 changes. The MED 2.0 specification introduces a new flow where infraction reports are replaced by a simplified dispute resolution mechanism handled through the Special Return flow.

Use this endpoint to report infractions associated to Pix transfers. This endpoint must be used when there is a fraud related to a transaction in scenarios where the client is the payer PSP, meaning the transaction was initiated and sent from an account within your arrangement.

Notes:

Transactions can only be reported within 90 days from the transaction date

POST

dict

infraction-reports

Create an Infraction Report

curl --request POST \
  --url https://plugin-pix-indirect.api.lerian.net/v1/dict/infraction-reports \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contactInformation": {
    "email": "customer@example.com",
    "phone": "+5511999999999"
  },
  "reason": "REFUND_REQUEST",
  "situationType": "SCAM",
  "transactionId": "E12345678202411241430ABCDEFGHIJK",
  "reportDetails": "Customer reported receiving a call from fake bank employee requesting PIX payment for supposed security verification"
}
'

package main

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

func main() {

	url := "https://plugin-pix-indirect.api.lerian.net/v1/dict/infraction-reports"

	payload := strings.NewReader("{\n  \"contactInformation\": {\n    \"email\": \"customer@example.com\",\n    \"phone\": \"+5511999999999\"\n  },\n  \"reason\": \"REFUND_REQUEST\",\n  \"situationType\": \"SCAM\",\n  \"transactionId\": \"E12345678202411241430ABCDEFGHIJK\",\n  \"reportDetails\": \"Customer reported receiving a call from fake bank employee requesting PIX payment for supposed security verification\"\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({
    contactInformation: {email: 'customer@example.com', phone: '+5511999999999'},
    reason: 'REFUND_REQUEST',
    situationType: 'SCAM',
    transactionId: 'E12345678202411241430ABCDEFGHIJK',
    reportDetails: 'Customer reported receiving a call from fake bank employee requesting PIX payment for supposed security verification'
  })
};

fetch('https://plugin-pix-indirect.api.lerian.net/v1/dict/infraction-reports', 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"

payload = {
    "contactInformation": {
        "email": "customer@example.com",
        "phone": "+5511999999999"
    },
    "reason": "REFUND_REQUEST",
    "situationType": "SCAM",
    "transactionId": "E12345678202411241430ABCDEFGHIJK",
    "reportDetails": "Customer reported receiving a call from fake bank employee requesting PIX payment for supposed security verification"
}
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": "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 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.

Body

application/json

contactInformation

object

required

Contact information of the person reporting the fraud

Show child attributes

reason

enum<string>

required

Report reason type

Available options:

REFUND_REQUEST,

REFUND_CANCELLED

Minimum string length: 1

Example:

"REFUND_REQUEST"

situationType

enum<string>

required

Type of fraud situation

Available options:

SCAM,

ACCOUNT_TAKEOVER,

COERCION,

FRAUDULENT_ACCESS,

OTHER,

UNKNOWN

Minimum string length: 1

Example:

"SCAM"

transactionId

string

required

Pix End-to-End transaction ID (32 characters)

Minimum string length: 1

Example:

"E12345678202411241430ABCDEFGHIJK"

reportDetails

string

Detailed description of the fraud incident (max 2000 characters)

Maximum string length: 2000

Example:

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

Response

Created

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 (8 uppercase alphanumeric characters)

Example:

"87654321"

createdAt

string<date-time>

required

Creation timestamp (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 (8 uppercase alphanumeric characters)

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:

"OPEN"

transactionId

string

required

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

Example:

"E12345678202411241430ABCDEFGHIJK"

updatedAt

string<date-time>

required

Last update timestamp (ISO 8601 UTC)

Example:

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

analysisDetails

string

Detailed analysis from counterparty (max 2000 characters)

Example:

"Analysis confirms fraudulent activity pattern"

analysisResult

enum<string>

Analysis result from counterparty (if closed)

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

Create an Infraction Report

Authorizations

Body

Response