Cancel a MED fraud marker
Cancels a fraud marker as the creator PSP (JDPI marcacao-fraude//cancelar, contract 2.17). 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"
Body
Client-supplied idempotency key: any stable business string. The plugin projects it deterministically into the GUID form JDPI requires (contract 6), so the same value always dedups against the same JDPI request and the raw value is never sent verbatim.
"med-fraud-cancel-2024-0001"
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"

