Get a MED fraud marker
Returns a single fraud marker by its idMarcacaoFraude GUID, read live from JDPI (contract 2.16). An unknown id returns a coded 404.
Authorizations
JWT bearer token issued by the identity provider.
Path Parameters
The fraud-marker GUID.
"c3d4e5f6-a7b8-9012-cdef-345678901234"
Query Parameters
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.
^[0-9]{8}$"12345678"
Response
OK
The flagged document.
"12345678901"
JDPI creation timestamp (RFC 3339 UTC).
"2024-01-01T12:00:00.000Z"
JDPI last-modification timestamp (RFC 3339 UTC) — the watermark.
"2024-01-01T12:05:00.000Z"
Fraud-marker GUID (the natural key).
"c3d4e5f6-a7b8-9012-cdef-345678901234"
ISPB of the creator PSP.
"12345678"
stMarcacaoFraude lifecycle code (0=Registrada, 1=Cancelada).
0
Human-readable stMarcacaoFraude label.
"Registrada"
Fraud-type code (0..4; 4=Desconhecida is read-only).
1
Human-readable tpFraude label.
"Conta laranja"
Person-type code (0=Pessoa Fisica, 1=Pessoa Juridica).
0
Human-readable tpPessoa label.
"Pessoa Fisica"
The flagged Pix key, when known.
"user@example.com"
idCorrelacao — the DICT support identifier for this consultar call; quote it to JD when disputing whether the read happened.
"a7f12465e19f5ca51329479a5bae60c2"
dtHrRetornoDict — when DICT answered this consultar (contract 2.16).
"2023-08-16T10:30:05.025Z"
Linked infraction GUID, when the marker was auto-created from a closed infraction.
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
Linked infraction's PSP ISPB, when infraction-originated.
"87654321"

