Crear un reporte de infracción

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 '
{
  "transactionId": "E12345678202411241430ABCDEFGHIJK",
  "reason": "REFUND_REQUEST",
  "situationType": "SCAM",
  "reportDetails": "Customer reported receiving a call from fake bank employee"
}
'

import requests

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

payload = {
    "transactionId": "E12345678202411241430ABCDEFGHIJK",
    "reason": "REFUND_REQUEST",
    "situationType": "SCAM",
    "reportDetails": "Customer reported receiving a call from fake bank employee"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    transactionId: 'E12345678202411241430ABCDEFGHIJK',
    reason: 'REFUND_REQUEST',
    situationType: 'SCAM',
    reportDetails: 'Customer reported receiving a call from fake bank employee'
  })
};

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));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://plugin-pix-indirect.api.lerian.net/v1/dict/infraction-reports",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'transactionId' => 'E12345678202411241430ABCDEFGHIJK',
    'reason' => 'REFUND_REQUEST',
    'situationType' => 'SCAM',
    'reportDetails' => 'Customer reported receiving a call from fake bank employee'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

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  \"transactionId\": \"E12345678202411241430ABCDEFGHIJK\",\n  \"reason\": \"REFUND_REQUEST\",\n  \"situationType\": \"SCAM\",\n  \"reportDetails\": \"Customer reported receiving a call from fake bank employee\"\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))

}

HttpResponse<String> response = Unirest.post("https://plugin-pix-indirect.api.lerian.net/v1/dict/infraction-reports")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"transactionId\": \"E12345678202411241430ABCDEFGHIJK\",\n  \"reason\": \"REFUND_REQUEST\",\n  \"situationType\": \"SCAM\",\n  \"reportDetails\": \"Customer reported receiving a call from fake bank employee\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"transactionId\": \"E12345678202411241430ABCDEFGHIJK\",\n  \"reason\": \"REFUND_REQUEST\",\n  \"situationType\": \"SCAM\",\n  \"reportDetails\": \"Customer reported receiving a call from fake bank employee\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "019c96a0-0c98-799e-9135-4613ca469ad8",
  "transactionId": "E12345678202411241430ABCDEFGHIJK",
  "status": "OPEN",
  "reason": "REFUND_REQUEST",
  "reporterParticipant": "12345678",
  "counterpartyParticipant": "87654321",
  "analysisResult": "AGREED",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

Crear un reporte de infracción

Usa este endpoint para reportar infracciones asociadas a transferencias Pix. Este endpoint debe usarse cuando hay un fraude relacionado con una transacción en escenarios donde el cliente es el PSP del pagador, es decir, cuando la transacción fue iniciada y enviada desde una cuenta dentro de tu arreglo.

Notas:

Las transacciones solo pueden reportarse dentro de los 90 días desde la fecha de la transacción.

POST

dict

infraction-reports

Crear un reporte de infracción

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 '
{
  "transactionId": "E12345678202411241430ABCDEFGHIJK",
  "reason": "REFUND_REQUEST",
  "situationType": "SCAM",
  "reportDetails": "Customer reported receiving a call from fake bank employee"
}
'

import requests

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

payload = {
    "transactionId": "E12345678202411241430ABCDEFGHIJK",
    "reason": "REFUND_REQUEST",
    "situationType": "SCAM",
    "reportDetails": "Customer reported receiving a call from fake bank employee"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    transactionId: 'E12345678202411241430ABCDEFGHIJK',
    reason: 'REFUND_REQUEST',
    situationType: 'SCAM',
    reportDetails: 'Customer reported receiving a call from fake bank employee'
  })
};

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));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://plugin-pix-indirect.api.lerian.net/v1/dict/infraction-reports",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'transactionId' => 'E12345678202411241430ABCDEFGHIJK',
    'reason' => 'REFUND_REQUEST',
    'situationType' => 'SCAM',
    'reportDetails' => 'Customer reported receiving a call from fake bank employee'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

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  \"transactionId\": \"E12345678202411241430ABCDEFGHIJK\",\n  \"reason\": \"REFUND_REQUEST\",\n  \"situationType\": \"SCAM\",\n  \"reportDetails\": \"Customer reported receiving a call from fake bank employee\"\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))

}

HttpResponse<String> response = Unirest.post("https://plugin-pix-indirect.api.lerian.net/v1/dict/infraction-reports")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"transactionId\": \"E12345678202411241430ABCDEFGHIJK\",\n  \"reason\": \"REFUND_REQUEST\",\n  \"situationType\": \"SCAM\",\n  \"reportDetails\": \"Customer reported receiving a call from fake bank employee\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"transactionId\": \"E12345678202411241430ABCDEFGHIJK\",\n  \"reason\": \"REFUND_REQUEST\",\n  \"situationType\": \"SCAM\",\n  \"reportDetails\": \"Customer reported receiving a call from fake bank employee\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "019c96a0-0c98-799e-9135-4613ca469ad8",
  "transactionId": "E12345678202411241430ABCDEFGHIJK",
  "status": "OPEN",
  "reason": "REFUND_REQUEST",
  "reporterParticipant": "12345678",
  "counterpartyParticipant": "87654321",
  "analysisResult": "AGREED",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

Autorizaciones

Authorization

string

header

requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Cuerpo

application/json

transactionId

string

requerido

Identificador de transacción del SPI.

Ejemplo:

"E12345678202411241430ABCDEFGHIJK"

reason

enum<string>

requerido

Motivo de la infracción.

Opciones disponibles:

REFUND_REQUEST,

REFUND_CANCELLED

Ejemplo:

"REFUND_REQUEST"

situationType

string

Tipo de situación de fraude.

Ejemplo:

"SCAM"

reportDetails

string

Descripción detallada de la infracción.

Ejemplo:

"Customer reported receiving a call from fake bank employee"

Respuesta

Reporte de infracción creado correctamente.

string

Identificador único.

Ejemplo:

"019c96a0-0c98-799e-9135-4613ca469ad8"

transactionId

string

Identificador de transacción del SPI.

Ejemplo:

"E12345678202411241430ABCDEFGHIJK"

status

enum<string>

Estado actual.

Opciones disponibles:

OPEN,

ACKNOWLEDGED,

CLOSED,

CANCELLED

Ejemplo:

"OPEN"

reason

string

Motivo de la infracción.

Ejemplo:

"REFUND_REQUEST"

reporterParticipant

string

ISPB del participante que reporta.

Ejemplo:

"12345678"

counterpartyParticipant

string

ISPB de la contraparte.

Ejemplo:

"87654321"

analysisResult

string

Resultado del análisis de BACEN.

Ejemplo:

"AGREED"

createdAt

string<date-time>

Ejemplo:

"2024-01-15T10:30:00Z"

updatedAt

string<date-time>

Ejemplo:

"2024-01-15T10:30:00Z"

⌘I

Pix — Lerian SPI (mensajería nativa)

Pix — JD (interfaz, directo)

Pix — BTG (interfaz, indirecto)

TED — Lerian SPB (mensajería nativa)

TED — JD (interfaz)

Boletos — BTG (interfaz)

Lerian SILOC (mensajería nativa)

Lerian SLC (mensajería nativa)

Lerian STA (mensajería nativa)

Lerian SISBAJUD (mensajería nativa)

Lerian Consignado (mensajería nativa)

Crear un reporte de infracción

Autorizaciones

Cuerpo

Respuesta