LokiCheckout_RouteCom
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_merchantorno_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
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
LokiCheckout_RouteComloki-checkout/magento2-route-com
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