Endpoints / Métodos de Pago

GET

Obtener método de pago

Obtiene el detalle de un método de pago por su identificador, dentro de la empresa del usuario autenticado.

GET/playment-methods/:id

Caso de Uso

Se usa cuando la aplicación necesita cargar los datos completos de un método de pago para una vista de detalle, un formulario de edición o una consulta puntual. Al usarlo, el usuario obtiene los datos del método de pago incluyendo su nombre, estado y fecha de registro.

Autenticación

Requiere token JWT en el header `Authorization: Bearer <token>`. Permite acceso a usuarios con rol jefe o empleado. La empresa y el usuario autenticado deben estar activos.

Parámetros de ruta

idstringobligatorio

Identificador del método de pago.

Body

No aplica.

Reglas de negocio

1

Solo un usuario con rol jefe o empleado puede consultar métodos de pago.

2

Solo permite consultar métodos de pago de la empresa del usuario autenticado.

3

La empresa del usuario autenticado debe estar activa.

4

El usuario autenticado debe estar activo.

5

La búsqueda se realiza por la combinación de id y la empresa del usuario autenticado.

Errores esperados

401No autorizado

No se envió un token JWT válido o el token no contiene información válida del usuario.

400El id de método de pago es requerido

No se envió el parámetro id en la ruta.

500La empresa no existe

La empresa asociada al usuario autenticado no fue encontrada.

500La empresa no está activa

La empresa asociada al usuario autenticado está inactiva.

500El usuario no existe

El usuario autenticado no fue encontrado dentro de su empresa.

500El usuario no pertenece a la empresa

El usuario autenticado no pertenece a la empresa indicada por su sesión.

500El usuario no puede acceder a otra empresa

El usuario autenticado intentó acceder a una empresa distinta a la suya.

500El usuario no es jefe, empleado o administrador

El rol del usuario no está permitido para acceder al módulo de métodos de pago.

500El usuario no es jefe o empleado

El usuario autenticado no tiene un rol permitido para consultar métodos de pago.

500El usuario no está activo

El usuario autenticado está inactivo y no puede usar el sistema.

500Método de pago no encontrado

No existe un método de pago con el id indicado dentro de la empresa del usuario autenticado.

Notas de uso

1

Este endpoint no recibe query params ni body.

2

Solo devuelve métodos de pago que pertenecen a la empresa del usuario autenticado.