Open a MED refund request
Opens a refund request as the solicitante PSP. The requesting ISPB is derived from configuration. Persists the upstream response entity and returns it.
Authorizations
JWT Bearer token authentication. Obtain token from /v1/login/oauth/access_token endpoint
using client credentials (clientId and clientSecret).
Include token in Authorization header:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Token expires after 3600 seconds (1 hour).
Body
EndToEndId of the contested payment (or pacs.004 id for a cancellation motivo).
Business-derived idempotency key (Chave-Idempotencia).
Refund motivo (0=Falha Operacional, 1=Fraude, 3=Pix Automático).
Requested refund amount, in centavos.
Free-text detail; required when motivo=0 (Falha Operacional).
Response
Accepted
True when the analysis deadline has been reached or passed (computed at read time); false when no deadline is set.
Upstream creation timestamp (RFC 3339 UTC).
Upstream last-modification timestamp (RFC 3339 UTC) — the poll watermark.
EndToEndId of the contested payment or devolucao.
Refund-request GUID (the natural key).
ISPB of the contested PSP.
ISPB of the requesting PSP.
Refund motivo code (0=Falha Operacional, 1=Fraude, 3=Pix Automático).
Human-readable refund motivo label.
stSolDevolucao lifecycle code (0=Aberta, 1=Cancelada, 2=Analisada).
Human-readable stSolDevolucao label.
Requested refund amount, in centavos.
Contestado-side analysis deadline; null for filer-side and terminal requests.
Free-text detail.
Analysis detail.
pacs.004/pacs.008 devolucao reference, recorded at analysis.
Value-recovery GUID, when from a recovery.
Linked infraction GUID, when fraud.
Rejection reason (0,1,3,4); present only when the analysis rejected the request.
Human-readable rejection-reason label.
Refund analysis result (0=Aceita Totalmente, 1=Aceita Parcialmente, 2=Rejeitada); null until analysed.
Human-readable refund analysis-result label.
Amount actually refunded, in centavos; null when absent.

