MAGENTO 2 - ES

Owned by Pablo Lago
Last updated: Nov 07, 2024 by Márcia Gonçalves
9 min read

 

 

Instalación y configuración

Requisitos mínimos

  • Magento: 2.4.3

  • PHP: 7.4

Para versiones más antiguas → Integración Legacy

Si ya ha utilizado extensiones de Sequra, debería considerar migrarlas a una extensión unificada sequra/magento2-core que contiene toda la configuración en un solo lugar y eliminar aquellas que ya no sean necesarias.

Para lograr esto con éxito, el comerciante debe ejecutar los siguientes comandos:

  • Para conservar la configuración anterior, ejecute el siguiente comando:
    composer require sequra/magento2-core:"<=2.4.2.5"

 

  • Desinstalar extensiones innecesarias:
    php bin/magento module:uninstall Sequra_Campaign  Sequra_Splitpayments Sequra_Partpayments Sequra_Invoice Sequra_Card Sequra_MageplazaRewardpoints Sequra_Remotesales Sequra_MagestoreRewardpoints

 

  • Eliminar dependencias de extensiones innecesarias:
    composer remove sequra/magento2-campaign sequra/magento2-splitpayments sequra/magento2-partpayments sequra/magento2-invoice sequra/magento2-card sequra/magento2-mageplaza-rewardpoints sequra/magento2-remotesales sequra/magento2-magestore-rewardpoints

 

  • Requiere la última versión delsequra/magento2-núcleo extensión:
    composer require sequra/magento2-core

Paso 1: Instalar la extensión Sequra

Para configurar la extensión Sequra, hay seguir el proceso de instalación clásico de Magento2 ejecutando los siguientes comandos:

  • Ejecute el comando: composer require sequra/magento2-core

  • Habilite el módulo Sequra Core: php bin/magento module:enable Sequra_Core

 

En caso de tener Hyvä theme activado en la web, se debe ejecutar lo siguiente:

  • Instalación via http://packagist.com :
    Los módulos de compatibilidad de Hyvä que están etiquetados como estables pueden instalarse usando Composer a través de packagist.com:

    • Instalación mediante Composer:

      composer require hyva-themes/magento2-sequra-core

    • Para habilitar el modulo:

      bin/magento setup:upgrade

       

  • Instalación via Gitlab:
    Para el desarrollo o contribución a un módulo de compatibilidad, es necesario instalarlo usando Composer a través de GitLab. Este método de instalación no es adecuado para despliegues, ya que GitLab requiere autorización mediante clave SSH.

    • Instalación mediante Composer:

      Si es la primera vez que se instala un módulo de compatibilidad a través de GitLab, es necesario agregar el repositorio compat-module-fallback como un repositorio de Composer. Este paso solo se requiere una vez.

      composer config repositories.hyva-themes/magento2-compat-module-fallback git git@gitlab.hyva.io:hyva-themes/magento2-compat-module-fallback.git

      Una vez configurado el repositorio compat-module-fallback, se puede instalar el módulo de compatibilidad en sí mediante Composer:

    • Para habilitar el módulo:

Paso 2: Conectar la integración

Después de la instalación,se puede acceder a la página de configuración de seQura en Sales → SeQura:

Captura de pantalla 2024-10-22 a las 11.26.07.png

Paso 1: Una vez dentro de la pagina de configutración de seQura, se deben ingresar las credenciales (usuario y contraseña) y seleccionar el entorno adecuado, Sandbox (entorno de pruebas) y Live (entorno de producción).

 

 

 

 

 

 

 

 

 

 

 

Paso 2: Si las credenciales son válidas, serás redirigido al siguiente paso, la configuración de los países. Aquí es donde se configuran los países en los que desea ofrecer los métodos de pago de SeQura. Al igual que en el paso anterior, es necesario añadir el merchant ID (username) correspondiente de cada país.

Paso 3: Al terminar la configuración de países, avanzamos al paso de la configuración, los widgets promocionales. Aquí, se confirgura la apariencia de los widgets. Puedes encontrar distintos estilos del widget aquí: https://live.sequracdn.com/assets/static/simulator.html

Configuración

Configuración métodos de pago

Se pueden filtrar y ver los métodos de pago disponibles en cada país en Payment methods.

Configuración general

Dentro de Settings → General Settings encontrarás distintas secciones como:

  • Allowed IP adresses: En este campo se filtran las IP que si podrán visualizar seQura. Si se deja el campo de IP vacio, seQura será visible para todos. La IP de seQura es: 212.80.211.33

  • Excluded categories: En este campo se filtran categorias las cuales no ofreceran seQura.

  • Excluded products: En este campo se filtran productos los cuales no ofreceran seQura

  • Countries: En este campo se configuran los países en los que seQura estará disponible.

Configuración de conexión

Si es necesario modificar la configuración o desconectar las credenciales actuales, dentro de Settings → Connection Settings encontrarás un botón rojo con el que podrás desconectar y conectar las credenciales en cualquier momento.

Compras test

Importante! Antes de poner el nuevo método de pago en producción, aconsejamos hacer compras test en el entorno de prueba (Modo Sandbox). De esta manera las dos partes, el comercio electrónico y SeQura, nos aseguramos de que todo funciona correctamente.

Recuerda, el importe mínimo para realizar una compra con la modalidad "Pago fraccionado" es de 50,00 €. Para importes inferiores este método de pago no será seleccionable.

 

