LokiCheckout_CheckoutViaBol

Overview

This module integrates the bol module (Bol_CheckoutViaBol, "bol.checkout") with Loki Checkout for Magento 2, both with Luma and Hyvä.

Features

• Fast checkout button "bol.checkout" for guests, at the top of the Loki Checkout
• Payment method cvb: after placing the order, the customer is redirected to bol to pay

Requirements

• Magento 2.4.x
• PHP 8.2 or higher
• bol/magento2-module-checkoutviabol ^1.5, installed from the bol composer repository
• loki-checkout/magento2-core ^2.0

Installation

The bol module is only available from the bol composer repository. Add this repository first:

composer config repositories.bol composer https://cvb.composer.bol.com/

Warning: Without this repository, composer looks for bol/magento2-module-checkoutviabol on Packagist, where a package with the same name exists that is not the bol module.

composer require loki-checkout/magento2-checkout-via-bol
bin/magento module:enable Bol_CheckoutViaBol LokiCheckout_CheckoutViaBol
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean

Configuration

Configure the bol module under Stores → Configuration → Sales → Payment Methods → bol.checkout (merchant ID and secret).

The fast checkout button is shown when:

• the customer is a guest;
• the bol payment method is enabled and its merchant credentials are valid;
• the bol setting to show the buttons is enabled;
• the customer did not just return from bol.

How It Works

• The fast checkout button is added to the block loki-checkout.fast_checkout ("Pay faster with"). Clicking it creates a bol session (cvb/session/create) and redirects the customer to bol. When this fails, an error message is shown and the button can be used again.
• When the customer pays with the cvb payment method, Loki Checkout redirects to cvb/order/redirect after placing the order. This relies on the session redirect fallback of LokiCheckout_Core.

Testing

The Playwright tests need the fixture module LokiCheckout_CheckoutViaBolTestFixture (in Test/Fixture/), which fakes a bol API token. Never install it in production. Hersir installs it via hersir-additional.sh, GitLab CI via .gitlab-ci/composer-additional.sh.

Current status

Support

For getting support, create an Issue under the following project URL:

https://gitlab.yireo.com/loki-checkout/LokiCheckout_CheckoutViaBol.git