Cómo gestionar métodos de pago del TPV
Configura los métodos de cobro disponibles en una ubicación: nombre, código, integración, modo de ejecución, disponibilidad, estado activo y usuarios autorizados cuando aplique.
En este artículo
Los métodos de pago determinan qué opciones de cobro puede usar el equipo en el TPV de una ubicación como Marea Gran Via.
Esta guía cubre la consulta, creación y edición del método. No incluye borrado, ejecución de pagos ni pruebas reales contra proveedor, bridge o hardware.
Antes de empezar
- Tener sesión iniciada y trabajar dentro de la ubicación correcta.
- Tener `tpv:view` o `tpv:manage` para ver la pestaña de métodos de pago.
- Tener `tpv:manage` para crear métodos o guardar cambios.
- Tener `users:view` o `users:manage` si se quiere restringir el método a usuarios concretos.
Instrucciones
- 1.
Abre métodos de pago
Entra en los ajustes del TPV y abre la pestaña de métodos de pago. La tabla muestra los métodos de la ubicación, ordenados por prioridad y nombre, con integración, ejecución, disponibilidad, estado y acciones de creación o edición.
- 2.
Crea o edita un método
Usa `Nuevo metodo` para crear un alta o `Editar` para abrir un método existente. En alta, el formulario parte de efectivo, ejecución manual, orden 0, activo y disponible para consumo en local.
- 3.
Completa los datos principales
Revisa nombre, código interno, integración, modo de ejecución, orden, estado activo, apertura de cajón y disponibilidad. Si no seleccionas usuarios autorizados, el método queda disponible para todos los usuarios de la ubicación.
- 4.
Ajusta la integración
La ejecución manual no requiere configuración técnica. La redirección pide una URL. La API de backend usa proveedor e identificador de comercio. La ejecución local puede requerir bridge, healthcheck, credenciales o campos propios de integraciones como `cashdro`, `cashlogy`, `cashguard`, `dataphone`, `glory` o `cashkeeper`.
- 5.
Guarda los cambios
Al guardar, la app crea o actualiza el método, refresca la lista de métodos y los ajustes del TPV, muestra confirmación y vuelve a la pantalla anterior.
Validaciones y límites
- El nombre del método de pago es obligatorio.
- El código debe ser único dentro de la ubicación; si se deja vacío al crear, se deriva del nombre.
- Con `tpv:view` se puede consultar, pero no guardar cambios.
- Si `execution_mode` es `redirect`, la URL es obligatoria.
- Si `execution_mode` es `terminal_local` sin modo mock, debe existir una URL de bridge.
- Los usuarios autorizados deben ser usuarios aceptados de la misma ubicación.
- La integración debe estar disponible para el país de la ubicación.
- El borrado pertenece a `tpv.payment-method.delete`, no a esta guía.
Resultado esperado
El método queda configurado para la ubicación activa y puede usarse en los flujos del TPV que consumen `payment_method_id`, según su estado, disponibilidad y restricciones de usuario.