Skip to main content
POST
Cancel a MED infraction

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Parámetros de ruta

idRelatoInfracao
string
requerido

The infraction GUID.

Ejemplo:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Cuerpo

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

Respuesta

OK

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 poll watermark.

Ejemplo:

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

endToEndId
string
requerido

EndToEndId of the suspect payment.

Ejemplo:

"E1234567820240101000000000000001"

idRelatoInfracao
string
requerido

Infraction GUID (the natural key).

Ejemplo:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

motivo
integer<int64>
requerido

Infraction motivo code (1=Solicitacao de devolucao, 2=Cancelamento da devolucao).

Ejemplo:

1

motivoDescription
string
requerido

Human-readable infraction motivo label.

Ejemplo:

"Solicitacao de devolucao"

pspContraParte
string
requerido

ISPB of the counterparty.

Ejemplo:

"87654321"

pspCriador
string
requerido

ISPB of the infraction creator.

Ejemplo:

"12345678"

status
integer<int64>
requerido

stRelatoInfracao lifecycle code (0=Aberto, 1=Recebido, 2=Cancelado, 3=Analisado).

Ejemplo:

0

statusDescription
string
requerido

Human-readable stRelatoInfracao label.

Ejemplo:

"Aberto"

tpSitOrigem
integer<int64>
requerido

Situation-origin code (0..5).

Ejemplo:

0

tpSitOrigemDescription
string
requerido

Human-readable tpSitOrigem label.

Ejemplo:

"Golpe/Estelionato"

detalhes
string

Free-text detail to help the recebedor analyse.

Ejemplo:

"Suspected scam."

detalhesAnalise
string

Analysis detail.

Ejemplo:

"Confirmed."

idMarcacaoFraude
string

Fraud-marker GUID, when analysis produced one.

Ejemplo:

"c3d4e5f6-a7b8-9012-cdef-345678901234"

idRecValores
string

Value-recovery GUID, when the infraction came from a recovery.

Ejemplo:

"b2c3d4e5-f6a7-8901-bcde-f23456789012"

resultadoAnalise
integer<int64>

Infraction analysis result (0=Aceita, 1=Rejeitada); null until analysed.

Ejemplo:

0

resultadoAnaliseDescription
string

Human-readable infraction analysis-result label.

Ejemplo:

"Aceita"

vlrInfracao
integer<int64>

Amount to block on the account, in centavos; null when absent.

Ejemplo:

15000