Instalación y configuración

Requisitos mínimos

• Magento: 2.4.3

• PHP: 7.4

Para versiones más antiguas → Integración Legacy

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

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:

Open

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

Open

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

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)
  
  

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.