PHPackages controlaltdelete/magento2-colissimo-hyva-checkout - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. controlaltdelete/magento2-colissimo-hyva-checkout ActiveMagento2-module[API Development](/categories/api) controlaltdelete/magento2-colissimo-hyva-checkout ================================================= Hyvä Checkout compatibility module for LaPoste Colissimo relay point selection v1.0.0(1mo ago)40MITHTMLPHP ^8.1CI passing Since Apr 20Pushed 1mo agoCompare [ Source](https://github.com/controlaltdelete-nl/magento2-colissimo-hyva-checkout)[ Packagist](https://packagist.org/packages/controlaltdelete/magento2-colissimo-hyva-checkout)[ RSS](/packages/controlaltdelete-magento2-colissimo-hyva-checkout/feed)WikiDiscussions main Synced 1w ago READMEChangelog (1)Dependencies (3)Versions (2)Used By (0) Colissimo Relay Point Picker for Hyvä Checkout ============================================== [](#colissimo-relay-point-picker-for-hyvä-checkout) A Magento 2 module that integrates Colissimo relay point selection into the [Hyvä Checkout](https://www.hyva.io/hyva-checkout.html) experience. Developed by **[Control Alt Delete BV](https://www.controlaltdelete.dev/checkout-services/hyva-checkout)** — a Magento and Hyvä specialist agency with deep expertise in [Hyvä Checkout integrations](https://www.controlaltdelete.dev/checkout-services/hyva-checkout). We've built production-grade shipping, payment, and pickup-point integrations for merchants across Europe, and we hold ourselves to a high bar: the proof is in the pudding — this repo ships with automated end-to-end tests so you know the checkout flow keeps working. This module is an independent, community-developed integration. It is not affiliated with, endorsed by, or developed in partnership with La Poste or Colissimo. --- Screenshots ----------- [](#screenshots) [![Onepage checkout implementation](docs/thumbnails/overview-onepage-checkout.png)](https://github.com/controlaltdelete-nl/magento2-colissimo-hyva-checkout/raw/main/docs/overview-onepage-checkout.png) Onepage checkout [![Multistep checkout implementation](docs/thumbnails/overview-multistep-checkout.png)](https://github.com/controlaltdelete-nl/magento2-colissimo-hyva-checkout/raw/main/docs/overview-multistep-checkout.png) Multistep checkout [![Delivery method label in checkout](docs/thumbnails/delivery-method-label.png)](https://github.com/controlaltdelete-nl/magento2-colissimo-hyva-checkout/raw/main/docs/delivery-method-label.png) Delivery method label [![Address search bar for finding nearby relay points](docs/thumbnails/locations-searchbar.png)](https://github.com/controlaltdelete-nl/magento2-colissimo-hyva-checkout/raw/main/docs/locations-searchbar.png) Address search [![Relay points displayed on Google Maps](docs/thumbnails/colissimo-google-maps-locations.png)](https://github.com/controlaltdelete-nl/magento2-colissimo-hyva-checkout/raw/main/docs/colissimo-google-maps-locations.png) Google Maps view [![List of available Colissimo pick-up points](docs/thumbnails/colissimo-list-pick-up-points.png)](https://github.com/controlaltdelete-nl/magento2-colissimo-hyva-checkout/raw/main/docs/colissimo-list-pick-up-points.png) Pick-up points list [![Opening hours for a relay point](docs/thumbnails/colissimo-available-times.png)](https://github.com/controlaltdelete-nl/magento2-colissimo-hyva-checkout/raw/main/docs/colissimo-available-times.png) Opening hours [![Selected relay point](docs/thumbnails/selected-relay-point.png)](https://github.com/controlaltdelete-nl/magento2-colissimo-hyva-checkout/raw/main/docs/selected-relay-point.png) Selected relay point --- Overview -------- [](#overview) When customers choose the Colissimo relay point (PR) shipping method during checkout, this module presents an interactive picker that lets them search for and select a nearby relay point -- either by entering an address, using their browser's geolocation, or browsing an embedded Google Map. The selected relay point is saved to the quote and passed along to the order, making it available for fulfilment via the standard Colissimo module. Features -------- [](#features) - Relay point search by address (with Google Places autocomplete) or by geolocation - Interactive Google Map with markers for all available relay points - List/map view toggle for browsing results - Opening hours accordion per relay point - Fully reactive UI using Magewire and Alpine.js - Validates checkout step completion (customer must pick a point before proceeding) - Stores selected relay point in the checkout session for downstream processing - Admin configuration for Google Maps API key, default region, and map starting coordinates Requirements ------------ [](#requirements) DependencyVersionPHP8.1 or higherMagento2.4.4 or higher[La Poste Colissimo module](https://commercemarketplace.adobe.com/laposte-magento2-colissimo-module.html)\*Hyvä Checkout1.3 or higherGoogle Maps API key--The La Poste Colissimo module is **free** and must be downloaded and installed separately from the [Adobe Commerce Marketplace](https://commercemarketplace.adobe.com/laposte-magento2-colissimo-module.html). This module is a compatibility layer on top of it — it does not replace or include the Colissimo shipping logic itself. A Google Maps API key with the following APIs enabled is required: - Maps JavaScript API - Places API - Geocoding API > **Note:** Billing must be enabled on your Google Cloud project, even if you stay within Google's free tier. Requests from a key that has no billing account attached will fail silently, and the map will render blank with an `ApiNotActivatedMapError` or similar message in the browser console. Installation ------------ [](#installation) Install via Composer: ``` composer require controlaltdelete/magento2-colissimo-hyva-checkout bin/magento module:enable ControlAltDelete_ColissimoHyva bin/magento setup:upgrade ``` Configuration ------------- [](#configuration) Go to **Stores > Configuration > Carriers > LaPoste > Hyvä Checkout integration** and fill in: FieldDescriptionGoogle Maps API KeyYour Google Maps API keyRegionDefault geocoding region (default: `fr`)Starting LatitudeInitial map centre latitude (default: `48.8566`, Paris)Starting LongitudeInitial map centre longitude (default: `2.3522`, Paris)How It Works ------------ [](#how-it-works) 1. The customer selects the Colissimo relay point (PR) shipping method in Hyvä Checkout. 2. A relay picker modal is shown, prompting the customer to find a pickup point. 3. The customer searches by address or uses their device location. 4. Available relay points are fetched from the Colissimo API and displayed as a list and on a map. 5. When the customer selects a relay point, the quote's shipping address is updated with the relay point's details (name, address, postal code, city, country). 6. The selected relay information is persisted in the checkout session. 7. The checkout step validates that a relay point has been selected before allowing the customer to proceed. Testing ------- [](#testing) The proof is in the pudding: this repository ships with a full suite of automated end-to-end tests written in [Playwright](https://playwright.dev/), covering the relay-point picker, address search, map interactions, and the full checkout flow from cart to order confirmation. Every change is validated against these tests before it lands, so you can upgrade with confidence that the checkout integration keeps working in both onepage and multistep Hyvä Checkout layouts. ``` npm install npx playwright test ``` Test reports are written to `playwright-report/`. Troubleshooting --------------- [](#troubleshooting) **The relay picker opens but the map is blank or the address autocomplete doesn't work.**Check the browser console for errors from `maps.googleapis.com`. The most common causes are: - The Google Maps API key has no billing account attached on the Google Cloud project. - One of the required APIs (Maps JavaScript API, Places API, Geocoding API) is not enabled. - HTTP referrer restrictions on the key don't include your storefront domain. **"Please select a pickup point before proceeding" keeps showing after I picked one.**The selected point is stored in the checkout session under `lpc_relay_information`. If this keeps happening, check that the underlying La Poste Colissimo module is properly configured (account credentials, relay-point shipping method enabled) and that the shipping method code is `colissimo_pr`. **Pickup points fail to load ("An error occurred while fetching pickup points").**This call goes through the La Poste Colissimo SOAP API. Check `var/log/system.log` / `exception.log` — this module logs the upstream error message. Verify the Colissimo account credentials and that the shipping address country is one Colissimo services. **The map view shows deprecation warnings in the browser console.**This module currently uses `google.maps.Marker`, which Google has deprecated in favour of `AdvancedMarkerElement`. The markers still render today; migration is on the roadmap. Changelog --------- [](#changelog) See the [GitHub Releases page](https://github.com/controlaltdelete-nl/magento2-colissimo-hyva-checkout/releases) for version history and upgrade notes. Automated testing is a core part of how [Control Alt Delete](https://www.controlaltdelete.dev/checkout-services/hyva-checkout) delivers checkout integrations — if you need a bespoke shipping, payment, or pickup-point integration for Hyvä Checkout, [get in touch](https://www.controlaltdelete.dev/checkout-services/hyva-checkout). --- About Control Alt Delete ------------------------ [](#about-control-alt-delete) [Control Alt Delete BV](https://www.controlaltdelete.dev/checkout-services/hyva-checkout) is a Magento and Hyvä specialist agency. We build fast, maintainable storefronts and open-source tooling for the Magento ecosystem, with a particular focus on **Hyvä Checkout integrations** — shipping methods, payment providers, pickup-point pickers, and custom checkout steps. Every integration we ship is backed by automated end-to-end tests, because a checkout that silently breaks is worse than no checkout at all. The proof is in the pudding: this repo is a live example of how we work. - Hyvä Checkout services: [controlaltdelete.dev/checkout-services/hyva-checkout](https://www.controlaltdelete.dev/checkout-services/hyva-checkout) - Website: [controlaltdelete.dev](https://www.controlaltdelete.dev) - GitHub: [github.com/controlaltdelete-nl](https://github.com/controlaltdelete-nl) Disclaimer ---------- [](#disclaimer) This module is developed and maintained by [Control Alt Delete BV](https://www.controlaltdelete.dev). It has no affiliation with La Poste, Colissimo, or any of their subsidiaries. All Colissimo trademarks and service names belong to their respective owners. License ------- [](#license) Released under the [MIT License](https://opensource.org/licenses/MIT). Copyright (c) Control Alt Delete BV. ### Health Score 37 — LowBetter than 81% of packages Maintenance90 Actively maintained with recent releases Popularity4 Limited adoption so far Community6 Small or concentrated contributor base Maturity42 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 50d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/ea5f9f50d4d50caa56065f4b55b1dd5aa3f1030402d0487a093200fdefa40f70?d=identicon)[michielgerritsen](/maintainers/michielgerritsen) --- Top Contributors [![michielgerritsen](https://avatars.githubusercontent.com/u/5858697?v=4)](https://github.com/michielgerritsen "michielgerritsen (2 commits)") --- Tags colissimohyvahyva-checkoutla-postemage-osmagentomagento2pickup-pointrelay-point ### Embed Badge ![Health badge](/badges/controlaltdelete-magento2-colissimo-hyva-checkout/health.svg) ``` [![Health](https://phpackages.com/badges/controlaltdelete-magento2-colissimo-hyva-checkout/health.svg)](https://phpackages.com/packages/controlaltdelete-magento2-colissimo-hyva-checkout) ``` ### Alternatives [smile/elasticsuite Magento 2 merchandising and search engine built on ElasticSearch 8054.6M39](/packages/smile-elasticsuite)[mollie/magento2 Mollie Payment Module for Magento 2 1131.8M12](/packages/mollie-magento2)[graycore/magento2-cors A Magento 2 module that enables CORS on the GraphQL and REST Apis 101570.7k](/packages/graycore-magento2-cors)[elgentos/module-prismicio Magento 2 - Prismic.io integration 39116.7k4](/packages/elgentos-module-prismicio)[jomashop/module-new-relic-monitoring-for-gql Send GraphQL transactions to New Relic 15150.8k](/packages/jomashop-module-new-relic-monitoring-for-gql)[zepgram/module-rest Technical module to industrialize API REST call with dependency injection pattern using Guzzle library 1227.8k](/packages/zepgram-module-rest) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)