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-coreHabilite 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 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-fallbackcomo 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:composer config repositories.hyva-themes/magento2-sequra-core git git@gitlab.hyva.io:hyva-themes/hyva-compat/magento2-sequra-core.git composer require hyva-themes/magento2-sequra-core:dev-main
Para habilitar el módulo:
bin/magento module:enable Hyva_SequraCore bin/magento setup:upgrade
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:
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.33Excluded 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):
Asegurarse de haber completado los puntos anteriores de este manual.
Realizar algunas compras de prueba y todos aquellos tests que se deseen.
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.
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.
Para crear el bloque y añadir el widget de seQura, es necesario tener activo el editor Page Builder
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.
Si hay más de un producto de seQura contratado, ponemos el cursor encima de la fila que acabamos de crear y hacemos clic en la ruedecita de opciones (⚙️). Eso nos abre otra pestaña donde podemos configurar el widget que queramos mostrar. Por ejemplo, si tenemos los productos paga fraccionado y divide en tres podemos configurarlo en diferentes widgets.
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.
Para ver el tema activo de la web, hay que acceder a Content → Design → Themes.
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
Recuerda que tienes que activar los widgets que quieres mostrar en la página de configuración de seQura.
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
.png?version=1&modificationDate=1730201636328&cacheVersion=1&api=v2&width=736&height=283)
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.
Si seQura necesita revisar un pago antes de que pueda procesarse y declararse exitoso, en la última vista del formulario habrá una notificación sobre la revisión del pago, antes de redirigir a la página de agradecimiento.
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.
El comerciante puede ver la información de pago de SeQura en la página de detalles 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.
