Abrir solicitação de devolução MED
Abre uma solicitação de devolução como PSP solicitante. O ISPB solicitante é derivado da configuração. Persiste a entidade de resposta do upstream e a retorna.
Autorizações
Autenticacao por token JWT Bearer. Obtenha o token no endpoint /v1/login/oauth/access_token
usando credenciais do cliente (clientId e clientSecret).
Inclua o token no header Authorization:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
O token expira apos 3600 segundos (1 hora).
Corpo
EndToEndId do pagamento contestado (ou id do pacs.004 para um motivo de cancelamento).
Chave de idempotência derivada do negócio (Chave-Idempotencia).
Motivo da devolução (0=Falha Operacional, 1=Fraude, 3=Pix Automático).
Valor de devolução solicitado, em centavos.
Detalhe em texto livre; obrigatório quando motivo=0 (Falha Operacional).
Resposta
Aceito
True quando o prazo de análise foi atingido ou ultrapassado (computado no momento da leitura); false quando nenhum prazo está definido.
Data/hora de criação no upstream (RFC 3339 UTC).
Data/hora da última modificação no upstream (RFC 3339 UTC) — o watermark do poll.
EndToEndId do pagamento contestado ou devolução.
GUID da solicitação de devolução (a chave natural).
ISPB do PSP contestado.
ISPB do PSP solicitante.
Código de motivo da devolução (0=Falha Operacional, 1=Fraude, 3=Pix Automático).
Rótulo legível do motivo da devolução.
código de ciclo de vida stSolDevolucao (0=Aberta, 1=Cancelada, 2=Analisada).
Rótulo legível de stSolDevolucao.
Valor de devolução solicitado, em centavos.
Prazo de análise do lado contestado; nulo para o lado do solicitante e para requisições terminais.
Detalhe em texto livre.
Detalhe da análise.
referência da devolução pacs.004/pacs.008, registrada na análise.
GUID da recuperação de valores, quando a partir de uma recuperação.
GUID da infração vinculada, quando fraude.
Motivo de rejeição (0,1,3,4); presente somente quando a análise rejeitou a requisição.
Rótulo legível do motivo de rejeição.
Resultado de análise da devolução (0=Aceita Totalmente, 1=Aceita Parcialmente, 2=Rejeitada); nulo até ser analisada.
Rótulo legível do resultado de análise da devolução.
Valor efetivamente devolvido, em centavos; nulo quando ausente.

