Abrir una solicitud de devolución MED
Abre una solicitud de devolución como PSP solicitante. El ISPB solicitante se deriva de la configuración. Persiste la entidad de respuesta del upstream 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).
Cuerpo
EndToEndId del pago contestado (o id pacs.004 para un motivo de cancelación).
Clave de idempotencia derivada del negocio (Chave-Idempotencia).
Motivo de la devolución (0=Falha Operacional, 1=Fraude, 3=Pix Automático).
Monto de devolución solicitado, en centavos.
Detalle de texto libre; obligatorio cuando motivo=0 (Falha Operacional).
Respuesta
Aceptado
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.

