Magento - kueski-dev/Dev-Center GitHub Wiki

Antes de iniciar

Los requisitos para instalar el método de pago Kueski Pay en Magento son los siguientes:

  • Versión Magento: >= 2.4.0 || 2.4.6 <=
  • Versión PHP: >= 7.4 || 8.2 <=
  • Versión Composer: composer V2.X

[!TIP] Tener a la mano la llave API KEY y API SECRET proporcionada por el equipo de Kueski, ya que serán solicitadas durante la sección Configurar módulo de Kueski Pay.

Instalar módulo de Kueski Pay

Los siguientes pasos a seguir son necesarios para instalar el módulo de Kueski Pay en tu plataforma de Magento y poder hacer uso de su método de pago.

  1. Abre la terminal.
  2. Ve a la carpeta raíz del proyecto de Magento. (Esta carpeta puede variar de un proyecto a otro).
  3. Escribe en la terminal el siguiente comando: 
bin/composer config repositories.kueski composer https://repo.packagist.com/kueski
  1. Añade a Composer la llave para obtener el módulo:
composer config --global --auth http-basic.repo.packagist.com token 45a3f4718d0db6184116e28d94c7c705f338b085e358d40b7792342e3ca5
  1. Instala el módulo de Kueski Pay:
composer require kueski/magento2-payment
  1. Actualiza Composer:
composer update

[!IMPORTANT] Este paso es opcional.

  1. Incluye el módulo de Magento en la tienda:
php bin/magento setup:upgrade
  1. Compila para incluir el nuevo módulo:
php bin/magento setup:di:compile
  1. Limpia el caché de Magento:
php bin/magento cache:clean
php bin/magento cache:flush
  1. Despliega y actualiza los módulos en la tienda:
php bin/magento setup:static-content:deploy

[!WARNING] Este paso es únicamente para la tienda en modo producción.

Configurar módulo de Kueski Pay

  1. Ingresa a tu tienda de Magento.
  2. En el menú del lado izquierdo, sigue el siguiente flujo STORES -> Configuration. Ejemplo paso 2

Imagen 1. Ejemplo paso 2

  1. En la sección Sales haz click en Payment Methods. Ejemplo paso 3

Imagen 2. Ejemplo paso 3

  1. Selecciona el método de pago Kueski
  2. Llena los campos con la siguiente información:
    • Enabled: Yes
    • Title: Kueski
    • New Order Status: Pending
    • Payment from Applicable Countries: All Allowed Countries
    • Sandbox:
      • Ambiente de Producción: No
      • Ambiente de Sandbox: Yes
    • Mostrar en Ventana Emergente: No
    • Api Key: {{API KEY}}
    • Api Secret Key: {{API SECRET}}

[!WARNING] El API KEY y API SECRET ingresados deberán de corresponder al ambiente que se haya seleccionado en el campo Sandbox.

Ejemplo paso 5

Imagen 3. Ejemplo paso 5

Ejemplo paso 5

Imagen 4. Ejemplo paso 5

  1. Llena los campos de la sección Widget Attributes con la siguiente información:
    • Font Size: 12
    • Text Align: left

Ejemplo paso 6

Imagen 5. Ejemplo paso 6

Actualizar módulo de Kueski Pay

En caso de tener el módulo instalado y desactualizado, será necesario actualizarlo ejecutando los siguientes comandos en la terminal:

composer clear-cache
composer update kueski/magento2-payment
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:clean
php bin/magento cache:flush