Sell gift cards and suggest products at checkout.Learn more ›
Skip to content

Carriers ​

This page links your carrier account to Vivlab: you then generate a parcel's label from the order, without typing the address or pickup point again. The carrier you can connect is Mondial Relay, with a business account.

What do you want to do? ​

Connect your Mondial Relay account ​

You need an active Mondial Relay business account, accessible on connect.mondialrelay.com (open one on Mondial Relay's business website if needed).

  1. In Carriers, click Connect Mondial Relay if the page shows its introduction, then Configure (or Edit) on the Mondial Relay row.
  2. Paste the API Brand ID (e.g. BDTEST123), the API Login (e.g. BDTEST123@business-api.mondialrelay.com), the API password and, for parcel tracking, the Private key (optional).
  3. Click Save at the top of the page.

The row switches to Connected and shows your Brand ID, copyable in one click. Then create a Mondial Relay delivery method in Shipping.

Mondial Relay credentials and the private key used for tracking.Mondial Relay credentials and the private key used for tracking.

Production credentials only

Use the credentials under Vos paramètres de production (your production settings): test credentials do not generate real labels. Shipping costs are charged to your Mondial Relay account for each label; without enough credit, the label cannot be generated.

Find your Mondial Relay credentials ​

  1. On connect.mondialrelay.com, click Administration, then Configuration des API (API configuration), and select API Version V2.0.
  2. Under Vos paramètres de production, copy Brand Id API, Login API and Mot de passe API.

API password missing or lost: click Régénérer des identifiants d'API (regenerate API credentials) in your Mondial Relay account. In Vivlab, Where to find this information? shows a screenshot of the relevant page.

Turn on parcel tracking ​

Get the private key from your Mondial Relay account (Administration, where the credentials are), click Edit on the Mondial Relay row, paste it into Private key and save. The Tracking on badge appears and tracking shows on your orders, up to 1 hour later.

Ship with another carrier ​

Colissimo, Chronopost, UPS or a local courier do not connect to Vivlab: no label is generated for them. Create a Package shipping method in Shipping, print the label with your carrier, then confirm the shipment on the order by choosing La Poste, Chronopost, Mondial Relay, UPS or a custom link. The customer gets the shipping email with their tracking link.

Good to know ​

  • The Mondial Relay row shows Not configured with no credentials, Incomplete if one is missing, Connected with all three.
  • In Shipping, the "business plan" banner of a Mondial Relay method stays visible while the private key is missing, even with all three credentials.
  • The Mondial Relay label accepts a parcel from 0.1 to 25 kg, with optional dimensions (64 cm maximum per side) and optional additional insurance.

Documentation crafted with ❤️ by our in-house team.