Analizar una solicitud de devolución MED
Registra el resultado del análisis del PSP contestado. Las invariantes condicionalmente obligatorias se validan antes de cualquier llamada al upstream. Persiste la entidad de respuesta del upstream (la marca de agua avanzada) y la devuelve.
Autorizaciones
Autenticación con token JWT Bearer. Obtén el token desde el endpoint /v1/login/oauth/access_token
usando credenciales de cliente (clientId y clientSecret).
Incluye el token en el encabezado Authorization:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
El token expira después de 3600 segundos (1 hora).
Parámetros de ruta
The refund-request GUID. El GUID de la solicitud de devolución.
Cuerpo
Clave de idempotencia derivada del negocio (Chave-Idempotencia).
Resultado del análisis (0=Aceita Totalmente, 1=Aceita Parcialmente, 2=Rejeitada).
Detalle del análisis; obligatorio al rechazar con motivoRejeicao=4.
Id de devolucao pacs.004/008; obligatorio cuando resultadoAnalise es 0 o 1.
Motivo de rechazo (0,1,3,4); obligatorio cuando resultadoAnalise=2.
Monto realmente devuelto, en centavos; obligatorio para una aceptación parcial.
Respuesta
OK
True cuando el plazo de análisis se ha alcanzado o superado (calculado en el momento de la lectura); false cuando no hay plazo definido.
Marca de tiempo de creación en el upstream (RFC 3339 UTC).
Marca de tiempo de la última modificación en el upstream (RFC 3339 UTC): la marca de agua del sondeo.
EndToEndId del pago contestado o de la devolucao.
GUID de la solicitud de devolución (la clave natural).
ISPB del PSP contestado.
ISPB del PSP solicitante.
Código de motivo de la devolución (0=Falha Operacional, 1=Fraude, 3=Pix Automático).
Etiqueta legible para humanos del motivo de la devolución.
Código de ciclo de vida stSolDevolucao (0=Aberta, 1=Cancelada, 2=Analisada).
Etiqueta legible para humanos de stSolDevolucao.
Monto de devolución solicitado, en centavos.
Plazo de análisis del lado contestado; null para solicitudes del lado del emisor y terminales.
Detalle de texto libre.
Detalle del análisis.
Referencia de devolucao pacs.004/pacs.008, registrada en el análisis.
GUID de la recuperación de valores, cuando proviene de una recuperación.
GUID de la infracción vinculada, cuando hay fraude.
Motivo de rechazo (0,1,3,4); presente solo cuando el análisis rechazó la solicitud.
Etiqueta legible para humanos del motivo de rechazo.
Resultado del análisis de la devolución (0=Aceita Totalmente, 1=Aceita Parcialmente, 2=Rejeitada); null hasta que se analice.
Etiqueta legible para humanos del resultado del análisis de la devolución.
Monto realmente devuelto, en centavos; null cuando está ausente.

