Saltar al contenido principal
POST
/
v1
/
med
/
fraud-markers
Registrar un marcador de fraude MED
curl --request POST \
  --url https://plugin-pix-direct.api.lerian.net/v1/med/fraud-markers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cpfCnpj": "<string>",
  "idempotencyKey": "<string>",
  "tpFraude": 123,
  "tpPessoa": 123,
  "chave": "<string>"
}
'
import requests

url = "https://plugin-pix-direct.api.lerian.net/v1/med/fraud-markers"

payload = {
"cpfCnpj": "<string>",
"idempotencyKey": "<string>",
"tpFraude": 123,
"tpPessoa": 123,
"chave": "<string>"
}
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({
cpfCnpj: '<string>',
idempotencyKey: '<string>',
tpFraude: 123,
tpPessoa: 123,
chave: '<string>'
})
};

fetch('https://plugin-pix-direct.api.lerian.net/v1/med/fraud-markers', 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-direct.api.lerian.net/v1/med/fraud-markers",
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([
'cpfCnpj' => '<string>',
'idempotencyKey' => '<string>',
'tpFraude' => 123,
'tpPessoa' => 123,
'chave' => '<string>'
]),
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-direct.api.lerian.net/v1/med/fraud-markers"

payload := strings.NewReader("{\n \"cpfCnpj\": \"<string>\",\n \"idempotencyKey\": \"<string>\",\n \"tpFraude\": 123,\n \"tpPessoa\": 123,\n \"chave\": \"<string>\"\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-direct.api.lerian.net/v1/med/fraud-markers")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"cpfCnpj\": \"<string>\",\n \"idempotencyKey\": \"<string>\",\n \"tpFraude\": 123,\n \"tpPessoa\": 123,\n \"chave\": \"<string>\"\n}")
.asString();
require 'uri'
require 'net/http'

url = URI("https://plugin-pix-direct.api.lerian.net/v1/med/fraud-markers")

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 \"cpfCnpj\": \"<string>\",\n \"idempotencyKey\": \"<string>\",\n \"tpFraude\": 123,\n \"tpPessoa\": 123,\n \"chave\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body
{
  "cpfCnpj": "<string>",
  "dtHrCriacao": "<string>",
  "dtHrUltModificacao": "<string>",
  "idMarcacaoFraude": "<string>",
  "ispb": "<string>",
  "status": 123,
  "statusDescription": "<string>",
  "tpFraude": 123,
  "tpFraudeDescription": "<string>",
  "tpPessoa": 123,
  "tpPessoaDescription": "<string>",
  "chave": "<string>",
  "idRelatoInfracao": "<string>",
  "ispbRelatoInfracao": "<string>"
}
{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "about:blank"
}

Autorizaciones

Authorization
string
header
requerido

Autenticación con token JWT Bearer. Obtén el token desde el endpoint /v1/login/oauth/access_token usando credenciales de cliente (clientId y clientSecret).

Incluye el token en el encabezado Authorization: Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

El token expira después de 3600 segundos (1 hora).

Cuerpo

application/json
cpfCnpj
string
requerido

El documento marcado.

idempotencyKey
string
requerido

Clave de idempotencia derivada del negocio (Chave-Idempotencia).

tpFraude
integer<int64>
requerido

Código de tipo de fraude en la creación (0=Falsidade ideologica, 1=Conta laranja, 2=Conta do fraudador, 3=Outra; 4 Desconhecida es de solo lectura).

tpPessoa
integer<int64>
requerido

Código de tipo de persona (0=Pessoa Fisica, 1=Pessoa Juridica).

chave
string

La clave Pix marcada, si se conoce.

Respuesta

Aceptado

cpfCnpj
string
requerido

El documento marcado.

dtHrCriacao
string
requerido

Marca de tiempo de creación en el upstream (RFC 3339 UTC).

dtHrUltModificacao
string
requerido

Marca de tiempo de la última modificación en el upstream (RFC 3339 UTC): la marca de agua.

idMarcacaoFraude
string
requerido

GUID del marcador de fraude (la clave natural).

ispb
string
requerido

ISPB del PSP creador.

status
integer<int64>
requerido

Código de ciclo de vida stMarcacaoFraude (0=Registrada, 1=Cancelada).

statusDescription
string
requerido

Etiqueta legible para humanos de stMarcacaoFraude.

tpFraude
integer<int64>
requerido

Código de tipo de fraude (0..4; 4=Desconhecida es de solo lectura).

tpFraudeDescription
string
requerido

Etiqueta legible para humanos de tpFraude.

tpPessoa
integer<int64>
requerido

Código de tipo de persona (0=Pessoa Fisica, 1=Pessoa Juridica).

tpPessoaDescription
string
requerido

Etiqueta legible para humanos de tpPessoa.

chave
string

La clave Pix marcada, cuando se conoce.

idRelatoInfracao
string

GUID de la infracción vinculada, cuando el marcador se creó automáticamente a partir de una infracción cerrada.

ispbRelatoInfracao
string

ISPB del PSP de la infracción vinculada, cuando se originó en una infracción.