Dépannage Mondial Relay

Le point relais Mondial Relay ne s’affiche pas sur WooCommerce

Une carte absente n’a pas une cause unique. La méthode peut être exclue avant même l’appel à Mondial Relay, puis la recherche peut échouer à cause de l’adresse, des identifiants ou du serveur.

Réponse rapide. Testez dans cet ordre : zone WooCommerce, tranche tarifaire, poids du produit, adresse complète, code client et clé privée, puis carte et cURL. Cet ordre évite de chercher un problème Maps alors que WooCommerce n’a jamais proposé la méthode.

Par l’équipe WcMultiShipping ·

Carte de sélection des points relais Mondial Relay dans WooCommerce
Résultat attendu : la méthode est tarifée, puis le client choisit un relais sur la carte avant de valider la commande.

1. La méthode Mondial Relay n’apparaît pas dans le checkout

Commencez par WooCommerce > Réglages > Expédition > Zones d’expédition. La méthode Point Relais doit appartenir à la zone qui correspond réellement à l’adresse saisie. Une méthode ajoutée à « France » ne sera pas proposée si une zone plus précise, placée au-dessus, intercepte déjà le code postal sans contenir Mondial Relay.

Le plugin ne retourne aucun tarif lorsqu’aucune ligne ne correspond au panier. Le code compare soit le poids total, soit le montant du panier aux bornes min et max configurées. Une plage de 0 à 1 kg exclut donc un panier de 1 kg : la borne maximale n’est pas incluse. Ajoutez une tranche suivante sans laisser de trou.

  • Méthode activée dans la bonne zone.
  • Produit de test avec poids renseigné.
  • Tranche couvrant exactement ce poids ou ce montant.
  • Classe d’expédition incluse dans la ligne tarifaire.

2. Le bouton existe, mais aucun point relais ne remonte

Les recherches de relais utilisent le code postal et la ville de l’adresse de livraison. Testez avec une adresse complète et un code postal valide. Si le checkout est prérempli par un cache ou une extension d’adresse, modifiez un champ puis attendez le recalcul WooCommerce avant d’ouvrir la carte.

Dans WcMultiShipping, contrôlez ensuite le code client Mondial Relay et la clé privée, puis lancez « Tester les identifiants ». Le plugin considère la connexion prête uniquement lorsque ces deux valeurs sont enregistrées. Une clé copiée avec un espace ou associée à une autre enseigne suffit à faire échouer la recherche.

3. La carte ne s’ouvre pas ou reste vide

WcMultiShipping peut afficher les relais avec la carte configurée dans ses réglages. Si Google Maps est sélectionné, une clé API est obligatoire. Sans clé, le plugin affiche explicitement qu’il ne peut pas présenter le bouton de sélection. Vérifiez aussi que la clé autorise le domaine exact de la boutique et que la facturation Google est active.

La récupération Mondial Relay dépend également de l’extension PHP cURL. Le plugin renvoie une erreur dédiée lorsqu’elle manque. Ce réglage se corrige chez l’hébergeur, pas dans WooCommerce. Après activation, videz le cache de page et le cache d’objets avant de retester.

  • Clé Maps enregistrée si Google Maps est choisi.
  • Domaine autorisé dans la console Google.
  • Extension PHP cURL active.
  • Aucune erreur JavaScript provoquée par le thème ou un plugin d’optimisation.

4. Le relais choisi disparaît avant la commande

Le checkout recalcule les méthodes lorsque l’adresse, le panier ou le moyen de livraison change. Vérifiez que la sélection est toujours visible après ce recalcul, puis terminez une vraie commande de test. Dans l’administration, le relais doit être attaché à la commande et apparaître dans le bloc de livraison.

Si le problème existe uniquement avec le Checkout Blocks ou un tunnel personnalisé, refaites le test avec le checkout WooCommerce standard. Cette comparaison permet de distinguer une erreur de configuration transporteur d’un conflit de rendu ou d’événement JavaScript.