L’ordre des réglages, boutique fermée
Ce guide part d’une boutique déjà installée (voir le guide pour installer WordPress sur votre hébergement) et d’un prestataire de paiement déjà choisi : ClicToPay, Flouci, GPG et l’e-Dinar de La Poste sont comparés dans notre article sur les solutions de paiement en ligne en Tunisie.
Gardez la boutique invisible tant que rien n’est vérifié : dans WooCommerce > Réglages > Visibilité du site, le mode « Bientôt disponible » montre une page d’attente au public, sauf aux administrateurs et gestionnaires de boutique connectés et aux détenteurs du lien privé [1]. Ensuite, dans cet ordre :
- devise et décimales ;
- taxes ;
- livraison et paiement à la livraison ;
- comptes clients ;
- passerelle de carte, en mode test, sur une copie ;
- tests de bout en bout, puis ouverture.
Ce que nos packs e-commerce prennent en charge est résumé plus bas ; les lenteurs et les pannes d’une boutique en service ont leur propre méthode, dans le guide pour traiter un incident sans perdre de commandes.
Le dinar et ses millimes
WooCommerce ne gère qu’une devise de base par boutique [2] : « Dinar tunisien », dans WooCommerce > Réglages > Général, suivi de quatre champs : position du symbole, séparateurs des milliers et des décimales, nombre de décimales [2].
Le dernier compte le plus. La table des pays de WooCommerce associe trois décimales à la Tunisie, virgule décimale et point pour les milliers [3], mais le champ vaut 2 par défaut [4]. Or le total de chaque commande est enregistré arrondi à ce nombre de décimales [5] : un prix TTC calculé à 27,966 DT devient 27,97 DT avec deux décimales, 28 DT avec zéro. C’est ce total que l’extension transmet en général à la passerelle.
| Nombre de décimales | Ce que voit le client | À retenir |
|---|---|---|
| 3 | 399,000 DT | Aucun arrondi caché : le montant payé est celui que la TVA et la livraison ont produit |
| 2 | 399,00 DT | Les millimes sont arrondis au centime, sans que personne ne le décide |
| 0 | 399 DT | Lisible, mais seulement si tous vos prix, taxes et frais tombent juste au dinar |
Le symbole par défaut est en écriture arabe, « د.ت » [6] ; si vous préférez « DT », un filtre de code ou une extension le remplace, à vérifier ensuite sur les e-mails de commande.
TVA et droit de timbre
Une fois les taxes activées dans l’onglet Général, l’onglet Taxe apparaît [7]. Trois décisions :
- Prix saisis TTC ou HT. Si vos fiches portent le prix payé par le client, déclarez des prix taxes comprises ; le suffixe d’affichage peut ajouter « TTC » [7].
- Base du calcul : adresse de livraison, de facturation ou de la boutique [7]. Pour des ventes en Tunisie seulement, le taux est le même ; hors du pays, demandez à votre comptable.
- Taux. Dans « Taux standard », une ligne : code pays TN, taux 19 [7]. Le taux normal est de 19 %, des taux de 13 et 7 % visant des opérations désignées [8] : une classe de taxe pour les produits concernés. La case Livraison dit si le port est taxé.
L’arrondi « au niveau du sous-total » déplace quelques millimes selon les paniers ; WooCommerce conseille de faire valider la méthode [7], avant la première vente.
Une commande n’est pas une facture. Le droit de timbre sur les factures, un dinar par facture en règle générale [8], n’a pas de champ dans WooCommerce : il se porte sur la facture émise par votre logiciel, et ne s’ajoute pas au total des commandes sans l’avis de votre comptable. Voir aussi la facture électronique en Tunisie.
Livraison : des zones par codes postaux
WooCommerce connaît les régions de nombreux pays, pas celles de la Tunisie : aucun gouvernorat ne figure dans sa liste [9]. Une zone tunisienne se dessine donc par le pays, puis s’affine par codes postaux : codes exacts, plages numériques ou motifs avec astérisque, un par ligne [10] (une plage s’écrit par exemple 1000...1099).
Chaque adresse ne tombe que dans une zone, la première qui lui correspond [10] : votre ville en tête, livrée par coursier, puis « Tunisie ». Une adresse sans zone tombe dans « Le reste du monde » ; sans méthode, le client y lit qu’aucune livraison n’est possible [10], ce qui convient si vous n’expédiez pas à l’étranger.
Trois méthodes sont fournies : forfait, livraison gratuite (au-delà d’un montant, par exemple) et retrait sur place [10]. Le tarif de votre transporteur se reporte à la main dans le forfait de chaque zone.
Le paiement à la livraison
Il se règle dans WooCommerce > Réglages > Paiements : on peut le limiter à certaines méthodes de livraison et l’accepter ou non pour les produits virtuels [11]. Ses commandes passent directement « En cours » et ne deviennent « Terminée » qu’une fois l’argent remis par le livreur [11]. Comment l’associer à la carte est discuté dans l’article sur le paiement en ligne.
Comptes clients et données personnelles
L’onglet Comptes et confidentialité règle trois choses [12] :
- la commande sans compte, qui évite d’imposer une inscription à un acheteur pressé ;
- la création des identifiants : identifiant généré et lien pour choisir son mot de passe, sans mot de passe envoyé par e-mail ;
- la conservation des comptes inactifs et des commandes selon leur état, à aligner sur votre politique de confidentialité et sur ce que votre comptabilité doit garder.
Installer la passerelle de carte
Avant de déposer la demande auprès de la passerelle, publiez vos conditions de vente, vos mentions légales et vos pages de livraison et de retour : un site inachevé retarde sa validation.
Choisir l’extension avant de l’installer
Prenez celle que distribue ou recommande la passerelle. Relevez avant de l’activer sa dernière mise à jour, sa compatibilité avec votre version de WooCommerce, sa façon de confirmer le paiement (de serveur à serveur, pas par le simple retour du client) et sa prise en charge du bloc de commande.
Sur une copie, en mode test
Réglez d’abord une copie de la boutique : le pack e-commerce START compte deux bases de données, la seconde pour cet usage. La méthode est dans le guide pour sauvegarder, migrer et restaurer un site. Saisissez les identifiants de test, cochez le mode test et le journal de débogage.
Bloc de commande ou code court
Depuis WooCommerce 8.3 (novembre 2023), les boutiques neuves utilisent les blocs Panier et Commande. Une extension qui ne les prend pas en charge peut ne pas s’afficher ; si elle est seule, le client lit qu’aucun moyen de paiement n’est disponible [13]. Remède : une version compatible, ou le retour au code court — bloc sélectionné, « Transformer », « Classic Shortcode », sur le panier et la commande ensemble [13].
L’adresse de notification
En fin de transaction, la passerelle appelle une adresse de votre boutique, en général de la forme https://www.votreboutique.tn/?wc-api=nom_de_la_passerelle, où l’extension branche son traitement [14]. Recopiez exactement dans l’espace marchand celle qu’affiche l’extension, www et barre finale compris : une redirection peut faire perdre le message.
Paiement confirmé, l’extension doit appeler payment_complete(), qui baisse le stock et donne l’état « En cours » ou « Terminée » ; un paiement à vérifier à la main laisse la commande « En attente » [14]. C’est ce que vos tests doivent constater.
Les tests, et ce que chaque commande doit devenir
Une commande par scénario, avec un produit à prix rond sans frais de port pour comparer le montant affiché par la passerelle. Les états sont ceux de WooCommerce [15] ; votre extension peut les enchaîner autrement, et c’est ce qu’il faut savoir avant d’ouvrir.
| Scénario | État attendu | Vérification |
|---|---|---|
| Paiement accepté | En cours : payé, stock baissé | Le journal d’accès montre l’appel de la passerelle à l’heure du test ; l’e-mail de confirmation part |
| Carte refusée | Échouée | Le stock éventuellement retenu revient [15] |
| Client qui ferme la page de paiement | Attente paiement, puis Annulée | Annulée au-delà du délai « Maintenir le stock », si la gestion du stock et ce délai sont activés [15] [16] |
| Paiement à vérifier à la main (selon l’extension) | En attente | Stock baissé, paiement à confirmer dans l’espace marchand [15] |
| Remboursement depuis WooCommerce (ou l’espace marchand, si l’extension le répercute) | Remboursée | Le montant rendu, au millime près |
« Maintenir le stock » ne vise que les commandes en attente de paiement [16]. Gardez ce délai plus long que la validité de la page de paiement de votre passerelle, sinon une commande payée à la dernière minute peut être annulée avant la confirmation.
Pour ouvrir : identifiants de production, mode test et journal de débogage coupés, mode « Bientôt disponible » levé, puis un petit achat réel, remboursé ensuite.
Les commandes à surveiller chaque jour
Filtrez chaque jour la liste sur « Attente paiement » et « En attente ». Une commande « En attente » se confirme dans l’espace marchand, à son numéro de transaction, avant toute expédition : ni la page de retour vue par le client ni sa capture d’écran ne prouvent un paiement.
Plusieurs commandes payées restées « Attente paiement » le même jour signalent une notification qui n’arrive plus ; notre guide des incidents d’une boutique en service explique comment suspendre l’annulation automatique le temps de réparer.
Sécuriser le parcours de paiement
- HTTPS partout : dans Réglages > Général de WordPress, les deux adresses commencent par
https://[17]. Un cadenas barré vient presque toujours d’une ressource appelée enhttp://; voir le guide pour activer HTTPS et corriger un certificat. - Aucun cache sur le panier, la commande et le compte : pages et cookies à exclure sont dans notre guide pour accélérer une boutique sans perdre de commandes.
- Un compte par personne. Le rôle « Gestionnaire de boutique » gère produits, commandes, remboursements et réglages de WooCommerce sans les pleins pouvoirs d’un administrateur [18] ; les administrateurs passent par une authentification en deux étapes [19].
- Pas d’éditeur de code dans l’administration :
DISALLOW_FILE_EDITdanswp-config.php[19]. - Mises à jour sur la copie d’abord, l’extension de paiement plus que toute autre, puis un paiement rejoué ; voir mettre à jour WordPress, les thèmes et les extensions.
- Journal de débogage fermé hors enquête : les journaux de WooCommerce sont par défaut des fichiers gardés pendant la durée réglée [20], et celui d’une passerelle peut contenir des données de transaction.
Ce que fait l’hébergement, et ce qui reste à vous
Sur nos packs e-commerce, la page de l’offre engage : certificat Let’s Encrypt gratuit renouvelé automatiquement, pages de paiement comprises ; adresse de retour des prestataires joignable de l’extérieur ; Imunify360 avec pare-feu applicatif ; WooCommerce installé en un clic depuis Plesk, par nous si vous le demandez ; migration gratuite d’une boutique existante, telle quelle.
Les sauvegardes se font et se restaurent par vous depuis Plesk, au moins avant chaque mise à jour ; en option, une copie quotidienne gardée 30 jours hors du serveur, dès 90 DT par an selon la capacité.
Hors hébergement : le réglage de l’extension de paiement, le contrat avec la passerelle, les réglages commerciaux. Quand un paiement ne remonte pas, nous lisons en revanche ce que le serveur a reçu et vous transmettons les lignes de journal qui le montrent.
Le tunnel de commande en panne : symptôme, cause, geste
| Ce que vous voyez | Cause la plus probable | Premier geste |
|---|---|---|
| « Aucun moyen de paiement disponible » | Extension incompatible avec le bloc Commande, ou paiement à la livraison limité à une méthode que le client n’a pas choisie | Repasser la commande en code court, ou relire les options du moyen de paiement |
| Montant mille fois trop grand ou trop petit sur la page de paiement | Conversion en millimes mal faite par l’extension, ou décimales changées après coup | Comparer avec un produit à 1,000 DT, sur la copie |
| Client débité, commande « Attente paiement » | Notification bloquée, redirigée ou envoyée à une ancienne adresse | Chercher l’appel de la passerelle dans le journal d’accès, à l’heure du paiement |
| Panier qui se vide, ou compte qui ramène à la connexion | Page personnelle servie par un cache | Exclure panier, commande et compte du cache |
| Pas d’e-mail de confirmation | Commande restée dans un état qui n’en déclenche pas, ou e-mails refusés par la messagerie du client | Vérifier l’état, puis l’authentification SPF, DKIM et DMARC du domaine |
Pour retrouver une requête de la passerelle et le code que le serveur lui a renvoyé, le guide pour lire les journaux d’un site en production montre où regarder dans Plesk.
Questions fréquentes
Faut-il vraiment afficher trois décimales ?
Puis-je proposer la carte et le paiement à la livraison ensemble ?
Un client affirme avoir payé, la commande n’est pas payée : que faire ?
Les numéros de carte passent-ils par notre serveur ?
Nous écrire : ce qui fait gagner du temps
Depuis l’espace client, indiquez l’adresse de la boutique, le numéro de commande, l’heure du paiement à Tunis, la référence de transaction donnée par la passerelle et l’adresse de notification réglée chez elle. Avec ces cinq éléments, nous retrouvons l’appel dans les journaux ou nous établissons qu’il n’est jamais arrivé. Aucun mot de passe ni aucune clé n’est utile.
Guides liés
Sources techniques
- WooCommerce — le mode « Bientôt disponible » et la visibilité du site
- WooCommerce — devise de la boutique : une devise de base, symbole, séparateurs, décimales
- Code de WooCommerce 11.2.1 — locale-info.php : la Tunisie, TND, trois décimales
- Code de WooCommerce 11.2.1 — réglages Général : « Nombre de décimales », 2 par défaut
- Code de WooCommerce 11.2.1 — abstract-wc-order.php : set_total() arrondit au nombre de décimales
- Code de WooCommerce 11.2.1 — wc-core-functions.php : symbole du dinar tunisien
- WooCommerce — configurer les taxes : prix saisis, base de calcul, arrondi, taux standard, suffixe
- PwC Worldwide Tax Summaries — Tunisie, autres impôts : TVA (19, 13 et 7 %) et droit de timbre sur les factures
- Code de WooCommerce 11.2.1 — states.php : les régions connues par pays (aucune pour la Tunisie)
- WooCommerce — zones de livraison : codes postaux, ordre des zones, méthodes
- WooCommerce — paiement à la livraison : options et état des commandes
- WooCommerce — réglages Comptes et confidentialité
- WooCommerce — blocs Panier et Commande : extensions incompatibles, retour au code court
- WooCommerce Developer — Payment Gateway API : rappels WC-API, payment_complete(), état « En attente »
- WooCommerce — les états d’une commande
- WooCommerce — réglages Produits, Inventaire : « Maintenir le stock (minutes) »
- WordPress — l’écran Réglages généraux
- WooCommerce — rôles et capacités : Gestionnaire de boutique, Client
- WordPress — durcir WordPress : authentification en deux étapes, DISALLOW_FILE_EDIT
- WooCommerce Developer — les journaux : emplacement, période de conservation
Les permissions et options visibles peuvent dépendre de votre formule ou de vos droits. Faites vérifier le contexte depuis l’Espace client.
Demander une vérification