Mondial Relay
Ship orders with Mondial Relay
medusa-mondialrelay
A Medusa v2 fulfillment provider plugin for Mondial Relay shipping services. Supports both Point Relais (pickup point) and Home Delivery options with real-time pricing via @frontboi/mondial-relay.
Features
- πͺ Point Relais - Pickup point delivery with interactive selector
- π Home Delivery - Door-to-door delivery (+3β¬ surcharge)
- π° Real Pricing - Uses official Mondial Relay pricing via
- π Multi-country - FR, BE, LU, NL, ES, PT, DE, IT, AT
- π·οΈ Label Generation - PDF shipping label creation
- π¦ Shipment Tracking - Tracking number generation
- π¨οΈ Admin Widget - Print labels directly from order details
Requirements
- Medusa v2.0+
- Node.js 18+
- Mondial Relay API credentials (contact Mondial Relay for API access)
Installation
Configuration
1. Add the plugin to medusa-config.ts
Important: You need to register the plugin in both (for admin extensions) and (for the fulfillment provider).
2. Environment Variables
Create or update your file:
3. Create Shipping Options
In the Medusa Admin, create shipping options:
Point Relais Option
- Go to Settings β Locations & Shipping
- Select your location and add a shipping option
- Set:
- Name:
- Price Type:
- Fulfillment Provider:
Home Delivery Option
- Create another shipping option
- Set:
- Name:
- Price Type:
- Fulfillment Provider:
Note: The plugin automatically applies +3β¬ surcharge for home delivery options.
Free Shipping
Configuration
You can configure a cart total threshold above which shipping becomes free:
Options
| Option | Type | Default | Description |
|---|---|---|---|
| Cart total (in euros) above which shipping is free | |||
| Which delivery types get free shipping |
Free Shipping Modes
- (default): Free shipping applies to both Point Relais and Home Delivery
- : Free shipping only for Point Relais (Home Delivery still charged)
- : Free shipping only for Home Delivery (Point Relais still charged)
Examples
Storefront Integration
Pass the cart total when setting the shipping method:
When and the delivery type matches , the shipping cost will be 0β¬.
Pricing
Real-time Pricing via @frontboi/mondial-relay
The plugin uses for official Mondial Relay pricing based on:
- Package weight (250g to 30kg)
- Destination country (FR, BE, LU, NL, ES, PT, DE, IT, AT)
Home Delivery Surcharge
Home delivery options automatically add a +3β¬ surcharge to the base Point Relais price.
Example Prices (France)
| Weight | Point Relais | Home Delivery |
|---|---|---|
| 500g | ~3.99β¬ | ~6.99β¬ |
| 1kg | ~4.49β¬ | ~7.49β¬ |
| 2kg | ~5.49β¬ | ~8.49β¬ |
| 5kg | ~7.99β¬ | ~10.99β¬ |
Prices are fetched in real-time from Mondial Relay's official pricing grid.
Storefront Integration
Point Relais Selector
For Point Relais delivery, integrate a pickup point selector. The plugin expects:
Recommended: @frontboi/mondial-relay
Home Delivery
Admin Features
Label Printing Widget
The plugin adds a widget to the order details page for:
- β Tracking number display
- β Pickup point info (if applicable)
- π¨οΈ "Print Label" button for PDF download
Supported Countries
| Code | Country |
|---|---|
| FR | France |
| BE | Belgium |
| LU | Luxembourg |
| NL | Netherlands |
| ES | Spain |
| PT | Portugal |
| DE | Germany |
| IT | Italy |
| AT | Austria |
License
MIT Β© ThΓ©o Daguier
Links
- οΏ½ NPM Package
- οΏ½ GitHub Repository
- π§ Contact: theo.daguier@icloud.com

