Instalación y configuración de Magento

Comprobaciones previas

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

Requisitos de la plataforma

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

  • Consulta aquí la versión de Magento.
  • PHP 7.X – 8.1.
  • Composer.
  • Acceso al servidor web por consola (SSH o similar) con permisos necesarios para modificar el directorio raíz de Magento.

En instalaciones en servidores GNU/Linux, para evitar problemas de permisos en la instalación y ejecución tanto de Magento como del módulo, recomendamos tener en cuenta los siguientes puntos:

  • Verificar que el usuario creado en el S.O. para el servicio del servidor web (normalmente www-data) tenga permisos de lectura, escritura y ejecución sobre el directorio raíz de Magento.
  • Realizar tanto la instalación del propio CRM como la instalación del módulo mediante el usuario creado en el S.O. para el servicio del servidor web (normalmente www-data).
    • Para ello utilizaremos el comando “sudo -u www-data comando”, el cual ejecutará comando con el usuario del servicio del servidor web.
  • Los comandos indicados en esta guía son orientativos y se ejecutan desde la raíz del directorio de Magento.

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

Versión del módulo Magento PHP 7.x PHP 8.X
1.4.12.4.3 ✅ ❌
2.4.4 ✅ ✅
2.4.5 ✅ ✅
2.4.6 ❌ ❌

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

Los módulos (PrestaShop, WooCommerce, Magento o Salesforce) operan mediante el tipo de integración JavaScript. Para este tipo de integración, Addon Payments requiere que los dominios en los que se invoca 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 comercio» > «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. Si la integración es mediante un módulo, marca la casilla “Voy a utilizar plataformas de ecommerce con plugins”.
  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. 

Instalación

Configuración del repositorio

A través de la consola, localiza el fichero «composer.json«, que se encuentra en la raíz del directorio de Magento.

A continuación, en la lista de repositorios, añade los de Addon Payments.

Para agilizar el proceso y evitar posibles errores de configuración, puedes añadir los repositorios mediante los siguientes comandos:

sudo -u www-data composer config repositories.addon-payments-module git https://bitbucket.org/easypaymentgateway/public-magento.git

sudo -u www-data composer config repositories.addon-payments-sdk git https://bitbucket.org/easypaymentgateway/addon-payments-sdk.git

La sección «repositories» del fichero debería quedar similar a lo siguiente:

				
					"repositories": { 
    "repo": { 
        "type": "composer", 
        "url": "https://repo.magento.com/" 
    }, 
    "addon-payments-module": { 
        "type": "git", 
        "url": "https://bitbucket.org/easypaymentgateway/public-magento.git" 
    }, 
    "addon-payments-sdk": { 
        "type": "git", 
        "url": "https://bitbucket.org/easypaymentgateway/addon-payments-sdk.git" 
    }
},

Descarga e instalación del módulo y dependencias

Una vez añadidos los repositorios de Addon Payments al fichero “composer.json”, ejecuta el comando:

sudo -u www-data composer require comercia-global-payments/module-addon-payments

