Get a MED refund request from the JDPI base
Returns a single refund request by its idSolDevolucao GUID read live from the JDPI base (JDPI devolucao/consultar, §8.2.26) — NOT from the local projection the sibling route serves, and NOT from the DICT-direct §8.2.39 query. It is the only refund read that carries dtHrRegistro: §8.2.25 (the listar the pollers run) does not return that field. The requesting ISPB is derived from the tenant binding. An unknown id returns a coded 404. Moves no money and persists nothing.
Authorizations
JWT bearer token issued by the identity provider.
Path Parameters
The refund-request GUID.
"d4e5f6a7-b8c9-0123-def4-56789012345a"
Response
OK
True when the analysis deadline has been reached or passed (computed at read time); false when no deadline is set.
false
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 contested payment or devolucao.
"E1234567820240101000000000000001"
Refund-request GUID (the natural key).
"d4e5f6a7-b8c9-0123-def4-56789012345a"
ISPB of the contested PSP.
"87654321"
ISPB of the requesting PSP.
"12345678"
Refund motivo code (0=Falha Operacional, 1=Fraude, 3=Pix Automatico).
1
Human-readable refund motivo label.
"Fraude"
stSolDevolucao lifecycle code (0=Aberta, 1=Cancelada, 2=Analisada).
0
Human-readable stSolDevolucao label.
"Aberta"
Requested refund amount, in centavos.
25000
Contestado-side analysis deadline (RFC 3339 UTC; contract §5, 6h Fraude / 48h otherwise); null for filer-side and terminal requests.
"2024-01-01T18:00:00.000Z"
Free-text detail.
"Operational failure."
Analysis detail.
"Insufficient balance."
dtHrRegistro — when the request was REGISTERED in the JDPI base (raw JDPI instant), distinct from dtHrCriacao (the DICT creation instant). Returned by the §8.2.26 JDPI-base read only.
"2021-08-06T10:33:08.241Z"
pacs.004/pacs.008 devolucao reference, recorded at analysis.
"D1234567820240101000000000000099"
Value-recovery GUID, when from a recovery.
"b2c3d4e5-f6a7-8901-bcde-f23456789012"
Linked infraction GUID, when fraud.
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
Rejection reason (0,1,3,4); present only when the analysis rejected the request.
0
Human-readable rejection-reason label.
"Falta de saldo"
Refund analysis result (0=Aceita Totalmente, 1=Aceita Parcialmente, 2=Rejeitada); null until analysed.
0
Human-readable refund analysis-result label.
"Aceita Totalmente"
Amount actually refunded, in centavos; null when absent.
25000

