Analisar solicitação de devolução MED
Registra o resultado de análise do PSP contestado. As invariantes condicional-obrigatórias são validadas antes de qualquer chamada ao upstream. Persiste a entidade de resposta do upstream (o watermark avançado) 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).
Parâmetros de caminho
O GUID da solicitação de devolução.
Corpo
Chave de idempotência derivada do negócio (Chave-Idempotencia).
Resultado da análise (0=Aceita Totalmente, 1=Aceita Parcialmente, 2=Rejeitada).
Detalhe da análise; obrigatório ao rejeitar com motivoRejeicao=4.
id da devolução pacs.004/008; obrigatório quando resultadoAnalise é 0 ou 1.
Motivo de rejeição (0,1,3,4); obrigatório quando resultadoAnalise=2.
Valor efetivamente devolvido, em centavos; obrigatório para um aceite parcial.
Resposta
OK
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.

