Instalación y configuración de PrestaShop

Comprobaciones previas

Antes de instalar y configurar el módulo de Addon Payments para PrestaShop, hay que hacer algunas comprobaciones para asegurar su correcto funcionamiento.

Requisitos de la plataforma

El módulo de Addon Payments para PrestaShop es compatible con las siguientes configuraciones:

  • PrestaShop, consulta aquí la versión.
  • PHP 7.x con las siguientes extensiones instaladas y habilitadas:
    • mbstring
    • bcmath o gmp (GNU Multiple Precision)
  • Si usas la versión del módulo 2.0.0, la versión mínima de PHP es la 7.4 y la máxima 8.3.
  • Servidor web Apache2 o Nginx.

La compatibilidad de otras configuraciones no ha sido probada. Por lo tanto, no podemos ofrecer soporte sobre las mismas.

Configurar PHP

El módulo requiere que las siguientes extensiones de PHP estén instaladas y habilitadas:

  • mbstring
  • bcmath o gmp (GNU Multiple Precision)

Como el módulo de Addon Payments tiene un tamaño superior a 13 MB, es necesario modificar los siguientes parámetros de configuración de PHP, estableciendo un valor mínimo de 20 MB:

  • post_max_size (8 MBs por defecto)
  • upload_max_filesize (2 MBs por defecto)

Para modificar los valores indicados, realiza los siguientes pasos:

  1. Localiza el archivo de configuración de PHP (php.ini) y ábrelo con un editor de texto. La localización de este archivo depende de la plataforma, puedes verificar su ruta mediante el ítem “Loaded Configuration File” de phpinfo(), que se explica en la siguiente sección.
  2. Localiza los siguientes ítems y amplía su valor a 20MB (20M) o superior:
    • post_max_size
    • upload_max_filesize
  3. Para ampliar su valor escribe “20M” o un valor superior, a continuación de los ítems. 
  4. Guarda cambios y cierra el editor.
  5. Si estás usando PHP FPM/FastCGI, reinicia el servicio FPM de PHP. El comando para hacerlo dependerá de la distribución de linux/unix, y requiere permisos de administrador. Los comandos más probables son:
    • “systemctl restart php-fpm”, distribuciones con systemd.
    • “service php-fpm restart”, distribuciones con SysVinit. 
    • Si tienes más de una versión de PHP instalada en el servidor, es recomendable indicar la versión del demonio a reiniciar. Por ejemplo “systemctl restart php7.1-fpm”.
  6. Reinicia el servicio del servidor web. El comando depende de la distribución de linux/unix y del servidor web instalado, y requiere permisos de administrador. Los más usuales son:
    • “systemctl restart apache2”, servidor web Apache2.
    • “systemctl restart nginx”, servidor web Nginx.
  7. Comprueba que las modificaciones en la configuración de PHP se han aplicado correctamente. Para ello, usa la función phpinfo(). 

Verificar configuración mediante la función phpinfo()

Para verificar los pasos de la configuración del PHP, puedes hacer uso de la función de PHP phpinfo():

  1. Sube un archivo .php a tu servidor de hosting con el siguiente código: <?php phpinfo(); ?>
  2. Para mayor fiabilidad de la información mostrada, sitúa el archivo dentro del directorio que contiene la plataforma de comercio electrónico (PrestaShop).
  3. Abre en el navegador web la ruta al archivo que has creado en el servidor web.
  4. Se mostrará una web con información, como:
    • PHP Version: Versión de PHP instalada en el servidor web.
    • Loaded Configuration File: Ruta del archivo de configuración de PHP en el servidor web.
    • post_max_size/upload_max_filesize: Valores de configuración de PHP.
    • BCMath/GMP/Multibyte: Módulos instalados y/o habilitados (bcmath, gmp, mbstring).
    • $_SERVER[‘SERVER_SOFTWARE’]: Servidor web y versión.

Añadir dominio seguro y activar compatibilidad con módulos

