● articles / Marchand — POS

monerowp pour WooCommerce : installation pas à pas

· monerowp · WooCommerce · WordPress · marchand · view-only

Si ton site e-commerce tourne sous WordPress + WooCommerce, monerowp (github.com/monero-integrations/monerowp) est l’option Monero-native de référence. Plugin open-source, maintenu par Monero Integrations + SerHack, installation directe depuis l’admin WordPress. Voici le setup propre, avec wallet view-only et bonnes pratiques OPSEC marchand.

Ce que fait monerowp

Architecture recommandée

┌─────────────────┐         ┌──────────────────┐
│  Wallet froid   │  seed   │  Tu (ordinateur  │
│  (full)         │  ◄────  │  séparé)         │
│  spend + view   │         └──────────────────┘
└────────┬────────┘
         │ exporte view key + adresse
         │
         ▼
┌─────────────────────────────────────────────┐
│  Serveur WordPress (VPS, hébergeur)         │
│  ├─ monerowp plugin                         │
│  └─ monero-wallet-rpc (view-only)           │
└─────────────────────────────────────────────┘
         ▲
         │ paiements clients
         │
   blockchain Monero

Le serveur web ne contient que la view key. Si compromis, l’attaquant voit tes flux entrants mais ne peut rien dépenser. Les retraits se font depuis ton ordinateur séparé qui contient la full seed.

Pré-requis

Étape 1 : récupérer view key + adresse depuis ton wallet froid

Sur ton wallet froid (exemple Feather) :

Tu dois avoir 3 valeurs :

Voir article view-only encaisser pour le détail.

Étape 2 : installer monero-wallet-rpc en mode view-only sur le serveur

Sur ton VPS WordPress, en SSH :

# Télécharger le binaire Monero officiel (vérifier la signature PGP !)
wget https://downloads.getmonero.org/cli/linux64

# Vérifier la signature avec hashes.txt (cf. article signature PGP)
# ...

# Décompresser
tar -xjvf monero-linux-x64-v0.18.x.x.x.tar.bz2
cd monero-x86_64-linux-gnu-v0.18.x.x.x

# Créer le wallet view-only
./monero-wallet-cli \
  --generate-from-view-key /home/user/monerowp-wallet \
  --restore-height <RESTORE_HEIGHT> \
  --address <ADRESSE_PRINCIPALE> \
  --viewkey <PRIVATE_VIEW_KEY> \
  --daemon-host node.community.rino.io:18081 \
  --trusted-daemon

Définis un mot de passe pour le fichier wallet (différent de tout autre mot de passe).

Lance ensuite le RPC daemon :

./monero-wallet-rpc \
  --wallet-file /home/user/monerowp-wallet \
  --password '<password>' \
  --rpc-bind-port 18083 \
  --disable-rpc-login \
  --rpc-bind-ip 127.0.0.1 \
  --daemon-host node.community.rino.io:18081 \
  --trusted-daemon

Sécurité : --rpc-bind-ip 127.0.0.1 limite l’accès RPC au localhost. Ne l’expose jamais sur 0.0.0.0 sans authentification + pare-feu strict.

Lance ce processus en service systemd pour qu’il redémarre automatiquement (création d’un fichier /etc/systemd/system/monero-wallet-rpc.service).

Étape 3 : installer monerowp dans WordPress

Deux méthodes :

Méthode A — Plugin browser (auto-update activé) :

  1. Admin WordPress → Plugins → Add New.
  2. Chercher “monero”.
  3. Installer “Monero WooCommerce Extension” par mosu-forge, SerHack.
  4. Activer.

Méthode B — Manuelle (depuis git master ou release officielle) :

  1. Télécharge la dernière release depuis github.com/monero-integrations/monerowp/releases.
  2. Décompresse dans wp-content/plugins/monero-woocommerce-gateway/.
  3. Activer dans l’admin WordPress.

Étape 4 : configurer monerowp

WooCommerce → Settings → Payments → Monero Gateway → Manage.

Champs essentiels :

Sauvegarde.

Étape 5 : test du flow complet

  1. Crée un produit test à 1€ dans WooCommerce.
  2. Passe une commande en frontend, choisis Monero comme méthode de paiement.
  3. Tu vois la subaddress générée + le QR + le countdown.
  4. Depuis un autre wallet, envoie le montant XMR à cette subaddress.
  5. Attends les confirmations (10 confirmations ≈ 20 min).
  6. La commande passe automatiquement à Processing / Completed dans WooCommerce.

Si tout fonctionne : tu es prêt à accepter Monero en production.

OPSEC permanente

Limites à connaître

Alternatives si monerowp ne convient pas

En résumé

ÉtapeActionDurée
1Récupérer view key + adresse depuis wallet froid5 min
2Installer monero-wallet-rpc view-only sur serveur + systemd20 min
3Installer plugin monerowp dans WordPress5 min
4Configurer monerowp (RPC, view key, confirmations, etc.)10 min
5Test commande 1€ end-to-end30 min (incl. confirmations)
6Prod—

Une heure de setup pour des années de paiements XMR sur ton site, sans dépendance à un processeur tiers, sans KYC, sans risque de gel.

Sources : github.com/monero-integrations/monerowp, README + readme.txt officiels, documentation getmonero.org sur monero-wallet-rpc.

● profils liés

← Tous les articles ↻ Refaire le diagnostic