Create a MED value recovery
Opens a value recovery as the creator PSP. The creator ISPB is derived from configuration. grafoRastreamento.vlrMinTransacaoCents is a graph-traversal FILTER threshold, never a posting amount.
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
Creator-contact email (required).
Creator-contact phone (required).
EndToEndId of the root transaction being recovered.
Business-derived idempotency key (Chave-Idempotencia).
Situation code (0=Golpe, 1=Nao autorizada, 2=Coercao, 3=Acesso fraudulento, 4=Outros, 5=Desconhecida).
Free-text detail; required when tpSituacao=4 (Outros).
Response
Accepted
True when the devolver deadline has been reached or passed (computed at read time); false when no deadline is set.
Creator-contact email.
Creator-contact phone.
Upstream creation timestamp (RFC 3339 UTC).
Upstream last-modification timestamp (RFC 3339 UTC) — the watermark.
Value-recovery GUID (the natural key).
EndToEndId of the root transaction being recovered.
ISPB of the recovery creator.
stRecValores lifecycle code (0=Criada.. 6=Cancelada).
Human-readable stRecValores label.
Situation code (0..5).
Human-readable tpSituacao label.
Free-text detail (required when tpSituacao=4 Outros).
Creator-side 72h devolver deadline, from the Analise stage close; null unless this institution is the pspCriador on an Analisada recovery.