Addon Payments requiere que los dominios en los que aparezca la pasarela de pago estén registrados como dominios seguros en la configuración de tu comercio.
En el Portal BackOffice de Addon Payments, puedes configurar los dominios seguros en el entorno que corresponda (Staging/Producción). Para ello, sigue estos pasos:

  1. Accede al Portal BackOffice de Addon Payments en el entorno adecuado (Staging/Producción).
  2. Si la configuración es para un sub comercio, accede al mismo pulsando en “Configuración de Comercio” > “Gestión de Merchants” y selecciona el comercio que necesites. 
  3. Pulsa en “Configuración de Dominio”.
  4. Verifica que el dominio desde el cual se lanza la pasarela de pago esté en la “Lista de dominios seguros” mostrada.
  5. Para añadir un dominio o agregar uno adicional, pulsa el botón “Añadir dominio” e introduce su URL. Las URLs introducidas sólo requieren estos elementos: (https://), subdominio y dominio. No son necesarias rutas, parámetros ni etiquetas. Por ejemplo:
    • “https://www.midominio.com/es/tienda” tan solo hace falta introducir: “https://www.midominio.com”.
    • En caso de operar con subdominios (https://sub.midominio.com) también será necesario incluirlos como dominios seguros.
  6. Verifica que la casilla “Voy a utilizar plataformas de ecommerce con plugins” está marcada.
  7. Pulsa en el botón “Guardar” para guardar los cambios.
  8. Recarga la página del Portal BackOffice de Addon Payments y verifica que todos los cambios han sido guardados.

IPs de notificación de Addon Payments

Visita la Gestión de notificaciones para tener más información sobre las IPs de notificación. 

Descargar, instalar o actualizar el módulo

Descarga el módulo actualizado en este enlace. La descarga se inicia automáticamente. Guarda el archivo donde quieras.

Si ya has descargado el módulo, entra en PrestaShop y sigue estos pasos: 

    1. Accede al panel de gestión de tu PrestaShop.
    2. En el menú lateral izquierdo, haz clic en “Módulos” > “Gestor de módulo”. 
    3. En la parte superior, haz clic en “Subir un módulo”.

4. Arrastra el archivo .zip que has descargado, o haz clic en “selecciona el archivo” y usa el explorador de archivos para subirlo a la plataforma.
5. Se abrirá una ventana indicando que el módulo se está instalando.
6. Cuando finalice, aparecerá un mensaje indicando que el módulo se ha instalado correctamente. Si la instalación ha sido exitosa haz clic en el botón “Configurar”.
7. Si se ha producido un error en la instalación, consulta la guía de errores frecuentes.

Acceder a la configuración

Para acceder a la configuración del módulo:

  1. Accede al panel de gestión de tu PrestaShop.
  2. En el menú lateral izquierdo, haz clic en “Módulos” > “Gestor de módulo”.
  3. En la lista de todos los módulos, aplica el valor “Pago” en el filtro “Categoría”, disponible en la parte superior. Selecciona el módulo “Addon Payments”. Si no aparece, selecciona “Mostrar todos los módulos” en el filtro “Estado”.
  4. En la parte derecha, haz clic en el botón “Configurar” para acceder a la configuración.

Configurar el módulo

Estas son las opciones en la página de configuración y su función:

  • Modo producción: Define si el módulo está en un entorno de Staging/Pruebas o en un entorno de Producción. Cambiar de un entorno a otro requiere configurar la “Clave API” y la “Contraseña” propia de cada entorno. 
    • Operar en entorno de Staging/Pruebas: Deshabilitado.
    • Operar en entorno de Producción: Habilitado.
  • Configuración por defecto: Permite seleccionar qué métodos de pago se ofrecerán al cliente en la pasarela.
    • “Múltiples métodos de pago” ofrecerá al cliente todos los métodos de pago que tenga disponibles el producto de tu comercio.
    • “Personalizado” ofrecerá al cliente todos los métodos de pago que tenga disponibles el producto de tu comercio. Además, permitirá personalizar el título y el logotipo del método de pago en el carrito.
  • Título: Cambia el nombre del método de pago que ven los clientes en el proceso de compra.
  • Logo: Muestra el logotipo del método de pago que ven los clientes en el proceso de compra.
    • Para modificar el logotipo actual, pulsa en el botón “Añadir archivo” situado debajo.
    • Se mostrará el explorador. Busca la nueva imagen y súbela a la plataforma.
    • Cuando se elige la nueva imagen y se presiona el botón “Seleccionar”, la imagen será cargada y se mostrará como el logotipo del método de pago.
  • Identificador de comercio: Identificador único de tu comercio en Addon Payments. Es facilitado por soporte en el correo de bienvenida.
    • Tiene entre 5 y 6 dígitos numéricos.
    • Es el mismo en el entorno de Staging/Pruebas y el de Producción.
  • Clave API: Clave API de tu comercio en Addon Payments. Tiene formato UUID. Por ejemplo: “6a18ecb3-bb1e-49cb-b532-264ddc18ed86”.
  • Contraseña: Contraseña de tu comercio en Addon Payments. Tiene formato PBKDF2 With HmacSHA256. Por ejemplo: Odm1hxMXWmkRs9bs3ibrQLs1YUcepvR3JguIzBHt7Sw=. La clave API y la contraseña son diferentes en el entorno de Staging/Pruebas y en el de Producción. Hay que configurarlas según el entorno donde vayas a operar. 
    • Las claves (API y contraseña) para el entorno de Staging/Pruebas llegan en el correo de bienvenida. También puedes recuperarlas y actualizarlas mediante el Portal BackOffice de Staging/Pruebas. Está disponible aquí. 
    • Las claves (API y contraseña) para el entorno de Producción no se envían por correo electrónico. Sólo se pueden recuperar y actualizar mediante el Portal BackOffice. Descubre cómo en la guía de Pase a Producción.
  • Identificador de producto: Identificador del producto creado en tu comercio en Addon Payments. Es facilitado en el correo de bienvenida.
    •  Entre 6 y 10 dígitos numéricos.
    • Puede ser diferente entre el entorno de Staging/Pruebas y el de Producción.
  • Autoliquidar todas las compras: Puedes elegir entre dos métodos para liquidar los cobros durante el proceso de compra: la liquidación automática (que es la opción predeterminada) o el modo manual. En el modo manual, los cobros autorizados se quedarán en estado “Pendiente” hasta que des la orden de liquidar.

Los siguientes campos son opcionales.
Permiten introducir URLs personalizadas para redirigir a los clientes cuando finalicen su compra. Se pueden dejar en blanco. En ese caso, el módulo redirigirá a una página de la propia plataforma PrestaShop.

  • URL de éxito: Página a la que irá el cliente cuando el pago sea autorizado.
  • URL de cancelación: Página a la que irá el cliente cuando cancele el proceso de pago.
  •  URL de fallo: Página a la que irá el cliente cuando el pago sea denegado.
  • Estilos: Permite seleccionar la hoja de estilos CSS que utiliza la pasarela de pago.

Al introducir o modificar cualquier valor, pulsa el botón “Guardar” situado en la parte inferior derecha para guardar los cambios en la configuración del módulo.

Opciones relativas a Quix

Sólo aplican si tienes contratado y activado el servicio de pago por financiación Quix de CaixaBank Payments & Consumer (CPC). Estas son las opciones disponibles:

  • Posición del banner de financiación: Permite definir la posición del banner en la página de producto. Si algunos elementos añadidos por otros módulos se muestran en el mismo hook, se pueden modificar las posiciones desde “Diseño” > “Posiciones”.
  • Color del banner de financiación: Color que se utilizará para personalizar algunos de los elementos del banner.
  • Variación del banner de financiación: Permite seleccionar el tipo de widget a mostrar. Los valores posibles son: “Banner de texto, Texto, Selección, Banner de selección”.
  • Marca de estilo del banner de financiación: Quix proporciona este valor. En función de este valor se mostrará una versión del widget u otra. Esto incluye textos legales y componentes visuales distintos. Actualmente no se puede modificar.

Al introducir o modificar cualquier valor, pulsa el botón “Guardar” situado en la parte inferior derecha para guardar los cambios en la configuración del módulo.

Sección de ayuda

En la parte superior de la configuración del módulo, tienes la pestaña “Ayuda”. En esta sección encontrarás: 

  • Esta guía de instalación.
  • Guías de consulta y gestión de transacciones y devoluciones.
  • Guías para probar los diferentes métodos de pago.
  • Tarjetas para realizar transacciones en un entorno de Staging/Pruebas.

Verificar la correcta configuración del módulo

En la parte inferior del formulario de configuración del módulo encontrarás un verificador de estado llamado “Estado de servicios”.
Cuando acabes de configurar el módulo, verifica si la configuración introducida funciona correctamente de esta forma:

  1. Si la combinación “Entorno – Id. de comercio – Clave API – Contraseña” es correcta, el estado de los servicios “API web” y “Formulario de pago” indicará “Funciona” y mostrará el icono de un rayo.
  2. Si funciona, verifica el correcto funcionamiento mediante una serie de compras de prueba en tu plataforma. Según el entorno en el que hayas configurado el módulo:
    • Entorno de Staging/Pruebas: Debes usar las tarjetas para el entorno de Staging/Pruebas, disponibles en Tarjetas para pruebas.
    • Entorno de Producción: Sólo puedes usar tarjetas reales y operativas. Si realizas operaciones en el entorno de Producción, puedes tramitar las devoluciones desde el Portal BackOffice de Addon Payments, disponible aquí: https://smb.addonpayments.com/

Si alguno de los campos es erróneo o no ha sido introducido, el estado de los servicios indicará “No funciona” y mostrará el icono de una exclamación.

Comparte este documento
Tabla de Contenidos

Productos

Ventas

Cuéntanos cómo es tu negocio para ofrecerte la mejor solución.

Contacta con un experto

Soporte técnico

¿Ya eres cliente y necesitas ayuda? Contacta con nosotros, estamos a tu disposición.

Ayuda

Socios

Trabajamos con los mejores partners de soluciones in-store y eCommerce. ¿Quieres unirte?

Únete a nosotros

© Comercia Global Payments

Política de privacidad
Ejercicio de Derechos
Información a Clientes
Canal de denuncia
Aviso Legal
Política de cookies

Cyberpac

Consulta la documentación de Cyberpac. Aquí tienes las distintas secciones:

Canales

Módulos de integración

Integraciones a medida

Consulta la documentación de las distintas secciones de integraciones:

Comienza a integrar

undraw_add_to_cart_re_wrdo 1 (1) (1)

Plugins para CMS

Complementa la integración

SDKs

Métodos de pago

Herramientas

Addon Payments

Consulta la documentación de Addon Payments. Aquí tienes las distintas secciones:

Integraciones

Consultas frecuentes

Portal Backoffice

Pagos integrados en TPV

Crea una solución que te ayudará a automatizar procesos. Incluso, podrás agregar procesos de pago en terminales físicos.

Pago integrado con TPV Android

Pago integrado con Smartphone TPV

Fichas Técnicas TPVs