Pasos para hacer una compra test en el entorno de prueba (sandbox):

  1. Asegurarse de haber completado los puntos anteriores de este manual.

  2. Realizar algunas compras de prueba y todos aquellos tests que se deseen.

    1. En Sandbox no se envían SMS. El código de validación solicitado durante el proceso de compra serán los 5 últimos dígitos del número de móvil que se haya indicado en el paso anterior.

    2. En Sandbox la numeración de la tarjeta ficticia para pruebas será 4716 7730 7733 9777, la fecha de caducidad 12/30 y el CVV/CVC 285.

Colocar widgets promocionales

Una vez se hayan habilitado y configurado los widgets promocionales en la configuración de integración, estos pueden ser agregados a las páginas de productos y carritos de la tienda. Para ello es necesario utilizar el mecanismo nativo de Magento 2 con bloques y widgets.

Paso 1: Crear un bloque

Para crear un bloque, es necesario acceder a Contenido → Bloques → Añadir un bloque. Dentro del bloque hay que colocar un componente de diseño y dentro de este, el widget de seQura.

Al crear el bloque es necesario añadirle un nombre y un identificador, como por ejemplo, sequra. En Store View hay que seleccionar All Store Views. El siguiente paso es editar el bloque en Edit With Page Builder.

Dentro del editor Page Builder, añadimos una fila. Dentro de la fila, hay que arrastrar y soltar el widget promocional de SeQura.

 

Una vez configurado el bloque, salimos del editor y guardamos.

Paso 2: Crear un widget

Dentro de Contenido → Widgets, se debe crear un nuevo widget y elegir el bloque seQura creado en el paso anterior.

Al hacer clic en Añadir Widget, se debe de configurar Type como CMS Static Block y hay que establecer el mismo tema que esté activo en la web.

 

Una vez definidos el tipo y el diseño, hay que definir el nombre del widget, por ejmplo sequra, y configurar en qué páginas se mostrará. Es esencial que se marque la opción All Store Views en el campo Assign to Store Views.

En esa misma pantalla, más abajo, hay que configurar la ubicación del widget para la pagina de producto. Para ello, en Display On se debe seleccionar All Product Types y en Container seleccionar Product info auxiliary container.

En Widget Options, seleccionamos el bloque creado anteriormente y guardamos.

Tras haber hecho esta configuración, los clientes que abran la página de un producto determinado podrán ver formas de pagar ese producto utilizando los métodos de pago de SeQura. Los widgets promocionales utilizan el precio actual del producto y tienen en cuenta los costos adicionales causados ​​por la variación específica del producto.

 

Además, al hacer clic en el enlace de información en un bloque de widget promocional específico se abre más información sobre el acuerdo de pago para ese método de pago SeQura específico.

 

Paso 3: Configurar los mini-widgets

 

  • Configuración para mostrar el mini-widget del carrito de compra:
    Dentro de la configuración del widget creado en el paso anterior, podemos añadir una Layout nueva para mostrar el widget en el resumen del carrito. Para ello hay que hacer la siguiente configuración:

    - Display On: Specified Page
    - Page: Shopping
    - Cart Container: Cart Summary Container

    Al igual que en la página del producto, los clientes pueden hacer clic en el enlace del widget promocional y ver más información sobre las opciones de pago con ese método de pago.

  • Configuración para mostrar el mini-widget en el listado de productos (desde la configuración de seQura)

Los clientes que naveguen por la página de listado de productos en el escaparate podrán ver formas de pagar un producto específico mediante cuotas de SeQura en el listado. En caso de que el precio del producto sea igual o superior a la cantidad mínima de producto admitida en SeQura, se mostrará el mensaje teaser configurado en el idioma actual de la tienda.

De lo contrario, si el precio del producto es inferior a la cantidad mínima de producto admitida en SeQura, se mostrará el mensaje configurado por debajo del límite.

 

Interacción de métodos de pago

Cuando la integración de seQura se conecte exitosamente a la tienda, los clientes podrán seleccionar los métodos de pago de seQura en la página de pago como su método de pago preferido.

Una vez que se elige el método de pago, se muestra el formulario de seQura. Donde se debrán de seguir las instrucciones descritas en el formulario para así completar el proceso de pago.

 

 

 

Después de un pago exitoso, el cliente debería ser redirigido la página de agradecimiento de compra de la tienda:

 

Dado que es posible que el pago necesite una revisión de seQura, los comerciantes pueden verificar y monitorear el estado del pago en el panel de administración de Magento 2 en la página de Pedidos.

Gestión de pedidos

Información de pedido de SeQura

El comerciante puede ver la siguiente información del pago de seQura: la referencia del pedido y el enlace al pedido de seQura en la página de descripción general del pedido.

 

Actualización de pedidos

Se puede actualizar un pedido realizado con seQura desde el sistema de la tienda y ver que el cambio se propaga al portal seQura o se rechaza si seQura no admite dicho cambio. La integración propaga cambios de dirección de facturación y envío.

Enviar pedidos

Se puede enviar parcial o totalmente un pedido realizado con el método de pago seQura utilizando el mecanismo nativo de Magento 2 para enviar un pedido.

Reembolso de pedidos

Se puede reembolsar parcial o totalmente los artículos del pedido utilizando el mecanismo nativo de Magento 2 para reembolsar las líneas de pedido.

Para reembolsar un pedido realizado con el método de pago seQura, se debe abrir una factura para el pedido creado y crear una nota de crédito.

 

La integración de seQura solo admite reembolsos en línea:

Cancelar pedidos

El comerciante puede cancelar un pedido realizado con los métodos de pago de seQura utilizando el mecanismo nativo de Magento 2 para cancelar un pedido. Magento 2 sólo permite a los comerciantes cancelar un pedido que aún no ha sido pagado ni enviado.