Errores frecuentes en la instalación y configuración de Magento

Comprobaciones previas

Antes de empezar a utilizar el módulo de Addon Payments para Magento, hay que hacer unas comprobaciones y cumplir unos requisitos previos.

Verificar compatibilidad del módulo

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

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

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.

    Recopilar información mediante la función phpinfo()

    En algunos errores es necesario verificar configuraciones e información de tu plataforma, para poder localizar el origen de forma correcta. Algunos puntos a verificar son:

    • Versión de Magento.
    • Versión del módulo que se quiere instalar.
    • Servidor web (Apache2/Nginx).
    • Versión de PHP instalada.
    • Módulos de PHP instalados y/o habilitados.
    • Configuraciones de PHP aplicadas.

    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 (Magento).
    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.
      • Core: Valores de configuración de PHP.
      • iconv/intl/json/libxml: Módulos instalados y/o habilitados.
      • $_SERVER[‘SERVER_SOFTWARE’]: Servidor web y versión.

    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. 

    Errores al instalar el módulo

    Posible causa:

    El archivo “composer.json” del directorio de trabajo no tiene añadido el repositorio del módulo.

    Solución:

    Verificar que el archivo “composer.json” del directorio de trabajo tenga correctamente añadidos los repositorios de Addon Payments para que Composer pueda localizar y descargar el módulo. 

    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

    Errores de dependencias

    Posible causa:

    El archivo “composer.json” del directorio de trabajo no tiene añadido el repositorio de la SDK del módulo.

    Solución:

    Verificar que el archivo “composer.json” del directorio de trabajo tenga correctamente añadidos los repositorios de Addon Payments para que Composer pueda localizar y descargar el módulo.

    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

    Posible causa:

    El módulo de Addon Payments, la SDK de Addon Payments o una dependencia versión [x], requiere una dependencia [extension] del desarrollador [developer] en una versión igual o superior a [y] que no está instalada. Además, Composer no la puede instalar por alguno de los siguientes motivos:

    • No encuentra una versión mínima o máxima compatible.
    • Hay una versión compatible pero esa extensión ya está instalada y bloqueada a una versión concreta.

    Posibles soluciones:

    • No encuentra una versión mínima o máxima compatible:
      • Revisa que Composer tenga el repositorio de Magento correctamente configurado.
      • Borra la caché de Composer.
    • Hay una versión compatible pero esa extensión ya está instalada y bloqueada a una versión concreta.
      • Puedes forzar la instalación de una dependencia en una versión inferior o superior a la instalada mediante este comando, siendo [z] la versión a instalar:
        sudo -u www-data composer require [developer]/[extension]:[z]
      • Ejemplo: La dependencia “theorchard/monolog-cascade” requiere a su vez de otra dependencia, “symfony/options-resolver”, en una versión entre la 2.7.0 y la 5.4.21. Sin embargo, la plataforma tiene instalada la versión 6.3.0 de “symfony/options-resolver”. La incidencia puede resolverse mediante el siguiente comando ejemplo. Con este comando se fuerza a Composer a instalar la versión máxima soportada por el módulo “5.4.21”:
        sudo -u www-data composer require symfony/options-resolver:5.4.21

    Errores al mostrar la pasarela de pago

    Posible causa:

    Error en alguno de los valores introducidos al configurar el módulo, como el “Identificador de producto” o la “Clave API”.

    Solución:

    • Verificar que se ha introducido correctamente el “Identificador de producto” facilitado por Soporte.
    • Verificar que se ha introducido correctamente la “Clave API” correspondiente al entorno en el que esté el módulo (Staging/Producción).
    • Verificar que el módulo está configurado para operar en el entorno correcto (Staging/Producción).

    Posible causa:

    No se ha activado el uso de módulos en el entorno que corresponda (Staging/Producción) de Addon Payments.

    Solución:

    Acceder al Portal BackOffice de Addon Payments y marcar la opción “Voy a utilizar plataformas de ecommerce con plugins”. Consulta la sección Añadir dominio seguro y activar compatibilidad con módulos de esta guía.

    Posible causa:

    La pasarela de pago no se ha dado de alta como dominio seguro en el entorno que corresponda (Staging/Producción) de Addon Payments desde el que se invoca.

    Solución:

    Accede al Portal BackOffice de Addon Payments y añade el dominio en el que tienes instalado el módulo como dominio seguro. Consulta más información en la sección Añadir dominio seguro y activar compatibilidad con módulos de esta guía.

    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