LokiCheckout_RouteCom

This integration is available in the paid plans for the Loki Checkout. Support for this integration is provided as is, because we are depending upon the original vendor as well. High priority support is only available on an hourly basis.
Integration
Payment
Professional
PHP 8.2 - 8.5
Magento 2.4.6 - 2.4.9
CSP Yes
Unit Tests 15
Integration Tests 20
PHPStan 9
Magento PHPCS 6
License OSL-3.0
Latest Release 0.0.1

Loki Checkout compatibility with Route Shipping Protection (route/route-m2).

Features

  • Adds a "Route Shipping Protection" checkbox below the shipping methods, showing the premium that Route quotes for the current cart. Ticking it adds the Route fee to the totals; unticking it removes the fee again.
  • The checkbox only shows when Route is enabled, merchant tokens are configured, the merchant is valid and the Route quote is paid by the customer (not for paid_by_merchant or no_coverage).
  • Selecting a shipping or payment method that is excluded in the Route configuration removes the protection (and fee).
  • Shows the Route fee with its title in the checkout totals (Route itself returns a plain string title, which Magento drops from the totals segments).

Placing the order, copying the fee to the order and sending the order to Route are done by route/route-m2 itself.

Installation

Install this package via composer:

composer require loki-checkout/magento2-route-com

Next, enable this module:

bin/magento module:enable Route_Route LokiCheckout_RouteCom

Configuration

Configure Route under Stores > Configuration > Route > Route (route/route/*): enable it and enter the merchant public token and secret token. Route reads these tokens directly from the database (core_config_data).

PHP 8.5

route/route-m2 (1.3.19) only allows PHP up to 8.4. To try it on PHP 8.5 anyway, install with COMPOSER_IGNORE_PLATFORM_REQ=php+ composer require loki-checkout/magento2-route-com.

Testing

The tests never call the Route API. The development-only module LokiCheckout_RouteComTestFixture (Fixture/RouteComTestFixture, not part of the distributed package) replaces the Route merchant, quote and order clients by fakes. Its quote is configured with loki_checkout_route_com_fixture/quote/type (paid_by_customer, paid_by_merchant or no_coverage) and loki_checkout_route_com_fixture/quote/premium. hersir-additional.sh installs it in Hersir. Integration tests apply the same fakes with the data fixture Test/Integration/Fixture/FakeRouteApi, which needs the fixture package to be installed (autoloaded).

Current status

pipeline success

Support

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

https://gitlab.loki-extensions.com/loki-checkout/LokiCheckout_RouteCom.git

Loki Components

The following LokiComponents are created or references in this module:

loki-checkout-route-com.shipping.route_protection loki-checkout.payment.methods
Module Dependencies

The following dependencies are declared in the module its `etc/module.xml` file:

Aheadworks_OneStepCheckout LokiCheckout_Core Loki_Base Loki_Components Loki_CssUtils Loki_FieldComponents MagePal_CustomShippingRate Magento_AdminNotification Magento_Backend Magento_Catalog Magento_CatalogInventory Magento_Checkout Magento_CheckoutAgreements Magento_Cms Magento_Config Magento_Cookie Magento_Csp Magento_Customer Magento_Directory Magento_Eav Magento_Indexer Magento_MediaGalleryUiApi Magento_Newsletter Magento_Payment Magento_Quote Magento_Rule Magento_Sales Magento_SalesRule Magento_SalesSequence Magento_Shipping Magento_Store Magento_Tax Magento_Theme Magento_Ui Magento_User Magento_Variable Magento_Vault Magento_Widget Onestepcheckout_Iosc Route_Route Swissup_Firecheckout Yireo_CspUtilities
Composer details
Magento module name
LokiCheckout_RouteCom
Composer name
loki-checkout/magento2-route-com
Composer version
No release yet
Default branch
main
Requirements
loki-checkout/magento2-core: ^2.8
loki/magento2-components: ^2.10
loki/magento2-css-utils: ^1.1
magento/framework: ^103.0
magento/module-customer: ^103.0
magento/module-quote: ^101.2
magento/module-sales: ^103.0
magento/module-store: ^101.1
php: >=8.2 <8.6
route/route-m2: ^1.3
Releases
0.0.1 22 November 2026
Changelog

[0.0.1] - 17 November 2026

Added

  • Add Route shipping protection toggle to the Loki Checkout

Last modified: November 17, 2026