Instalar el módulo en Magento

Nota

El módulo lo entrega Hotsale a los comercios afiliados; no está en Marketplace ni en repositorios públicos. Si aún no lo tienes, ve a Afiliación y soporte. Según tu plan, Hotsale también puede instalarlo por ti.

Requisitos

Requisito	Valor
Plataforma	Magento Open Source / Adobe Commerce 2.4.4 a 2.4.8, o Mage-OS 3.x
PHP	8.1 a 8.4
Moneda	PEN (soles)
Cron de Magento	Obligatorio: el conector y el vencimiento corren cada minuto
Salida HTTPS	El servidor debe poder llamar a la URL de la plataforma

Qué recibes

Tres módulos, que se copian en app/code/PaginasWeb/:

Módulo	Qué hace
PaginasWeb_YapePayment	Método de pago Yape, monto único, vencimiento a los 15 min, aprobación
PaginasWeb_YapeConnector	Publica pedidos a la plataforma y aplica las coincidencias según tu política
PaginasWeb_YapeLuma	Presentación en checkout y página de éxito para Luma, Martfury y Amasty

Instalación

Precaución

Haz un respaldo del código y de la base de datos antes de instalar, y si puedes, prueba primero en un entorno de staging.

1. Copia los módulos en tu instalación:

   # desde la raíz de Magento
   mkdir -p app/code/PaginasWeb
   cp -r /ruta/entregada/YapePayment   app/code/PaginasWeb/
   cp -r /ruta/entregada/YapeConnector app/code/PaginasWeb/
   cp -r /ruta/entregada/YapeLuma      app/code/PaginasWeb/

2. Habilítalos:

   bin/magento module:enable PaginasWeb_YapePayment PaginasWeb_YapeConnector PaginasWeb_YapeLuma

3. Actualiza y despliega según el modo de tu tienda:

   Producción

   bin/magento maintenance:enable
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento setup:static-content:deploy -f es_PE en_US
   bin/magento cache:flush
   bin/magento maintenance:disable

   Developer

   bin/magento setup:upgrade
   bin/magento cache:flush

4. Comprueba que el cron de Magento corre cada minuto:

   bin/magento cron:install   # si aún no está instalado
   crontab -l                 # debe aparecer la línea de bin/magento cron:run

5. Verifica la instalación:

   bin/magento module:status | grep PaginasWeb_Yape

   En el admin deben aparecer Stores → Configuration → Sales → Payment Methods → Yape (Hotsale Detector) y Stores → Configuration → Sales → Yape Connector.

Tareas programadas que añade

Tarea	Frecuencia	Para qué
paginasweb_yape_expire_orders	Cada minuto	Cancela los pedidos Yape impagos al vencer el plazo y libera su monto
paginasweb_yape_connector_publish_orders	Cada minuto	Publica a la plataforma los pedidos abiertos y sus cambios
paginasweb_yape_connector_sync_matches	Cada minuto	Recoge coincidencias y las aplica según tu política
paginasweb_yape_connector_purge_data	Diaria (03:17)	Limpia datos antiguos del conector

Siguiente paso

1. Configura el método de pago.
2. Configura el conector con tu llave secreta.