Skip to main content
POST
Register a MED fraud marker

Authorizations

Authorization
string
header
required

JWT bearer token issued by the identity provider.

Body

application/json
cpfCnpj
string
required

The flagged document.

Example:

"12345678901"

idempotencyKey
string
required

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.

Example:

"med-fraud-2024-0001"

tpFraude
integer<int64>
required

Fraud-type code on create (0=Falsidade ideologica, 1=Conta laranja, 2=Conta do fraudador, 3=Outra; 4 Desconhecida is read-only).

Example:

1

tpPessoa
integer<int64>
required

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

Example:

0

chave
string

The flagged Pix key, if known.

Example:

"user@example.com"

Response

Accepted

cpfCnpj
string
required

The flagged document.

Example:

"12345678901"

dtHrCriacao
string
required

JDPI creation timestamp (RFC 3339 UTC).

Example:

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

dtHrUltModificacao
string
required

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

Example:

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

idMarcacaoFraude
string
required

Fraud-marker GUID (the natural key).

Example:

"c3d4e5f6-a7b8-9012-cdef-345678901234"

ispb
string
required

ISPB of the creator PSP.

Example:

"12345678"

status
integer<int64>
required

stMarcacaoFraude lifecycle code (0=Registrada, 1=Cancelada).

Example:

0

statusDescription
string
required

Human-readable stMarcacaoFraude label.

Example:

"Registrada"

tpFraude
integer<int64>
required

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

Example:

1

tpFraudeDescription
string
required

Human-readable tpFraude label.

Example:

"Conta laranja"

tpPessoa
integer<int64>
required

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

Example:

0

tpPessoaDescription
string
required

Human-readable tpPessoa label.

Example:

"Pessoa Fisica"

chave
string

The flagged Pix key, when known.

Example:

"user@example.com"

dictCorrelationId
string

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

Example:

"a7f12465e19f5ca51329479a5bae60c2"

dictReturnedAt
string

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

Example:

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

idRelatoInfracao
string

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

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

ispbRelatoInfracao
string

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

Example:

"87654321"