BOXO Reusable Packaging for Magento 2




Powerful Magento 2 BOXO Integration for Reusable Shipping Packaging
Let customers choose reusable packaging at checkout
More and more shoppers want their online orders to arrive without a pile of cardboard and plastic. BOXO makes that possible with reusable shipping packaging on a deposit system: the customer receives the order in a sturdy box and returns it at a BOXO drop-off point nearby.
The BOXO Reusable Packaging extension brings that choice into your Magento 2 checkout. During the shipping step, customers pick reusable packaging against a refundable deposit or regular disposable packaging, and the module checks in real time whether the box can actually be returned near their address.
Developed by Magmodules in partnership with BOXO, the extension handles availability, pricing, product rules and order handling for you, so offering sustainable shipping takes a few settings instead of a development project.

Reusable or Disposable, Chosen in the Shipping Step
The packaging choice appears right where it belongs: in the shipping step, next to the delivery details. Reusable packaging is preselected by default, so customers actively opt out instead of having to find the sustainable option themselves. Prefer a softer introduction? Preselect disposable packaging instead.
Pricing is handled correctly for both options:
- Reusable packaging: charged as a refundable deposit set by BOXO, without VAT, because a deposit is not a sale.
- Disposable packaging: offered for free, or with a small surcharge that follows your store's tax rules.
- No empty lines: when disposable packaging is free, no line item is added, while the choice is still saved on the order.
An info icon next to the reusable option explains how returning works. It links to the BOXO return locations by default, or to your own information page if you prefer.

Real-time availability
Checks the shipping postal code against the BOXO API, so reusable packaging only shows where it can be returned.
Product rules
Decide which products qualify and how many items fit in one reusable container.
Deposit and surcharge
A refundable deposit without VAT, with an optional taxable surcharge on disposable packaging.
Order visibility
The chosen packaging shows on the admin order view and is filterable in the order grid.
Only Offered Where the Box Can Come Back
A deposit only makes sense if the customer can get it back. As soon as the shipping address is complete, the module asks the BOXO API whether the postal code is serviceable. Only then, and only when the cart qualifies under your product rules, do the packaging options appear.
Built for the Dutch BOXO network
BOXO returns currently work in the Netherlands, so the check only runs for Dutch addresses. Customers elsewhere simply see your regular checkout, and you never sell a deposit that nobody can reclaim.
Light on your checkout
The availability check is a single API call, made once the address is complete. It is skipped for non-Dutch addresses and never made while the module is disabled, so your checkout stays fast.


Decide Exactly Which Products Qualify
Not everything fits in a reusable box. A parasol, a framed mirror or a 25 kg bag of compost belongs in regular packaging. With the product rules you decide which products may ship in reusable packaging, using one of three modes: all products, all products except the ones you select, or only the products you select.
Each mode reads its own product flag, so you can run a pilot on a single brand, switch to a full rollout later and keep your list intact. Products are marked in bulk from the product grid with Update Attributes, with no product-by-product editing needed.
Set how many items fit in a container
Use the maximum products setting to cap how many items still fit in one reusable container. The cap counts total quantity, so five identical T-shirts count as five, and configurable or bundle products are counted once through their parent. If a single product in the cart is not allowed, or the cap is exceeded, the cart falls back to disposable packaging, because the order ships as one parcel.
The Packaging Choice Travels With the Order
Your warehouse needs to know which box to use without asking. The chosen packaging is stored on the order and shown on the admin order view, and you can filter on it in the order grid, so fulfilment can pick and pack the right way from the start.
Because the choice is saved on the order itself, it is always there, whether or not a line item was added. That keeps reporting reliable and saves your customer service team from guessing.
In-store pickup handled automatically
When a customer switches to in-store pickup, the packaging line is removed. A parcel that is never shipped needs no shipping packaging, so there is nothing extra to configure.

Set Up in Minutes, Test Before You Go Live
Install the extension, paste your BOXO API key and press Test Connection. The test tells you exactly what is going on: the key works, BOXO rejected the key, or the API could not be reached at all, so you know whether to look at your key or at your server.
composer require magmodules/magento2-boxo
The module ships disabled, so nothing changes in your checkout until you are ready. A built-in Selftest checks your PHP and Magento version, the module status, the BOXO packaging products and the API connection in one go, and the debug and error logs can be viewed straight from the configuration screen, without shell access.
Adds reusable and disposable packaging options to the Magento 2 checkout.
Checks BOXO availability in real time on the Dutch shipping postal code.
Charges a refundable deposit without VAT for reusable packaging.
Optional taxable surcharge for disposable packaging, or offer it for free.
Product rules with three modes and a maximum number of items per container.
Packaging choice on the admin order view and filterable in the order grid.
Magento 2 BOXO Integration: Technical Details for Developers and Store Owners
The advantages for developers
The extension supports Magento 2.4.6 to 2.4.9 on PHP 8.1+ and follows the Magento coding standard. On installation it creates two virtual products (the reusable deposit and the disposable fee) plus the product attributes for the eligibility rules. The API key is stored encrypted and only written to the debug log in masked form. Every pull request runs PHP linting, the Magento coding standard, PHPStan and unit tests, and a Playwright end-to-end suite tests the checkout against a stand-in BOXO API, including the error paths.
Good to know for store owners
For store owners, the extension makes sustainable shipping a standard part of your checkout. Customers get a clear choice, the deposit and surcharge are calculated correctly, and your team sees the chosen packaging on every order. Start with a pilot on part of your catalogue, roll out when you are ready and manage everything from the Magento admin, without a developer.

Make Reusable Packaging the Default Choice
Every reusable box that goes out replaces a disposable one that would have ended up in the bin. BOXO sums it up in its own motto: small effort, big impact. For your customers it takes one click in the checkout and a short walk to a drop-off point.
With the BOXO Reusable Packaging extension, your Magento 2 store offers that choice where it counts: at checkout, only where it works, and with the deposit handled correctly. It is a simple way to cut packaging waste, show customers where you stand and make sustainable shipping part of how your store works every day.
Knowledgebase
All familiar Help articles
A list of the most frequently asked questions from the BOXO Reusable Packaging extension for Magento 2. We've tried our best to help you with the installation, configuration and troubleshooting. If you do not find the answer you were looking for, you can always send us a message through this form.
Installation articles
Configuration

Adobe Commerce Marketplace Approved
This extension is listed on the official Adobe Commerce Marketplace and has passed their review process for code quality, performance and security.
Adobe Marketplace approval means the extension follows Magento coding standards and integrates properly with the platform. Updates go through the same review process.

Hyvä Compatible Plugin
This extension includes full support for Hyva Themes. All frontend components, widgets and templates work natively with Hyva's Alpine.js and Tailwind CSS stack.
The extension works out of the box on Hyva and is tested with every new Hyva release to ensure continued compatibility.

GraphQL Made Ready
This extension exposes its data and configuration through Magento's GraphQL API. You can query and mutate data directly from headless frontends or custom applications.
The GraphQL schema follows Magento's conventions and covers all key functionality of the extension. This makes it ready for PWA Studio, Vue Storefront or any other headless setup.

Magento Cloud Support
This extension is fully compatible with Adobe Commerce Cloud (Magento Cloud). It works with the read-only filesystem, the build and deploy pipeline and cloud-specific caching layers.
No additional configuration or workarounds are needed for cloud environments. The extension handles static content deployment and config management the same way as on-premise installations.