Skip to main content
GET
Get a MED refund request from the JDPI base

Authorizations

Authorization
string
header
required

JWT bearer token issued by the identity provider.

Path Parameters

idSolDevolucao
string
required

The refund-request GUID.

Example:

"d4e5f6a7-b8c9-0123-def4-56789012345a"

Response

OK

breached
boolean
required

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

Example:

false

dtHrCriacao
string
required

JDPI creation timestamp (RFC 3339 UTC).

Example:

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

dtHrUltModificacao
string
required

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

Example:

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

endToEndId
string
required

EndToEndId of the contested payment or devolucao.

Example:

"E1234567820240101000000000000001"

idSolDevolucao
string
required

Refund-request GUID (the natural key).

Example:

"d4e5f6a7-b8c9-0123-def4-56789012345a"

ispbContestado
string
required

ISPB of the contested PSP.

Example:

"87654321"

ispbSolicitante
string
required

ISPB of the requesting PSP.

Example:

"12345678"

motivo
integer<int64>
required

Refund motivo code (0=Falha Operacional, 1=Fraude, 3=Pix Automatico).

Example:

1

motivoDescription
string
required

Human-readable refund motivo label.

Example:

"Fraude"

status
integer<int64>
required

stSolDevolucao lifecycle code (0=Aberta, 1=Cancelada, 2=Analisada).

Example:

0

statusDescription
string
required

Human-readable stSolDevolucao label.

Example:

"Aberta"

valorDevolucao
integer<int64>
required

Requested refund amount, in centavos.

Example:

25000

analysisDeadline
string

Contestado-side analysis deadline (RFC 3339 UTC; contract §5, 6h Fraude / 48h otherwise); null for filer-side and terminal requests.

Example:

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

detalhes
string

Free-text detail.

Example:

"Operational failure."

detalhesAnalise
string

Analysis detail.

Example:

"Insufficient balance."

dtHrRegistro
string

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.

Example:

"2021-08-06T10:33:08.241Z"

endToEndIdDevolucao
string

pacs.004/pacs.008 devolucao reference, recorded at analysis.

Example:

"D1234567820240101000000000000099"

idRecValores
string

Value-recovery GUID, when from a recovery.

Example:

"b2c3d4e5-f6a7-8901-bcde-f23456789012"

idRelatoInfracao
string

Linked infraction GUID, when fraud.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

motivoRejeicao
integer<int64>

Rejection reason (0,1,3,4); present only when the analysis rejected the request.

Example:

0

motivoRejeicaoDescription
string

Human-readable rejection-reason label.

Example:

"Falta de saldo"

resultadoAnalise
integer<int64>

Refund analysis result (0=Aceita Totalmente, 1=Aceita Parcialmente, 2=Rejeitada); null until analysed.

Example:

0

resultadoAnaliseDescription
string

Human-readable refund analysis-result label.

Example:

"Aceita Totalmente"

valorDevolvido
integer<int64>

Amount actually refunded, in centavos; null when absent.

Example:

25000