Skip to main content
POST
Register a MED fraud marker

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider.

Corpo

application/json
cpfCnpj
string
obrigatório

The flagged document.

Exemplo:

"12345678901"

idempotencyKey
string
obrigatório

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.

Exemplo:

"med-fraud-2024-0001"

tpFraude
integer<int64>
obrigatório

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

Exemplo:

1

tpPessoa
integer<int64>
obrigatório

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

Exemplo:

0

chave
string

The flagged Pix key, if known.

Exemplo:

"user@example.com"

Resposta

Accepted

cpfCnpj
string
obrigatório

The flagged document.

Exemplo:

"12345678901"

dtHrCriacao
string
obrigatório

JDPI creation timestamp (RFC 3339 UTC).

Exemplo:

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

dtHrUltModificacao
string
obrigatório

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

Exemplo:

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

idMarcacaoFraude
string
obrigatório

Fraud-marker GUID (the natural key).

Exemplo:

"c3d4e5f6-a7b8-9012-cdef-345678901234"

ispb
string
obrigatório

ISPB of the creator PSP.

Exemplo:

"12345678"

status
integer<int64>
obrigatório

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

Exemplo:

0

statusDescription
string
obrigatório

Human-readable stMarcacaoFraude label.

Exemplo:

"Registrada"

tpFraude
integer<int64>
obrigatório

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

Exemplo:

1

tpFraudeDescription
string
obrigatório

Human-readable tpFraude label.

Exemplo:

"Conta laranja"

tpPessoa
integer<int64>
obrigatório

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

Exemplo:

0

tpPessoaDescription
string
obrigatório

Human-readable tpPessoa label.

Exemplo:

"Pessoa Fisica"

chave
string

The flagged Pix key, when known.

Exemplo:

"user@example.com"

dictCorrelationId
string

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

Exemplo:

"a7f12465e19f5ca51329479a5bae60c2"

dictReturnedAt
string

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

Exemplo:

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

idRelatoInfracao
string

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

Exemplo:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

ispbRelatoInfracao
string

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

Exemplo:

"87654321"