Expirar una Solicitud de Pago

Descripción

Fuerza el cierre de una sesión de pago que se encuentra en estado pendiente.

Comportamiento según Estado Actual

Si la sesión está PENDING, pasa a EXPIRED inmediatamente.
Si ya estaba EXPIRED no hace nada.
Si la sesión está PAID, NO puede expirarse (regla de negocio - retorna error 422).

Efecto sobre Paradas SPIDI

Si la sesión estaba asociada como activa en una Parada SPIDI, al pasar a expired deja de estar activa y queda en el histórico de la parada, por lo que el usuario podrá ver el mensaje que se le deja en user_message.

Notas y Buenas Prácticas

Paradas SPIDI

No necesitas llamar a /payment-stops/payment-sessions/batch con un item con op = remove; al expirar, la sesión sale sola del conjunto activo de cualquier parada a la que esté asociada (queda en histórico).

Trazabilidad

Usa message_audit para auditoría (quién, cuándo, por qué).

Endpoint

POST /api/v1/payment-session/:session_id/expiration

Autenticación Requerida

Bearer / Token: BearerAuth

Requiere el uso de el token obtenido en /auth/login

Esquema: bearer (JWT)

Request

Responses

Operación exitosa. Si la sesión ya estaba en un estado final EXPIRED, se devuelve el registro original sin aplicar cambios.