Purpose: Enable Sendcloud compatibility with Hyvä Themes and Hyvä Checkout in Magento 2.
Related articles
Overview
Important: If you have not yet connected Magento 2 with Sendcloud, first complete the setup in the Magento 2 Integration guide, then return to this page to install the Hyvä Bridge.
The Sendcloud Hyvä Bridge is a compatibility module that ensures the Sendcloud Magento 2 plugin works correctly with Hyvä Themes and Hyvä Checkout. It enables the Sendcloud service point picker and shipping features to display and function properly during checkout.
Note: The Hyvä Bridge is fully CSP-compliant and supports PCI DSS v4 / Magento 2.4.7+.
When you need the bridge
- You use Hyvä Themes and/or Hyvä Checkout in Magento 2.
- You have the Sendcloud Magento 2 extension v2.0.0+ installed.
- The service point picker is missing or not working as expected in checkout.
If you use Magento’s default checkout or a different checkout extension, you typically don’t need this bridge.
Installation
Requirements
- Magento 2.3+
- Sendcloud Magento 2 plugin v2.0.0+
- Hyvä Checkout 1.1+
- Valid Hyvä license
Where to find the bridge
Follow these steps to install the Hyvä Bridge using Composer:
-
Add the Sendcloud Hyvä repository — so Composer knows where to fetch the bridge:
composer config repositories.sendcloud-hyva git https://gitlab.com/sendcloud-public/sendcloud-magento-hyva.git
-
Install the bridge module — downloads and adds it to your project:
composer require sendcloud/sendcloud-magento-hyva
-
Enable and register the module in Magento:
bin/magento module:enable SendCloud_Hyva bin/magento setup:upgrade bin/magento setup:di:compile
-
Clear Magento caches to apply changes:
bin/magento cache:flush
Verify your setup
- Open your Hyvä Checkout page in the storefront.
- Confirm the Sendcloud service point picker appears and can be opened/used.
- Open the browser console and confirm there are no CSP (Content Security Policy) errors.
- In your Sendcloud account, verify that orders continue to sync as expected.