El comando ejecuta las siguientes acciones:

  1. Busca la versión más reciente del módulo con el nombre indicado en todos los repositorios configurados en el archivo “composer.json”.
  2. Añade el módulo de Addon Payments encontrado a los requerimientos indicados en el fichero “composer.json”.
  3. Descarga e instala los siguientes paquetes:
    • El módulo.
    • El SDK adecuado a la versión de PHP instalada en el servidor web.
      • PHP 7.x: SDK 1.x
      • PHP 8.x: SDK 2.x
    • Las dependencias necesarias.

    Actualizar la configuración de Magento

    1. Tras la descarga e instalación del módulo mediante el comando del punto anterior, actualiza la configuración de Magento mediante este comando:
      sudo -u www-data php bin/magento setup:upgrade
    2. Posteriormente, vacía las cachés de Magento con el comando:
      sudo -u www-data php bin/magento cache:clean
    Si el módulo se ha instalado correctamente, aparecerá la sección de configuración Addon Payments en la ruta:

    1. «Tiendas»
    2. «Configuración»

    3. «Ventas».
    4. «Métodos de pago».
    5. «Otros métodos de pago».
    6. «Configurar», dentro de la sección de Addon Payments.

    Configuración del módulo

    Una vez pulsado el botón “Configurar”, aparecen las opciones para ajustar el funcionamiento del módulo. Al lado de cada opción se indica si es obligatoria o no:

    • Habilitar Addon Payments (obligatorio): Habilita y deshabilita el método de pago en el CRM. Debe estar marcado “Sí” (habilitado) para que aparezca la opción de pago a los clientes.
    • Título: Personaliza el texto del método de pago que se muestra a los clientes en el proceso de compra.
    • Icono: Personaliza el icono del método de pago que se muestra a los clientes en el proceso de compra.
    • Ancho y altura del icono: Personaliza el tamaño del icono del método de pago.
    • Acción de pago: Selecciona si los pagos de los clientes van a ser liquidados automática o manualmente.
      • Charge: Liquidación automática (por defecto). No es necesaria acción por tu parte. El importe del pago será liquidado en el momento en el que se finalice el mismo.
      • Pre-Authorization: Liquidación manual. El importe del pago no será liquidado automáticamente, sino que tenemos que ordenar su liquidación desde el Portal de BackOffice del CRM o el Portal BackOffice de Addon Payments. Se dispone de un tiempo predeterminado de siete (7) días naturales máximo para ordenar la liquidación.

    Más adelante encontramos las credenciales. Estas son facilitadas por el equipo de soporte de Addon Payments durante el proceso de alta. Todas son obligatorias. 

    • Identificador del vendedor (obligatorio): Identificador de tu comercio.
    • Product Id (obligatorio): Identificador del producto creado en tu comercio.
    • Merchant Key (obligatorio): Contraseña para la conexión al cajero JS.
    • Merchant Secret (obligatorio): Contraseña para el cifrado de los mensajes.
    • Sandbox (obligatorio): Indica si el módulo enviará las peticiones al entorno de Staging/Pruebas (Sí) o al entorno de Producción (No).

    El siguiente apartado es relativo a 3D Secure:

    • Habilitado (obligatorio): Configura si las peticiones de pago se gestionarán a través de comercio seguro (Sí, por defecto) o comercio no seguro (No).
      • Para cumplir con la normativa europea de pagos electrónicos PS2, y si vas a recibir pagos de clientes que residan en el Espacio Económico Europeo (EEE), el valor debe ser “Sí”.

      Por último, pulsa el botón “Guardar configuración”, situado en la parte superior derecha.

              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:

              • Tipo de financiación: Configura cómo se ofrece el pago financiado a los clientes siempre y cuando el importe del pedido esté entre el mínimo y máximo establecido.
                • En caso de haber contratado el producto de financiación “Quix”, selecciona pago fraccionado (permite a los clientes fraccionar el pago hasta 12 meses).
                • Pago a plazos: Opción obsoleta de fraccionamiento. No seleccionar.
              • Banner de Financiación
                • Habilitar en la vista de producto: Habilita el banner informativo de financiación en la ficha de los productos.
                • Habilitar en la vista de carrito: Habilita el banner informativo de financiación en la ficha de los productos.
              • Product View Configuration y Cart View Configuration: Facilitan configuraciones de personalización para los banner que se muestran en la ficha del producto y el resumen del carrito, respectivamente.

              Una vez has realizado los cambios correspondientes, pulsa el botón “Guardar configuración”, situado en la parte superior derecha.

              Actualización del módulo

              Para actualizar la versión del módulo que está ya instalada en tu CRM, sigue los siguientes pasos:

              1. Ejecuta el comando en el directorio raíz de Magento para buscar y descargar versiones actualizadas de los módulos instalados en los repositorios configurados. En caso de encontrar cualquier módulo con versión superior a la instalada en tu CRM, Composer lo detectará y descargará para su instalación:
                sudo -u www-data composer update
              2. Ejecuta el comando para actualizar la configuración de Magento:
                sudo -u www-data php bin/magento setup:upgrade
              3. Vacía las cachés de Magento con el comando:
                sudo -u www-data php bin/magento cache:clean

              Si todos los pasos se han ejecutado correctamente, tu CRM ya dispondrá de la última versión del módulo manteniendo la configuración.

              Desinstalación del módulo

              Para eliminar el módulo de Addon Payments de tu CRM sigue estos pasos:

              1. A través de la consola, localiza el fichero “composer.json” que se encuentra en la raíz del directorio de Magento.
              2. Edita el fichero. En la sección “require”, localiza la línea que contiene “comercia-global-payments/module-addon-payments” y elimínala.
                • Opcional: También puedes eliminar el repositorio de Addon Payments de la lista de repositorios. 
              3. Ejecuta el comando en el directorio raíz de Magento para desinstalar y eliminar tanto el módulo como sus dependencias:
                sudo -u www-data composer update
              4. Ejecuta el comando para actualizar la configuración de Magento:
                sudo -u www-data php bin/magento setup:upgrade
              5. Vacía las cachés de Magento con el comando:
                sudo -u www-data php bin/magento cache:clean

              visto recientemente

              Comparte este documento
              Tabla de Contenidos

              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

              Cyberpac

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

              Canales

              Módulos de integración

              Integraciones a medida

              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

              Consult the documentation of the different integrations sections:​

              Start integration

              undraw_add_to_cart_re_wrdo 1 (1) (1)

              CMS Plugins

              Complement your integration

              SDKs

              Payment Methods

              Tools