Saltar al contenido principal
GET
Get a MED fraud marker

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Parámetros de ruta

idMarcacaoFraude
string
requerido

The fraud-marker GUID.

Ejemplo:

"c3d4e5f6-a7b8-9012-cdef-345678901234"

Parámetros de consulta

ispb
string

The ISPB of the direct participant this read is made as. This deployment may act as SEVERAL direct SPI participants - one ISPB each, each with its own JDPI credential - and a fraud marker names no row this deployment holds, so this field is the only thing that says which JD instance to ask. OPTIONAL while it acts as a single participant: omit it and that one answers. REQUIRED once it acts as several - omitted is 422 PIX-0127, and an ISPB this deployment does not act as is 422 PIX-0128. It is ROUTING DATA you supply and guarantee, exactly like payer_ispb on the limits routes: never a credential, never read from a header or a path, and it never widens what your token can reach. Read as the SAME participant that created the marker, or the JD you ask has never heard of it. Sending it empty (ispb=) reads the same as omitting it.

Pattern: ^[0-9A-Z]{8}$
Ejemplo:

"12345678"

Respuesta

OK

createdAt
string
requerido

JDPI creation timestamp (RFC 3339 UTC).

Ejemplo:

"2024-01-01T12:00:00.000Z"

fraudMarkerId
string
requerido

Fraud-marker GUID (the natural key).

Ejemplo:

"c3d4e5f6-a7b8-9012-cdef-345678901234"

ispb
string
requerido

ISPB of the creator PSP.

Ejemplo:

"12345678"

status
integer<int64>
requerido

stMarcacaoFraude lifecycle code (0=registered, 1=cancelled).

Ejemplo:

0

statusDescription
string
requerido

Human-readable stMarcacaoFraude label.

Ejemplo:

"Registrada"

taxId
string
requerido

The flagged document.

Ejemplo:

"12345678901"

tpFraude
integer<int64>
requerido

Fraud-type code (0..4; 4=Desconhecida is read-only).

Ejemplo:

1

tpFraudeDescription
string
requerido

Human-readable tpFraude label.

Ejemplo:

"Conta laranja"

tpPessoa
integer<int64>
requerido

Person-type code (0=Pessoa Fisica, 1=Pessoa Juridica).

Ejemplo:

0

tpPessoaDescription
string
requerido

Human-readable tpPessoa label.

Ejemplo:

"Pessoa Fisica"

updatedAt
string
requerido

JDPI last-modification timestamp (RFC 3339 UTC) — the watermark.

Ejemplo:

"2024-01-01T12:05:00.000Z"

dictCorrelationId
string

idCorrelacao — the DICT support identifier for this consultar call; quote it to JD when disputing whether the read happened.

Ejemplo:

"a7f12465e19f5ca51329479a5bae60c2"

dictReturnedAt
string

dtHrRetornoDict — when DICT answered this consultar (contract 2.16).

Ejemplo:

"2023-08-16T10:30:05.025Z"

infractionId
string

Linked infraction GUID, when the marker was auto-created from a closed infraction.

Ejemplo:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

infractionIspb
string

Linked infraction's PSP ISPB, when infraction-originated.

Ejemplo:

"87654321"

key
string

The flagged Pix key, when known.

Ejemplo:

"user@example.com"