Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

Table of Contents

Instalación y configuración

...

Requisitos mínimos

  • Magento: 2.4.3

  • PHP: 7.4

Para versiones más antiguas

...

Paso 1: instalación

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

Instale la extensión Sequra:

...

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

Integración Legacy

Info

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

Note

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:

      Code Block
      composer require hyva-themes/magento2-sequra-core
    • Para habilitar el modulo:

      Code Block
      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.

      Code Block
      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:

      Code Block
      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:

      Code Block
      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:

Captura de pantalla 2024-10-22 a las 11.26.07.pngImage Added

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).

Image Modified

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.

image-20241022-093335.pngImage Added

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

...

Además, puede seleccionar en qué páginas desea permitir que se muestren los widgets y, en el caso de mini-widgets de listado de productos, podrá configurar opciones adicionales.

...

Configuración

Administrar métodos de pago

...

. Puedes encontrar distintos estilos del widget aquí: https://live.sequracdn.com/assets/static/simulator.html

image-20241022-094003.pngImage Added

Configuración

Configuración métodos de pago

Se pueden filtrar y ver los métodos de pago

...

disponibles en cada país

...

Administrar configuraciones generales

El comerciante puede configurar los ajustes principales de la integración de SeQura.

...

Administrar la configuración de conexión

...

en Payment methods.

Captura de pantalla 2024-10-22 a las 11.44.07-20241022-094428.pngImage Added

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.

Image Added

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.

Image Modified

Compras test

Note

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.

      Image Added
    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.

      Image Added

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.

Captura de pantalla 2024-10-22 a las 11.32.27.pngImage Added
Note

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.

Captura de pantalla 2024-10-22 a las 11.42.17.pngImage Added

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

...

.

Captura de pantalla 2024-10-22 a las 11.44.39.pngImage AddedCaptura de pantalla 2024-10-22 a las 11.49.44.pngImage Added
Info

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.

Image Modified

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

...

.

...

Luego el comerciante puede configurar en qué páginas se mostrarán los bloques:

...

Interacción de widgets

Listado de productos

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.

...

Página del producto

...

Captura de pantalla 2024-10-28 a las 13.10.24-20241028-121057.pngImage Added

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.

Info

Para ver el tema activo de la web, hay que acceder a Content → Design → Themes.

Captura de pantalla 2024-10-28 a las 13.14.15-20241028-121444.pngImage Added

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.

image-20241028-121821.pngImage Added

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.

image-20241028-122125.pngImage Added

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

Image Added

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.

...

image-20241028-122942.pngImage Added

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.

...

Página del carrito

Los clientes que lleguen a la página del carrito en la tienda de Magento 2 podrán ver opciones para pagar su carrito actual utilizando los métodos de pago de SeQura.

...

image-20241029-120031.pngImage Added

Paso 3: Configurar los mini-widgets

Info

Recuerda que tienes que activar los widgets que quieres mostrar en la página de configuración de seQura.

Captura de pantalla 2024-10-28 a las 14.03.22-20241028-130348.pngImage Added

  • 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

    image (1).pngImage Added

    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.

...


  • 8160f9d4-1b35-4519-b6aa-ad5ec44a90e5-20241029-120145.pngImage Added

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

Image Added

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.

Image Added

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.

...

Image Modified

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.

...

Image Added
Image Added
Image Added

Info

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.

...

Image Added

Después de un pago exitoso, el cliente debería ser

...

redirigido la página de agradecimiento de compra de la tienda:

Image Modified

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.

Image Modified

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.

Image Modified

Info

El comerciante puede ver la información de pago de SeQura en la página de detalles del pedido.

...

Image Added

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.

Image ModifiedImage Modified

...

...

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.

Image Modified

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.

Image Modified

La integración de

...

seQura solo admite reembolsos en línea:

Image Modified

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.

Image Modified