Skip to main content
PUT
Amend a MED value recovery

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider.

Parâmetros de caminho

idRecValores
string
obrigatório

The value-recovery GUID.

Exemplo:

"b2c3d4e5-f6a7-8901-bcde-f23456789012"

Corpo

application/json
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-amend-2024-0001"

tpSituacao
integer<int64>
obrigatório

New situation code (0..5).

Exemplo:

4

contatoEmail
string

New creator-contact email.

Exemplo:

"ops@example.com"

contatoTelefone
string

New creator-contact phone.

Exemplo:

"+5511999999999"

detalhes
string

New free-text detail; required when tpSituacao=4 (Outros).

Exemplo:

"Updated detail."

Resposta

OK

breached
boolean
obrigatório

True when the devolver deadline has been reached or passed (computed at read time); false when no deadline is set.

Exemplo:

false

contatoEmail
string
obrigatório

Creator-contact email.

Exemplo:

"ops@example.com"

contatoTelefone
string
obrigatório

Creator-contact phone.

Exemplo:

"+5511999999999"

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"

idRecValores
string
obrigatório

Value-recovery GUID (the natural key).

Exemplo:

"b2c3d4e5-f6a7-8901-bcde-f23456789012"

idTransacaoRaiz
string
obrigatório

EndToEndId of the root transaction being recovered.

Exemplo:

"E1234567820240101000000000000001"

pspCriador
string
obrigatório

ISPB of the recovery creator.

Exemplo:

"12345678"

status
integer<int64>
obrigatório

stRecValores lifecycle code (0=Criada .. 6=Cancelada).

Exemplo:

0

statusDescription
string
obrigatório

Human-readable stRecValores label.

Exemplo:

"Criada"

tpSituacao
integer<int64>
obrigatório

Situation code (0..5).

Exemplo:

0

tpSituacaoDescription
string
obrigatório

Human-readable tpSituacao label.

Exemplo:

"Golpe/Estelionato"

detalhes
string

Free-text detail (required when tpSituacao=4 Outros).

Exemplo:

"Suspected scam."

devolverDeadline
string

Creator-side 72h devolver deadline (RFC 3339 UTC; contract §2.22/§5), from the Analise stage close; null unless this institution is the pspCriador on an Analisada recovery.

Exemplo:

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

dictCorrelationId
string

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

Exemplo:

"a9f13566e19f5ca51329479a5bae60c5"

dictReturnedAt
string

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

Exemplo:

"2025-08-27T10:30:05.025Z"