Comment ajouter plusieurs devises et passerelles de paiement à une boutique WooCommerce

Pour traduire le contenu de votre boutique, consultez Comment traduire WooCommerce dans WordPress.

Avant de commencer

Installez et activez :

WooCommerce avec la devise par défaut de votre boutique définie dans WooCommerce → Réglages → Général, et au moins un produit en ligne.
Le noyau de WPML et le module complémentaire de compatibilité WPML Multilingual & Multicurrency for WooCommerce. Téléchargez le module complémentaire depuis la page de téléchargements de votre compte WPML.

Le multidevise fonctionne sans langues secondaires. Votre boutique n’a pas besoin d’être multilingue pour l’utiliser. Si vous n’avez besoin du multidevise que sur une boutique monolingue, l’extension gratuite WooCommerce Multilingual de WordPress.org le gère également de manière autonome.

Activez le multidevise pour votre boutique

Pour activer le multidevise dans WooCommerce, ouvrez WPML → Paramètres → Multidevise et activez l’option Activer le mode multidevise (Enable the multicurrency mode). Ajoutez ensuite chaque devise dans laquelle vous souhaitez vendre. Pour chaque devise, définissez la position du symbole, le séparateur décimal, le séparateur de milliers et le nombre de décimales. Le formatage des prix correspond à ce que les acheteurs de ce marché attendent.

Votre devise par défaut reste celle configurée dans les propres réglages de WooCommerce sous WooCommerce → Réglages → Général. Les devises supplémentaires que vous ajoutez dans les paramètres Multidevise sont celles vers lesquelles les clients peuvent basculer.

Définissez les prix par devise ou utilisez la conversion automatique

Pour définir les prix dans chaque devise sur une boutique WooCommerce multidevise, choisissez entre les prix manuels par devise ou la conversion automatique des taux de change. Les deux options fonctionnent par devise. Mélangez les prix manuels pour certaines devises et la conversion automatique pour d’autres, ou utilisez une seule approche partout.

Prix manuels par devise – Des chiffres ronds attendus par les clients

Définissez explicitement le prix de chaque produit dans chaque devise. Un produit à 20 $ devient 19,99 € en euros et 3 000 ¥ en yens. Des chiffres ronds que les clients reconnaissent, et non le résultat d’une division par un taux de change en direct. Vous définissez les prix manuels sur l’écran de modification de chaque produit, dans le panneau multidevise qui apparaît à côté des champs de prix standard de WooCommerce.

La tarification manuelle est le bon choix pour la plupart des boutiques vendant sur des marchés établis. Elle vous permet de tarifer chaque marché de manière intentionnelle. Appliquez des remises sur certains marchés, et des prix premium sur d’autres. Vous ne laissez pas le taux de change de la veille tout dicter.

Conversion automatique à partir du prix source

Définissez le prix source une seule fois. L’extension de compatibilité applique un taux de change et affiche le prix converti dans chaque devise. Configurez le taux dans la section Taux de change automatiques (Automatic Exchange Rates) sous WPML → Paramètres → Multidevise. Définissez les taux manuellement ou récupérez-les en direct à partir d’une source configurée selon un calendrier que vous choisissez.

La conversion automatique est le bon choix pour les boutiques dont les catalogues changent rapidement ou qui proposent de nombreuses devises, où définir chaque prix manuellement serait peu pratique.

Affichez un sélecteur de devise – Widget, bloc ou shortcode

Pour afficher un sélecteur de devise sur votre boutique WooCommerce, vous disposez de trois options d’emplacement. Choisissez celle qui convient à l’endroit où vous souhaitez que le sélecteur apparaisse.

Bloc. Déposez le bloc Sélecteur de devise (Currency Switcher) dans n’importe quelle page ou article via l’éditeur de blocs de WordPress.
Widget. Faites glisser le widget Sélecteur de devise (Currency Switcher) dans n’importe quelle zone de widget via Apparence → Widgets.
Shortcode. Collez [currency_switcher] dans n’importe quelle page, article ou modèle où vous souhaitez que le sélecteur apparaisse.

Configurez l’apparence du sélecteur dans la section Options du sélecteur de devise sous WPML → Paramètres → Multidevise. Vous pouvez choisir un menu déroulant, côte à côte ou une liste. Vous pouvez également choisir uniquement le symbole, uniquement le code, ou les deux. Les paramètres s’appliquent à chaque emplacement.

Référence du shortcode du sélecteur de devise

Le shortcode [currency_switcher] accepte ces attributs :

format. Contrôle la façon dont chaque devise s’affiche. Jetons : %name (nom complet de la devise, par ex. Euro), %symbol (par ex. €), %code (par ex. EUR), %subtotal (sous-total du panier dans cette devise). Exemple : [currency_switcher format="%name (%symbol)"] affiche Euro (€).
switcher_style. Le style visuel. Valeurs : wcml-dropdown, wcml-dropdown-click, wcml-horizontal-list, wcml-vertical-list.

Exemple avec les deux attributs :

[currency_switcher format="%code %symbol" switcher_style="wcml-dropdown"]

Pour une personnalisation plus poussée, comme la création de votre propre modèle de sélecteur, il existe une référence de fichiers modèles distincte pour les développeurs.

Affichez différentes passerelles de paiement par pays et par devise

