LokiCheckout_MelissaAddressValidator
Validates checkout addresses against the Melissa Global Address API within the Loki Checkout for Magento 2.
Functionality
Right before the order is placed, a hidden Loki checkout component sends the quote's shipping address (and the billing address when it differs and is not the same as shipping) to the Melissa Global Address API.
- If the address is fully verified, the order is placed as normal.
- If Melissa cannot fully verify the address or returns a correction, a modal opens showing
the original and the suggested address side by side (per address). Order placement
is blocked until the shopper chooses:
- Use Suggested Address – the corrected address is persisted to the quote server-side, then the order is placed.
- Use Original Address – the entered address is kept and the order is placed.
All validation and address changes happen server-side; the browser only drives the UI.
Configuration
Stores > Configuration > Loki Checkout > Melissa Address Validator
(loki_checkout/melissa_address_validator/*):
- Enable – turn the validation on/off.
- Melissa License Key – your Melissa API license key.
- Melissa Customer Id – your Melissa identity / customer id.
- Show Address Errors On Frontend – include Melissa result-code messages in the modal.
Notes
- Requires
LokiCheckout_Core - API errors are logged to
var/log/melissa_address_validator.log. - On a technical API failure the module fails open (the order is not blocked).
Current status
Support
For getting support, create an Issue under the following project URL:
https://gitlab.yireo.com/loki-checkout/LokiCheckout_MelissaAddressValidator.git
Configuration Options
The following options of this module can be configured via the Store Configuration:
loki_checkout/melissa_address_validator/enable
loki_checkout/melissa_address_validator/license_key
loki_checkout/melissa_address_validator/customer_id
loki_checkout/melissa_address_validator/show_errors_frontend
Loki Components
The following LokiComponents are created or references in this module:
loki-checkout.sidebar.melissa_address_validator
Module Dependencies
The following dependencies are declared in the module its `etc/module.xml` file:
LokiCheckout_Core
Loki_Base
Loki_Components
Loki_CssUtils
Loki_FieldComponents
Magento_AdminNotification
Magento_Backend
Magento_Catalog
Magento_CatalogInventory
Magento_Checkout
Magento_CheckoutAgreements
Magento_Cms
Magento_Config
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
Yireo_CspUtilities
Composer details
LokiCheckout_MelissaAddressValidatorloki-checkout/magento2-melissa-address-validator
ext-json: *
ext-pcre: *
guzzlehttp/guzzle: ^7.13
loki-checkout/magento2-core: ^2.5
loki/magento2-components: ^2.6
loki/magento2-css-utils: ^1.1
magento/framework: ^103.0
magento/module-backend: ^102.0
magento/module-checkout: ^100.4
magento/module-config: ^101.2
magento/module-directory: ^100.4
magento/module-quote: ^101.2
magento/module-store: ^101.1
php: >=8.2 <8.6
psr/log: ^3.0
Releases
| 1.0.1 | 10 November 2026 |
| 1.0.0 | 10 November 2026 |
Changelog
[1.0.1] - 09 November 2026
Fixed
- Add
trim()its second argument for PHP 8.6 compatibility - Remove PHP 8.1 support, add PHP 8.5 support
[1.0.0] - 16 July 2026
- Initial release