PTS - Payment Adjustments
Documentación completa para instalar, configurar y utilizar el módulo PTS - Payment Adjustments en tu tienda PrestaShop.
¿Qué es PTS - Payment Adjustments?
PTS - Payment Adjustments es un módulo para PrestaShop que permite agregar recargos o descuentos según el método de pago que elige el cliente al finalizar la compra. Cada regla se configura por moneda, así que decides qué ajuste se aplica según la divisa del pedido.
En cuanto el cliente elige el método de pago, el recargo o el descuento entra en el total del carrito, antes de cobrar. Así, la pasarela de pago cobra directamente el importe final. En el resumen del carrito el recargo aparece como una línea «Tarifa de pago» y el descuento como «Descuento de pago», traducidos al idioma del cliente. La línea «Tarifa de pago» lleva su propia imagen, no muestra los botones para quitarla ni para cambiar la cantidad y, en PrestaShop 8 y 9, no cuenta como un artículo más del carrito.
- Si el cliente cambia el carrito después de elegir el método de pago (agrega o quita productos, cambia cantidades), el ajuste se vuelve a calcular solo.
- Si el carrito pasa más de una hora sin cambios, el ajuste caduca y se retira; se vuelve a aplicar cuando el cliente elige de nuevo el método de pago.
- El botón de pagar espera a que el ajuste esté aplicado. Si algo falla, el cliente ve un aviso con un enlace para reintentar.
Características Principales
Ajustes por Método de Pago
Configura recargos o descuentos según el método de pago que elige el cliente. El ajuste entra en el total del carrito antes de cobrar, así que la pasarela cobra el importe final.
Configuración por Moneda
Cada moneda tiene su propio importe. Si lo dejas vacío, la regla no se aplica en esa moneda (vacío no es lo mismo que cero).
Modos de Cálculo
Selecciona entre importe fijo o porcentaje para calcular el ajuste de pago.
Condiciones Avanzadas
Limita cada regla, si quieres, a ciertos grupos de clientes y a ciertos países de entrega.
Compatibilidad con otros Módulos
- Checkout nativo de PrestaShop y One Page Checkout PS v5: el ajuste se aplica en cuanto el cliente elige el método de pago, y el botón de pagar espera a que esté aplicado.
- PTS Stripe v5.1.2: el recargo o el descuento se incluye en el importe que cobra Stripe.
- PTS Redsys: el recargo o el descuento se incluye en el importe que cobra Redsys.
- Módulos de pago con varias opciones: la regla se crea por módulo de pago y vale para todas las opciones que ese módulo muestra en el checkout.
Pago rápido (exprés): el recargo o el descuento se incluye en los botones de pago rápido (Google Pay y Apple Pay) de
PTS Stripe y
PTS Redsys, tanto en el carrito como en la ficha de producto: el ajuste entra en el importe que el módulo de pago calcula para la hoja de la cartera y para el cobro, y el pedido lleva el ajuste como una línea más. Con el pago rápido de otros módulos el ajuste no se aplica; si usas alguno,
escríbenos y revisamos la compatibilidad.
Requisitos del Sistema
| Requisito |
Mínimo |
Recomendado |
| PrestaShop |
1.7.6 |
9.x |
| PHP |
7.2 |
8.1+ |
Instalación
Existen dos métodos para instalar el módulo en tu tienda PrestaShop, dependiendo de las características de tu servidor.
Método 1: Instalación desde el Back Office
1
Accede al Back Office
Inicia sesión en el panel de administración de tu tienda PrestaShop.
2
Navega a Módulos
Ve a Módulos → Gestor de módulos en el menú lateral.
3
Sube el módulo
Haz clic en "Subir un módulo" y selecciona el archivo ZIP descargado.
4
Instala y activa
Una vez subido, el módulo se instalará automáticamente. Haz clic en "Configurar" para comenzar.
Método 2: Instalación por FTP
Utiliza este método si el archivo ZIP es muy pesado y tu servidor no permite subirlo desde el Back Office debido a limitaciones de tamaño de subida.
1
Descomprime el archivo ZIP
Extrae el contenido del archivo ZIP en tu ordenador local.
2
Conéctate por FTP
Usa un cliente FTP (como FileZilla) para conectarte a tu servidor.
3
Sube la carpeta del módulo
Sube la carpeta del módulo a /modules/ en tu instalación de PrestaShop.
4
Instala desde el Back Office
Ve a Módulos → Gestor de módulos, busca el módulo y haz clic en "Instalar".
Posibles Problemas de Instalación
Conflictos de Override: Durante la instalación o activación del módulo, pueden surgir problemas relacionados con los archivos de override. Esto sucede cuando otro módulo ya ha modificado los mismos archivos del núcleo de PrestaShop.
Si experimentas errores de override al instalar o activar el módulo, no intentes resolverlo por tu cuenta si no tienes experiencia técnica. Contacta con nuestro equipo de soporte para recibir ayuda personalizada y resolver el conflicto de manera segura.
Contactar con Soporte
Configuración
Configura las opciones generales del módulo para controlar su comportamiento en tu tienda.
Opciones Generales
Estas opciones están en la pestaña «General» del módulo.
Nombre del descuento por método de pago
Nombre que ve el cliente para el descuento por método de pago en el carrito, el correo y la factura. Hay un campo por idioma: elige el idioma con el selector que tiene al lado. Si lo dejas vacío se usa el nombre por defecto: «Descuento de pago» en español y «Payment discount» en cualquier otro idioma. El cambio se aplica a los descuentos que se crean a partir de ese momento.
Modo de depuración
Sirve para probar el módulo antes de que lo vean tus clientes. Mientras está activo, los ajustes de pago solo se aplican a las direcciones IP indicadas en el campo «IP».
IP
Aparece al activar el modo de depuración. Escribe las direcciones IP que podrán ver los ajustes de pago; puedes añadir varias separadas por comas.
No hay un interruptor general para encender o apagar el módulo: cada ajuste se activa o se desactiva con su propio interruptor en la lista de la pestaña «Ajustes» (ver Activar o desactivar un ajuste).
Desde la versión 5.0.1 el panel ya no muestra las opciones «Habilitar módulo», «Mostrar en caja», «Mostrar en detalle del pedido», «Mostrar en factura» ni «Mostrar en el correo electrónico». El ajuste ya es una línea más del pedido y aparece siempre en el resumen del carrito, el correo de confirmación, la factura, el detalle del pedido del cliente y el pedido en el back-office. «Habilitar módulo» se sustituye por el interruptor de cada ajuste.
Gestión de Ajustes
En la pestaña «Ajustes» creas y gestionas las reglas de ajuste de pago: recargos o descuentos según el método de pago que elige el cliente. La lista muestra, para cada regla, el «Módulo de pago», el «Tipo de ajuste», el «Modo de cálculo», el «Estado» y las «Acciones».
Crear un Ajuste
Para crear un nuevo ajuste de pago, sigue estos pasos:
1
Accede a la sección Ajustes
Desde el panel del módulo, haz clic en la pestaña «Ajustes».
2
Haz clic en «Añadir ajuste»
El botón está en la parte superior derecha de la lista.
3
Configura los datos básicos
Completa los siguientes campos:
- Módulo de pago: el módulo de pago al que se aplica este ajuste. Si el módulo ofrece varias opciones de pago (por ejemplo, tarjeta y otros medios dentro del mismo módulo), la regla vale para todas ellas.
- Tipo de ajuste: «Tarifa» (un recargo que se suma al total) o «Descuento» (se resta del total).
- Modo de cálculo: «Fijado» (un importe fijo) o «Porcentaje» (un porcentaje del total del carrito; ver Cómo se elige y se calcula el ajuste).
- Activo: activa o desactiva el ajuste.
4
Define los importes por moneda
En el bloque «Montos por Moneda», escribe el importe o el porcentaje para cada moneda activa en tu tienda. Si dejas un campo vacío, la regla no se aplica en esa moneda: vacío no es lo mismo que cero.
5
Establece las condiciones (opcional)
En el bloque «Condiciones» puedes elegir:
- Grupos de clientes: los grupos a los que se aplica el ajuste. Se tiene en cuenta el grupo por defecto del cliente. Déjalo vacío para aplicarlo a todos.
- Países: los países en los que se aplica el ajuste. Se tiene en cuenta el país de la dirección de entrega. Déjalo vacío para aplicarlo a todos.
6
Guarda el ajuste
Haz clic en «Guardar».
Editar un Ajuste
Para editar un ajuste existente:
- Accede a la pestaña «Ajustes» del módulo.
- Busca en la lista el ajuste que deseas editar.
- Haz clic en el icono de lápiz de la columna «Acciones».
- Realiza los cambios necesarios en el formulario «Editar ajuste».
- Haz clic en «Guardar».
Activar o desactivar un Ajuste
Cada regla tiene un interruptor en la columna «Estado» de la lista. Es la forma de encender o apagar un ajuste sin borrarlo: una regla desactivada deja de aplicarse en el carrito, y puedes volver a activarla cuando quieras. El mismo interruptor aparece como «Activo» dentro del formulario de la regla.
Eliminar un Ajuste
Para eliminar un ajuste:
- Accede a la pestaña «Ajustes» del módulo.
- Busca en la lista el ajuste que deseas eliminar.
- Haz clic en el icono de papelera de la columna «Acciones».
- Confirma la acción en el diálogo que aparece.
Atención: eliminar un ajuste es una acción irreversible. Si solo quieres dejar de aplicarlo por un tiempo, desactívalo en lugar de borrarlo.
Cómo se elige y se calcula el Ajuste
Qué regla cuenta si hay varias
Para cada método de pago solo cuenta una regla: la activa más antigua, es decir, la primera que se creó entre las que están activas. El panel no permite cambiar ese orden.
Si esa regla no aplica al carrito (porque no tiene importe en la moneda del carrito o porque el cliente no cumple sus condiciones), no se aplica ningún ajuste: el módulo no pasa a la siguiente regla de ese método. Por eso lo más práctico es tener una sola regla activa por método de pago.
Cómo se calcula el importe
- Fijado: se suma o se resta el importe escrito para la moneda del carrito.
- Porcentaje: se calcula sobre el total del carrito con IVA, después de los descuentos y sin los gastos de envío.
- Si el importe de una moneda está vacío, la regla no se aplica en esa moneda. Vacío no es lo mismo que cero.
- El recargo lleva IVA: el módulo lo reparte entre los tipos de IVA de los productos del carrito, en proporción al peso de cada uno en el total. Si tienes dudas sobre cómo debe tributar el recargo en tu país, consúltalo con tu asesor.
Cómo se comprueban las condiciones
- Grupos de clientes: cuenta el grupo por defecto del cliente.
- Países: cuenta el país de la dirección de entrega. Mientras el cliente todavía no tiene dirección de entrega, la condición de país no se comprueba.
Lo que verás en tu Catálogo
Para que el ajuste forme parte del total del carrito, el módulo usa elementos propios de PrestaShop. Es normal encontrarlos en el back-office:
- Productos ocultos «Tarifa de pago»: se usan para los recargos. Hay uno por cada tipo de IVA y tienda. No se muestran en la tienda y no hace falta tocarlos; si se borran, el módulo los vuelve a crear cuando los necesita.
- Reglas de carrito con código
PAYA_FEE_…: se usan para los descuentos y aparecen en Catálogo > Descuentos. El módulo crea una para cada carrito y la borra cuando el ajuste deja de aplicarse; no hace falta tocarlas.
Permisos de Empleado
La pestaña «Ajustes» respeta los permisos del perfil de cada empleado sobre la pestaña del módulo:
- Para ver la lista de ajustes hace falta permiso de lectura.
- Para crear un ajuste hace falta permiso de creación.
- Para editarlo o activarlo y desactivarlo hace falta permiso de modificación.
- Para eliminarlo hace falta permiso de eliminación.
Así, un empleado con un perfil de solo lectura puede consultar las reglas, pero no crearlas, cambiarlas ni borrarlas.
Traducciones
El módulo incluye un editor de traducciones integrado que te permite personalizar todos los textos visibles en el frontend en cualquier idioma activo en tu tienda.
Editar Traducciones
1
Accede al editor de traducciones
Desde el panel del módulo, haz clic en la pestaña «Traducción».
2
Selecciona el idioma
Selecciona el idioma que deseas editar desde el selector desplegable.
3
Edita las traducciones
Modifica los textos que desees personalizar. Los textos se agrupan por archivo de traducción.
4
Guarda los cambios
Haz clic en «Guardar» para guardar los cambios en el idioma seleccionado.
Nota: Algunas expresiones usan la sintaxis %s para insertar valores dinámicos. No reemplaces ni modifiques esta sintaxis, o la funcionalidad dejará de funcionar correctamente.
Acciones Disponibles
El editor de traducciones ofrece las siguientes acciones:
Guardar
Guarda los cambios en el idioma seleccionado
Guardar y descargar
Guarda y descarga el archivo de traducción
Comparte con nosotros
Envía tu traducción al equipo de PresTeamShop
Editores de Código
El módulo incluye editores de código para personalizar los estilos CSS y JavaScript que se aplican en el frontend. Esto te permite ajustar la apariencia y comportamiento del módulo sin modificar directamente los archivos del módulo.
Precaución: Los cambios en CSS y JavaScript pueden afectar el funcionamiento del módulo. Si no tienes conocimientos técnicos, consulta con tu desarrollador antes de realizar cambios.
Editor CSS
El editor CSS te permite sobrescribir o añadir estilos personalizados que se cargarán en el frontend. Los cambios se almacenan en la configuración del módulo y se aplican automáticamente.
Para editar los estilos CSS:
- Accede a la pestaña «Editores de código» en el panel del módulo.
- Modifica el código CSS en el editor correspondiente.
- Haz clic en «Guardar» para guardar los cambios.
- Los estilos se aplicarán inmediatamente en el frontend.
Editor JavaScript
El editor JavaScript te permite añadir código JavaScript personalizado que se ejecutará en el frontend. Útil para añadir funcionalidades adicionales o modificar el comportamiento del módulo.
Para editar el código JavaScript:
- Accede a la pestaña «Editores de código» en el panel del módulo.
- Modifica el código JavaScript en el editor correspondiente.
- Haz clic en «Guardar» para guardar los cambios.
- El código se ejecutará automáticamente en el frontend.
Copias de Seguridad
El sistema de copias de seguridad integrado te permite guardar y restaurar la configuración completa del módulo, incluyendo:
- Configuración: Todas las opciones de configuración del módulo.
- Base de datos: Todas las tablas relacionadas con el módulo (ajustes, condiciones, importes).
- Archivos: Archivos de traducciones y código personalizado (CSS/JS).
Generar Copia de Seguridad
Para crear una copia de seguridad del módulo:
- Accede a la pestaña «Copias de seguridad» en el panel del módulo.
- Haz clic en el botón «Generar nueva copia de seguridad».
- El sistema creará un archivo ZIP con toda la configuración y datos del módulo.
- La copia de seguridad aparecerá en la lista «Copias de seguridad disponibles».
Se recomienda crear una copia de seguridad antes de realizar cambios importantes en la configuración del módulo o antes de actualizar a una nueva versión.
Subir Copia de Seguridad
Puedes subir una copia de seguridad previamente descargada para restaurarla en otra instalación:
- Accede a la pestaña «Copias de seguridad» del módulo.
- Haz clic en «Subir copia de seguridad».
- Selecciona el archivo ZIP de la copia de seguridad.
- El sistema subirá el archivo y lo añadirá a la lista de copias disponibles.
Copias de Seguridad Disponibles
En la sección «Copias de seguridad disponibles» verás todas las copias de seguridad disponibles con la siguiente información:
- Fecha: Fecha y hora de creación de la copia de seguridad.
- MD5: Hash MD5 del archivo para verificar su integridad.
- Nombre del archivo: Nombre del archivo ZIP.
- Tamaño: Tamaño del archivo.
- Acciones: Acciones disponibles (restaurar, descargar, eliminar).
Gestionar Copias de Seguridad
Para cada copia de seguridad disponible, puedes realizar las siguientes acciones:
Restaurar copia de seguridad
Restaura la configuración y datos
Descargar copia de seguridad
Descarga el archivo ZIP
Eliminar copia de seguridad
Elimina la copia de seguridad
Precaución: Restaurar una copia de seguridad sobrescribirá la configuración actual del módulo. Esta acción no se puede deshacer.
Para restaurar, haz clic en el botón «Restaurar copia de seguridad» de la copia que deseas recuperar y confirma la acción en el diálogo.
Soporte
Si necesitas ayuda adicional o tienes alguna pregunta sobre el módulo, estamos aquí para ayudarte.