Pour router les passerelles de paiement par devise, ouvrez WPML → Paramètres → Multidevise et cliquez sur Modifier pour chaque devise dans le tableau des devises. Chaque devise répertorie les passerelles de paiement disponibles avec des cases à cocher. Activez les passerelles qui fonctionnent pour cette devise. Désactivez celles qui ne fonctionnent pas. Les clients ne voient que les options de paiement qui s’appliquent à la devise dans laquelle ils paient.

C’est la bonne façon de gérer les boutiques vendant dans plusieurs régions. Votre compte Stripe par défaut peut traiter les dollars tandis qu’un compte Stripe régional ou une passerelle locale traite une autre devise. Les clients payant dans chaque devise voient la passerelle liée à cette devise, et non toutes en même temps.

Changez automatiquement de devise en fonction de l’emplacement du visiteur

Pour changer automatiquement de devise en fonction de l’emplacement du visiteur, ouvrez WPML → Paramètres → Multidevise et dans la section Devises, choisissez Emplacement du client (Client Location) au lieu de Langue du site (Site language) sous Afficher les devises en fonction de (Show currencies based on). Cette option nécessite une clé de licence MaxMind pour la détection du pays basée sur l’IP. L’extension détecte alors le pays du visiteur et affiche la devise de ce pays par défaut. Vous associez chaque pays à une devise dans le même panneau de paramètres.

Les clients peuvent toujours changer manuellement si vous avez ajouté un sélecteur de devise à la page. Les deux fonctionnent ensemble. La détection de l’emplacement définit la valeur par défaut. Le sélecteur est disponible pour les remplacements.

WooCommerce Subscriptions, Bookings et autres types de produits d’extensions

Le multidevise fonctionne avec les principaux types de produits d’extensions WooCommerce. Chacun a son propre comportement à confirmer avant la mise en ligne.

WooCommerce Subscriptions. Les produits d’abonnement récurrents respectent la tarification multidevise. Définissez le prix de l’abonnement dans chaque devise de la même manière que vous définissez les prix des produits. Les paiements de renouvellement sont traités dans la devise dans laquelle le client s’est abonné.
WooCommerce Bookings. Les prix des produits réservables, les montants des acomptes et les coûts par ressource prennent tous en charge la tarification par devise. La confirmation de réservation affiche la devise du client d’un bout à l’autre.
Product Bundles, Composite Products, Mix and Match. Les produits groupés et les composants respectent la configuration de devise et de prix du produit parent.

Pour tout type de produit d’extension, testez un exemple d’achat de bout en bout dans chaque devise avant le lancement. Les paramètres multidevises fonctionnent de manière cohérente sur l’ensemble des extensions. Les règles de tarification spécifiques aux extensions (acomptes, plans de paiement, remises sur les lots) peuvent interagir de manières que vous voudrez vérifier.

Gérez le panier lorsque la devise ou la langue change

Lorsqu’un client change de devise ou de langue en cours de session, son panier contient toujours des articles dont le prix est fixé dans la devise précédente. WPML 5 vous permet de choisir le comportement du panier pour chaque cas séparément. Ouvrez WPML → Paramètres → WCML et faites défiler jusqu’à la section Panier.

Vous verrez deux paires de boutons radio :

Changement de langue lorsqu’il y a des articles dans le panier. Choisissez Synchroniser le contenu du panier lors du changement de langue (Synchronize cart content when switching languages) pour conserver le panier et réévaluer le prix de ses articles, ou choisissez Demander une confirmation et réinitialiser le panier (Prompt for a confirmation and reset the cart) pour demander au client avant de réinitialiser.
Changement de devise lorsqu’il y a des articles dans le panier. Les deux mêmes options pour les changements de devise.

La synchronisation du panier nécessite le cookie de langue de WPML. S’il est désactivé, la section affiche un avis en ligne qui renvoie vers WPML → Paramètres → Langues → Redirection selon la langue du navigateur, où vous activez le cookie.

Pièges courants

Multidevise activé mais aucune devise n’apparaît. Ajoutez au moins une devise en plus de celle par défaut dans WPML → Paramètres → Multidevise → Devises. Seules les devises configurées s’affichent dans le sélecteur.
Le shortcode du sélecteur de devise ne donne rien. Confirmez que le multidevise est activé et qu’au moins une devise est ajoutée. Le shortcode affiche un sélecteur vide lorsqu’il n’existe aucune devise alternative.
La mauvaise passerelle s’affiche pour une devise. Revérifiez les paramètres de passerelle par devise (cliquez sur Modifier pour chaque devise dans le tableau des devises). Chaque devise répertorie les passerelles disponibles et elles doivent être activées explicitement par devise.
L’emplacement du client renvoie la mauvaise devise. Cette option utilise une clé de licence MaxMind pour la détection basée sur l’IP. Les bases de données GeoIP font parfois des erreurs de classification. Votre fournisseur d’hébergement peut également mettre en cache les IP à partir d’un point de présence CDN. Testez avec une nouvelle session de navigateur et confirmez que votre hébergeur transmet la véritable IP du visiteur.
Les prix semblent corrects mais la taxe est erronée. Les paramètres de taxe par emplacement de WooCommerce s’appliquent en plus du prix basé sur la devise. Configurez les classes d’impôts séparément dans WooCommerce → Réglages → TVA.