Cancel a MED infraction
Cancels an infraction as the creator PSP (JDPI relato-infracao/cancelar, contract §2.3). Cancel is allowed at any time, even after Analisado. An unknown id returns a coded 404. Persists the JDPI response entity and returns it.
Authorizations
JWT bearer token issued by the identity provider.
Path Parameters
The infraction GUID.
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
Body
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.
"med-infraction-cancel-2024-0001"
Response
OK
JDPI creation timestamp (RFC 3339 UTC).
"2024-01-01T12:00:00.000Z"
JDPI last-modification timestamp (RFC 3339 UTC) — the poll watermark.
"2024-01-01T12:05:00.000Z"
EndToEndId of the suspect payment.
"E1234567820240101000000000000001"
Infraction GUID (the natural key).
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
Infraction motivo code (1=Solicitacao de devolucao, 2=Cancelamento da devolucao).
1
Human-readable infraction motivo label.
"Solicitacao de devolucao"
ISPB of the counterparty.
"87654321"
ISPB of the infraction creator.
"12345678"
stRelatoInfracao lifecycle code (0=Aberto, 1=Recebido, 2=Cancelado, 3=Analisado).
0
Human-readable stRelatoInfracao label.
"Aberto"
Situation-origin code (0..5).
0
Human-readable tpSitOrigem label.
"Golpe/Estelionato"
Free-text detail to help the recebedor analyse.
"Suspected scam."
Analysis detail.
"Confirmed."
Fraud-marker GUID, when analysis produced one.
"c3d4e5f6-a7b8-9012-cdef-345678901234"
Value-recovery GUID, when the infraction came from a recovery.
"b2c3d4e5-f6a7-8901-bcde-f23456789012"
Infraction analysis result (0=Aceita, 1=Rejeitada); null until analysed.
0
Human-readable infraction analysis-result label.
"Aceita"
Amount to block on the account, in centavos; null when absent.
15000

