Module installation

Composer ensures you always have the latest files and their dependencies. HeyLight is hosted in a private Composer repository, so there are two steps.

Step 1 — Add the repository to your project. Replace <TOKEN_FROM_HEYLIGHT> with the token provided by our support team:

composer config repositories.heidi-pay composer https://token:<TOKEN_FROM_HEYLIGHT>@heidi-pay.repo.packagist.com/heylight-ch/

Step 2 — Install the module(s) you need with composer require <name>:

heylight/ch-ratenzahlung   # Buy Now, Pay Later in instalments (0% interest)
heylight/ch-finanzierung   # Pay in instalments with interest

After installation, run magento setup:upgrade and any native build commands your installation requires.

The package consists of two ZIP files — a core module and a branded module (HeidiPay or PagoLight). Both are extracted into app/code/HeidiPay. First, upload both files to the Adobe Commerce root directory, then:

# 1. Create the HeidiPay directory
mkdir -p app/code/HeidiPay

# 2. Unzip the core extension
unzip -o ecom-magento-core.zip -d app/code/HeidiPay/Core

# 3. Unzip the brand extension(s)
unzip -o ecom-magento-brand-heidipay.zip -d app/code/HeidiPay/HeidiPay
# or, for PagoLight:
unzip -o ecom-magento-brand-pagolight.zip -d app/code/HeidiPay/PagoLight

Note that the exact commands depend on the operating system you are using.

Post-install

1. Run bin/magento setup:upgrade as usual after installing new extensions, and verify that HeidiPay_Core is present in app/etc/config.php.

2. Navigate to Stores > Configuration.

   

3. Navigate to Sales > Payment Methods.

   

4. Configure as required (see below).