PTS Redsys
Documentación completa para instalar, configurar y utilizar el módulo PTS Redsys en tu tienda PrestaShop.
¿Qué es PTS Redsys?
Pasarela de pago Redsys para PrestaShop. Cobra con tarjeta, enviando al comprador a la
página del banco o incrustando el formulario dentro de tu propio proceso de compra, y
también con Bizum y con las carteras Google Pay y Apple Pay. Cada método puede aparecer
en la lista de pagos del checkout, como botón de pago exprés, o de las dos formas.
Incluye reembolsos desde la ficha del pedido y el registro de todas las transacciones.
Ten en cuenta: Bizum y las carteras tienen que estar habilitados en tu
comercio Redsys, y que un comprador concreto vea Google Pay o Apple Pay depende además de
su dispositivo y su navegador. No todos los métodos aparecen para todos los compradores.
Características Principales
Tarjeta, dentro o fuera de la tienda
Cobra con tarjeta enviando al comprador a la página del banco, o incrustando el formulario dentro de tu propio proceso de compra con la integración InSite.
Bizum y carteras
Bizum, Google Pay y Apple Pay en el mismo módulo, cada uno activable por separado y con su propia configuración.
Pago exprés
Botones de cartera en la ficha de producto, el carrito o el checkout. La dirección y el transportista se eligen dentro de la propia cartera.
Reembolsos y transacciones
Devuelve un cobro desde la ficha del pedido, sin entrar en el portal del banco, y consulta el registro de todas las transacciones con su respuesta del TPV.
Copias de seguridad
Crea, restaura y gestiona copias de la configuración del módulo desde el propio back-office.
Multi-idioma
Editor de traducciones integrado, para cambiar cualquier texto visible sin tocar ficheros.
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
General
Ajustes transversales del módulo: el modo de prueba, el registro de diagnóstico y el
comportamiento del carrito y de los reembolsos. Accede desde Módulos → PTS Redsys → Configurar.
Depuración
Modo de depuración
Permite probar el módulo en tu propia tienda sin que los clientes se vean afectados. Con
esta opción activa, el módulo solo se comporta en modo de pruebas para las direcciones IP
que indiques debajo; el resto de visitantes sigue viendo el funcionamiento normal.
IP
Direcciones IP para las que se aplica el modo de depuración.
Nota: Se recomienda que habilite esta opción para probar el módulo en
su tienda antes de habilitarlo para los clientes.
Activar registros de depuración
Guarda información detallada de cada paso del cobro en los registros de PrestaShop, para
poder reconstruir qué ocurrió cuando algo falla.
Nota: las advertencias y los errores se guardan siempre; esta opción
añade además el detalle completo del flujo de pago. Desactívala en producción salvo que
estés investigando un problema.
Comportamiento
Mantener el carrito cuando falla el pago
Cuando un pago no se completa, el contenido del carrito se conserva para que el comprador
pueda intentarlo de nuevo sin volver a elegir los productos.
Habilitar reembolsos desde la página del pedido
Añade a la ficha del pedido en el back-office la posibilidad de devolver el importe
cobrado, total o parcialmente, sin entrar en el portal de Redsys. La devolución opera
sobre un pago ya cobrado y nunca puede superar lo que queda por devolver de ese pedido.
Nota: es Redsys quien ejecuta la devolución, así que puede rechazarla
por las condiciones de tu terminal (por ejemplo, plazos del contrato). Si una devolución
se rechaza, revisa el estado del pedido antes de repetirla.
Redsys
Los datos del terminal que te entrega tu banco. Sin ellos el módulo no ofrece ningún método de
pago: ni opciones en el checkout, ni botones exprés.
Datos del terminal
Entorno
Determina contra qué plataforma de Redsys se envían las operaciones.
Nota: Usa Prueba mientras integras; cambia a Producción para cobrar
tarjetas reales.
Nombre del comerciante
Nombre que se muestra al comprador en la pantalla de pago de Redsys.
Código de comerciante (FUC)
Número de comercio que identifica tu contrato ante Redsys.
Terminal
Número de terminal dentro de ese comercio. Un mismo comercio puede tener varios terminales,
y las condiciones de cada uno las fija el banco.
Clave secreta (SHA-256)
Clave con la que se firman todas las peticiones. Es el dato más sensible de la configuración.
Nota: La clave de firma Base64 proporcionada por tu banco para esta
terminal.
Anulación de moneda (numérica ISO)
Permite forzar la moneda con la que se envían las operaciones, en lugar de usar la del carrito.
Nota: Déjalo vacío para usar la moneda del carrito. Ejemplo: 978 para EUR.
Métodos de pago
Qué métodos de pago ofrece el módulo dentro del proceso de compra y cómo se comportan.
Tarjeta
Habilitar pago con tarjeta
Muestra el pago con tarjeta entre los métodos disponibles en el checkout.
Integración de tarjeta
Elige si el comprador termina el pago en la página de Redsys o dentro de tu tienda.
Nota: Redirección envía al cliente a la página alojada de Redsys;
InSite incrusta el formulario de tarjeta en el proceso de compra (sin redirección).
Elige uno.
Tipo de integración InSite
Prevista para ajustar la forma en que se incrusta el formulario de tarjeta con la
integración InSite.
Documentación de Redsys: detalle técnico de la integración InSite:
inSite en Redsys.
Próximamente: el ajuste se guarda, pero todavía no cambia la forma en
que se muestra el formulario. El pago InSite funciona con su presentación estándar.
Permitir guardar tarjetas para pagos futuros
Prevista para ofrecer al comprador dejar su tarjeta guardada en Redsys y no tener que
escribirla de nuevo en compras posteriores.
Próximamente: el ajuste se guarda, pero de momento no habilita el
guardado de tarjetas. Dejarlo activado hoy no tiene efecto.
Exención SCA: valor bajo
Solicita a Redsys que no pida la autenticación reforzada en los pedidos pequeños.
Nota: tu banco tiene que haber habilitado esta exención en el terminal,
y el emisor sigue llevando sus propios contadores (5 operaciones seguidas o 100 EUR
acumulados por tarjeta), así que el reto puede aparecer igualmente. En las
transacciones donde la exención se aplica, la responsabilidad por fraude pasa del emisor
a ti. Fundamento en la
documentación de SCA y PSD2 de Redsys.
Exención SCA: análisis de riesgo, hasta
Solicita a Redsys que no pida la autenticación reforzada en los pedidos que no superen el
importe que indiques.
Nota: escribe el techo que tu banco te haya concedido para el terminal,
en la moneda de la tienda; 0 la desactiva. La exención solo se reclama cuando Redsys la
autoriza para esa operación, y el emisor puede forzar el reto igualmente. En las
transacciones donde se aplica, la responsabilidad por fraude pasa del emisor a ti.
Tipo de transacción de tarjeta
Determina si el importe se cobra en el momento («Pago» / cobro inmediato) o solo se retiene
para capturarlo más adelante («Preautorización»). La preautorización reserva el importe en la
tarjeta pero no lo cobra: la captura se hace después desde la propia ficha del pedido, en el
back-office.
Nota: con «Preautorización» el dinero no está cobrado hasta que lo
capturas. No des por cobrado un pedido solo porque figure como autorizado, y ten en
cuenta que la retención caduca según los plazos que fije tu banco. Tu terminal de Redsys
tiene que admitir preautorizaciones para poder usarla. Detalle en la
documentación de preautorizaciones de Redsys.
Otros métodos
Habilitar Bizum
Ofrece Bizum como método de pago en el checkout.
Documentación de Redsys: Bizum tiene que estar habilitado en tu comercio
Redsys. Tienes el detalle en
su guía de Bizum.
Estado del pedido cuando se acepta el pago
Estado al que pasa el pedido en cuanto Redsys confirma que el cobro se ha realizado.
Pago exprés
Los botones de pago exprés de Google Pay y Apple Pay permiten comprar sin pasar por el proceso
de compra completo: la dirección de envío y el transportista se eligen dentro de la propia
cartera. Aquí se configuran también las carteras como opción de pago del checkout.
Colocación de los botones
Página de producto: posición del botón
Dónde se colocan los botones exprés dentro de la ficha de producto.
Nota: las primeras tres opciones dependen de tu tema; usa «Selector CSS
personalizado» cuando ninguna se muestre en la posición que necesitas.
Selector CSS
Elemento de tu tema junto al que se inyectan los botones en la ficha de producto.
Posición relativa al elemento
Si los botones se colocan antes o después del elemento indicado.
Mostrar en una ubicación personalizada (selector CSS)
Coloca además los botones en cualquier otro punto de la tienda, por ejemplo el cajón del carrito.
Nota: el botón solo aparece cuando el carrito tiene productos, y se
vuelve a colocar solo cuando el carrito cambia. Dondequiera que se ponga (incluso en
una ficha de producto) siempre paga por el carrito actual, no por un
producto suelto.
Apariencia y envío
Altura del botón (px)
Alto de los botones de las carteras, para ajustarlos a los de tu tema.
Radio de esquina del botón (px)
Redondeo de las esquinas de los botones.
Nota: se aplica tanto al botón de Google Pay como al de Apple Pay, para
que casen entre ellos y con tu tema. Google Pay dibuja su botón completamente redondeado
por defecto, que no se parece en nada al botón cuadrado de Apple Pay.
Ocultar transportistas
Transportistas que no deben ofrecerse dentro de la ventana de la cartera.
Nota: úsalo para transportistas de puntos de recogida, que necesitan que
el cliente elija una ubicación física. Déjalo vacío para mostrarlos todos.
Google Pay
Documentación de Redsys: el alta de Google Pay (registrar el dominio y
obtener el identificador de comercio) se hace en el portal de Redsys, siguiendo
su guía de Google Pay.
Activar Google Pay
Interruptor principal de Google Pay: mientras esté apagado no se muestra ni como opción de
pago ni como botón exprés.
Mostrar como opción de pago
Muestra Google Pay como una opción más dentro de la lista de métodos de pago del checkout.
Mostrar en la página de producto
Coloca el botón exprés de Google Pay en la ficha de producto.
Mostrar en la página del carrito
Coloca el botón exprés de Google Pay en el carrito.
Mostrar en la página de checkout
Coloca el botón exprés de Google Pay en el proceso de compra.
Texto del botón
Leyenda que muestra el botón de Google Pay.
Tema del botón
Color del botón de Google Pay.
ID de comerciante de Google Pay
Identificador que Google asigna a tu comercio.
Nota: son 12-18 caracteres y los emite la Consola de Google Pay &
Wallet después de registrar el dominio de tu tienda. Google lo exige en Producción: sin
él, la ventana de pago falla con «Este comercio tiene problemas para aceptar tu pago».
En modo Prueba no hace falta.
Apple Pay
Documentación de Redsys: el identificador de comerciante, el certificado
y la verificación de dominio se gestionan desde
su guía de Apple Pay.
Activar Apple Pay
Interruptor principal de Apple Pay, que solo funciona en Safari y en dispositivos Apple.
Requiere el identificador de comerciante, el certificado y un dominio verificado.
Mostrar como opción de pago
Muestra Apple Pay como una opción más dentro de la lista de métodos de pago del checkout.
Mostrar en la página de producto
Coloca el botón exprés de Apple Pay en la ficha de producto.
Mostrar en la página del carrito
Coloca el botón exprés de Apple Pay en el carrito.
Mostrar en la página de checkout
Coloca el botón exprés de Apple Pay en el proceso de compra.
Texto del botón
Leyenda que muestra el botón de Apple Pay.
Tema del botón
Color del botón de Apple Pay.
ID de comerciante de Apple Pay
Identificador de comerciante creado en el portal de Apple Developer, con el formato
merchant.com.tudominio.
Certificado de comerciante de Apple Pay (PEM)
Certificado que Apple emite para tu identificador de comerciante y con el que el servidor se
identifica ante Apple en cada pago.
Clave del certificado de comerciante de Apple Pay
Clave privada de ese certificado.
Nota: se completa automáticamente cuando usas el botón «Generar CSR».
Archivo de verificación de dominio de Apple Pay
Contenido del fichero con el que Apple comprueba que el dominio es tuyo.
Nota: pega aquí el contenido del archivo que Apple te proporciona y
luego usa «Publicar verificación de dominio».
Traducciones
Editar Traducciones
El módulo incluye un editor de traducciones que te permite personalizar todos los textos en cualquier idioma instalado en tu tienda.
- Accede a la sección "Traducciones" en la configuración del módulo
- Selecciona el idioma que deseas editar
- Modifica las cadenas de texto según necesites
- Haz clic en "Guardar" para aplicar los cambios
Acciones disponibles
El editor de traducciones incluye varias acciones para gestionar tus traducciones:
- Guardar: Guarda los cambios realizados en las traducciones.
- Guardar y descargar: Guarda los cambios y descarga el archivo de traducciones para respaldo.
- Comparte con nosotros: Envía tus traducciones a nuestro equipo PresTeamShop para incluirlas en futuras versiones del módulo.
- Expandir todo: Muestra todas las secciones de traducciones expandidas.
- Contraer todo: Oculta el contenido de todas las secciones.
Editores de código
Permite agregar código CSS y JavaScript personalizado directamente desde el panel de configuración, sin necesidad de acceder a los archivos del servidor.
Editores disponibles:
- CSS personalizado: Agrega estilos para personalizar la apariencia.
- JavaScript personalizado: Agrega scripts para personalizar el comportamiento.
Precaución: Utiliza esta sección solo si tienes conocimientos técnicos. Un código incorrecto puede afectar el funcionamiento del módulo o de la tienda.
Copias de seguridad
El sistema de copias de seguridad te permite proteger la configuración del módulo y restaurarla en caso de necesidad.
Generar copia de seguridad
Para crear una nueva copia de seguridad, haz clic en el botón "Generar nueva copia de seguridad". El sistema creará un respaldo de la configuración actual del módulo.
Subir copia de seguridad
Si tienes una copia de seguridad descargada previamente, puedes cargarla haciendo clic en el botón "Subir copia de seguridad". Se abrirá un diálogo donde podrás seleccionar el archivo ZIP de la copia de seguridad.
Copias de seguridad disponibles
La lista muestra todas las copias de seguridad creadas. Puedes filtrar por fecha utilizando el selector de fecha y actualizar la lista con el botón "Actualizar lista".
Acciones de la lista
Cada copia de seguridad en la lista tiene las siguientes acciones disponibles:
Restaurar copia de seguridad
Restaura la configuración del módulo
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.
