Instalación y configuración
Paso 0: requisitos mínimos
Magento: 2.4.3
PHP: 7.4
Para versiones más antiguas ver
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:
Ejecute el comando:
composer require sequra/magento2-coreHabilite el módulo Sequra Core:
php bin/magento module:enable Sequra_Core
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 2: Conectar la integración
Después de la instalación, el comerciante puede acceder a la página de configuración de integración utilizando el elemento del menú SeQura desde el menú Ventas:
Paso 1: Una vez que se presiona el elemento del menú SeQura, se abre la página de conexión de integración. Aquí es donde se debe ingresar la información de la cuenta SeQura y eso incluye el nombre de usuario y contraseña, además de elegir el entorno adecuado.
Paso 2: Si las credenciales de conexión son válidas, el comerciante será redirigido al siguiente paso de incorporación: configuración de países de venta. Aquí es donde el comerciante puede configurar los países en los que desea ofrecer métodos de pago SeQura e ingresar los ID del comerciante para cada uno de ellos.
Paso 3:Después de vender con éxito la configuración de países, el comerciante es redirigido al paso de configuración de widgets promocionales. Aquí, los comerciantes pueden configurar la apariencia de los widgets promocionales antes de colocarlos en las páginas del escaparate.
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
El comerciante puede filtrar y ver los métodos de pago importados para cada país vendedor en la página de métodos de pago.
Administrar configuraciones generales
El comerciante puede configurar los ajustes principales de la integración de SeQura.
Administrar la configuración de conexión
El comerciante puede desconectar sus credenciales API actuales o cambiar la configuración de conexión en cualquier momento.
Filtrar categorías y productos
Dentro de la configuración de seQura, en General Settings, está la sección que nos permite filtrar tanto categorías como productos.
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.
Aconsejamos el siguiente procedimiento:
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 que los comerciantes hayan habilitado y configurado los widgets promocionales en la configuración de integración, pueden agregarlos a las páginas de productos y carritos en la tienda utilizando el mecanismo nativo de Magento 2 con bloques y widgets.
Paso 1: Crear un bloque
En Contenido > Bloques, los comerciantes deben crear un bloque y colocar un componente de diseño (fila, columnas o pestañas). Luego, el comerciante debe arrastrar y soltar el widget promocional de SeQura dentro del componente de diseño:
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, lo guardamos.
Paso 2: Crear un widget
En Contenido > Widgets, el comerciante debe crear un nuevo widget y elegir el bloque seQura creado en el paso anterior:
Para crear un nuevo widget, hay que crear el widget como type CMS static block escogiendo el tema activo.
Luego el comerciante puede configurar en qué páginas se mostrarán los bloques. Es esencial que se marque la opción All Store Views en el campo Assign to Store Views:
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
Para la página de producto, en el apartado de layout updates hay que seleccionar All Product Types en el campo Display on.
Configuración para mostrar el widget debajo del producto:
Configuración para mostrar el widget en el carrito:
Configuración para mostrar el widget en la lista de productos (desde la configuración de seQura):
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
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.
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.
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.
Interacción de métodos de pago
Una vez que 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. Luego de seguir las instrucciones descritas en el formulario, se deberá 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 recibido por la página de agradecimiento 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 información de 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
El comerciante puede actualizar un pedido realizado con el método de pago SeQura en 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
El comerciante 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
El comerciante 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, los comerciantes deben 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.
