Install the Magento module

Note

Hotsale delivers the module to affiliated merchants; it is not on Marketplace or any public repository. If you don’t have it yet, see Affiliation and support. Depending on your plan, Hotsale can also install it for you.

Requirements

Requirement	Value
Platform	Magento Open Source / Adobe Commerce 2.4.4 to 2.4.8, or Mage-OS 3.x
PHP	8.1 to 8.4
Currency	PEN (soles)
Magento cron	Required: the connector and expiry run every minute
Outbound HTTPS	The server must be able to reach the platform URL

What you receive

Three modules, copied into app/code/PaginasWeb/:

Module	What it does
PaginasWeb_YapePayment	Yape payment method, unique amount, 15-min expiry, approval
PaginasWeb_YapeConnector	Publishes orders to the platform and applies matches per your policy
PaginasWeb_YapeLuma	Checkout and success-page presentation for Luma, Martfury and Amasty

Installation

Caution

Back up code and database before installing and, if possible, try it on staging first.

1. Copy the modules into your installation:

   # from the Magento root
   mkdir -p app/code/PaginasWeb
   cp -r /delivered/path/YapePayment   app/code/PaginasWeb/
   cp -r /delivered/path/YapeConnector app/code/PaginasWeb/
   cp -r /delivered/path/YapeLuma      app/code/PaginasWeb/

2. Enable them:

   bin/magento module:enable PaginasWeb_YapePayment PaginasWeb_YapeConnector PaginasWeb_YapeLuma

3. Upgrade and deploy depending on your store’s mode:

   Production

   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. Make sure Magento cron runs every minute:

   bin/magento cron:install   # if not installed yet
   crontab -l                 # the bin/magento cron:run line must be there

5. Verify the installation:

   bin/magento module:status | grep PaginasWeb_Yape

   The admin must show Stores → Configuration → Sales → Payment Methods → Yape (Hotsale Detector) and Stores → Configuration → Sales → Yape Connector.

Scheduled jobs it adds

Job	Frequency	Purpose
paginasweb_yape_expire_orders	Every minute	Cancels unpaid Yape orders on expiry and releases their amount
paginasweb_yape_connector_publish_orders	Every minute	Publishes open orders and their changes to the platform
paginasweb_yape_connector_sync_matches	Every minute	Collects matches and applies them per your policy
paginasweb_yape_connector_purge_data	Daily (03:17)	Cleans up old connector data

Next step

1. Configure the payment method.
2. Configure the connector with your secret key.