Skip to main content
POST
Register a MED fraud marker

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Cuerpo

application/json
cpfCnpj
string
requerido

The flagged document.

Ejemplo:

"12345678901"

idempotencyKey
string
requerido

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.

Ejemplo:

"med-fraud-2024-0001"

tpFraude
integer<int64>
requerido

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

Ejemplo:

1

tpPessoa
integer<int64>
requerido

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

Ejemplo:

0

chave
string

The flagged Pix key, if known.

Ejemplo:

"user@example.com"

Respuesta

Accepted

cpfCnpj
string
requerido

The flagged document.

Ejemplo:

"12345678901"

dtHrCriacao
string
requerido

JDPI creation timestamp (RFC 3339 UTC).

Ejemplo:

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

dtHrUltModificacao
string
requerido

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

Ejemplo:

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

idMarcacaoFraude
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=Registrada, 1=Cancelada).

Ejemplo:

0

statusDescription
string
requerido

Human-readable stMarcacaoFraude label.

Ejemplo:

"Registrada"

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"

chave
string

The flagged Pix key, when known.

Ejemplo:

"user@example.com"

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"

idRelatoInfracao
string

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

Ejemplo:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

ispbRelatoInfracao
string

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

Ejemplo:

"87654321"