Accepter Monero (XMR)

Monero se connecte à QryptoPay autrement que les autres réseaux ; nous avons donc rassemblé tout le parcours dans un seul article : ce qui doit être prêt au préalable, en quoi la réception de XMR diffère de celle des autres cryptomonnaies, comment connecter le portefeuille et le nœud, et comment s’assurer que l’argent arrive.

Ce qu’il faut avant de commencer

L’acceptation de Monero est la dernière étape, pas la première : elle se configure sur un module déjà opérationnel. À ce stade, vous devez avoir :

1. Le module QryptoPay installé et un marchand créé — voir QryptoPay. Démarrage rapide.
2. Une page de paiement créée et accessible sur votre domaine — voir Configurer la page de paiement QryptoPay.
3. Une intégration de la boutique configurée et menée jusqu’à un paiement d’essai — jetons du terminal, liens de paiement et webhook ; voir Intégrer la boutique à QryptoPay.
4. L’option Monero souscrite dans votre licence — voir Obtenir une licence.

⚠️ Sans l’option de licence, Monero n’apparaît pas dans la liste des cryptomonnaies

Vous pouvez tout de même créer le portefeuille, et il fonctionnera, mais Monero ne sera pas proposé à l’acheteur sur la page de paiement. Si XMR n’apparaît pas dans la liste des cryptomonnaies du marchand, commencez par vérifier la licence.

Si l’un des trois premiers points n’est pas encore fait, reprenez l’article correspondant : sans page de paiement ni webhook, la réception ne fonctionne dans aucune cryptomonnaie, et Monero ne fait pas exception.

En quoi accepter Monero diffère des autres cryptomonnaies

Réseau	Ce que vous saisissez dans le panneau	Qui peut dépenser	Retraits et regroupement des fonds
Bitcoin, Litecoin	clé publique étendue	vous seul, dans votre application	inutiles : l’argent est directement chez vous
Ethereum, Tron	clé privée	le panneau, selon votre seuil de retrait	oui
Monero	adresse principale et clé de visualisation privée	vous seul, dans votre application	inutiles : l’argent est directement chez vous

Ce que le panneau reçoit de vous n’est pas une clé qui permet de dépenser, mais une clé qui permet seulement de regarder : il voit les entrées de fonds, en calcule le solde et clôture les factures, mais ne peut pas disposer de l’argent. L’argent des clients arrive directement sur votre portefeuille : il n’y a rien à rassembler depuis des adresses intermédiaires.

C’est pourquoi, pour Monero, le panneau n’a ni portefeuille de retrait, ni seuil de retrait, ni réserve pour les frais de réseau : il n’a aucun moyen de dépenser l’argent.

Étape 1. Connecter le portefeuille

Ce qu’il faut récupérer dans votre portefeuille

Créez un portefeuille Monero dans n’importe quelle application de confiance, par exemple le Monero GUI Wallet officiel ou l’application mobile Cake Wallet. Le panneau a besoin des valeurs suivantes :

• l’adresse principale — l’adresse publique du portefeuille, 95 caractères, qui commence par 4 ;
• la clé de visualisation privée (private view key) — 64 caractères au format hexadécimal.

Dans la plupart des applications, les valeurs se trouvent côte à côte, dans la section des clés du portefeuille : l’adresse sur l’écran principal ou dans l’onglet de réception, la clé de visualisation là où l’application affiche la phrase secrète.

⚠️ Ne confondez pas les clés

Le panneau a besoin de la clé de visualisation, et non de la clé privée de dépense (private spend key) ni de la phrase secrète. La clé de visualisation permet de voir les transferts entrants et rien d’autre : la remettre au panneau est sans danger. La clé de dépense et la phrase secrète donnent un accès total à l’argent, ne les communiquez à personne.

Ce qu’il faut renseigner dans le panneau

Ouvrez QryptoPay → Aperçu → Derniers portefeuilles → « Ajouter un portefeuille » et remplissez les champs :

• Nom — le nom de votre choix, de 2 à 64 caractères ;
• Blockchain — Monero ;
• Adresse principale — l’adresse publique de votre portefeuille ;
• Clé de visualisation privée — la clé avec laquelle le panneau voit les entrées de fonds ;
• E-mail de notification — adresse e-mail pour les messages sur l’état du portefeuille.

Rien d’autre à saisir : ni format d’adresse, ni portefeuille de retrait, ni date de départ. Le moment à partir duquel le panneau commence à suivre le portefeuille est déterminé automatiquement.

ℹ️ Une adresse intégrée ne convient pas

Le panneau n’accepte que l’adresse principale du portefeuille. Une adresse intégrée (plus longue, 106 caractères) est refusée à l’enregistrement.

⚠️ La comptabilisation commence à la connexion

Le portefeuille ne voit que les paiements reçus après sa connexion. Tout ce qui est arrivé sur ce portefeuille plus tôt, le panneau ne le verra jamais : il n’existe aucun moyen de recalculer l’historique pour Monero. Si vous comptez accepter les paiements sur un portefeuille déjà utilisé, l’argent qui s’y trouve reste à vous, le panneau ne l’affichera simplement pas.

Une fois le portefeuille enregistré, le panneau commence à attribuer aux clients des adresses de paiement issues de ce portefeuille ; il n’y a rien d’autre à configurer.

Un seul portefeuille Monero par serveur

Monero est reçu sur un seul portefeuille : le panneau en tire lui-même les adresses attribuées aux clients, un second est donc inutile. Cela vaut pour tout le serveur, et non pour un marchand en particulier : tant qu’un portefeuille Monero activé existe sur le serveur, il est impossible d’en ajouter un autre. Dans la boîte de dialogue de création, l’option Monero est indisponible, et le commutateur de la fiche d’un portefeuille désactivé est verrouillé ; dans les deux cas, le panneau en indique la raison.

Concrètement :

• Pour changer de portefeuille, il faut passer par la désactivation : coupez le commutateur de la fiche du portefeuille actuel, après quoi la création d’un nouveau devient possible.
• Un second marchand sur le même serveur ne pourra pas créer son propre portefeuille Monero : Monero n’apparaîtra pas dans sa liste de cryptomonnaies. Si plusieurs marchands ont besoin de Monero avec une comptabilité séparée, il faut un serveur distinct.

Étape 2. Choisir un nœud

Le panneau obtient les blocs du réseau via un nœud Monero. Par défaut, un nœud public est utilisé : rien à configurer, la réception fonctionne dès l’ajout du portefeuille. C’est le mode normal, et non une solution provisoire : vous pouvez rester sur un nœud public aussi longtemps que vous le souhaitez.

Si vous exploitez votre propre nœud Monero, connectez-le : QryptoPay → « Paramètres » → « Nœuds » → ligne Monero → « Connecter votre nœud ». L’adresse de votre nœud se saisit dans le champ « Adresse ». Les champs « Identifiant » et « Mot de passe » ne sont nécessaires que si le nœud est protégé par un identifiant (monerod --rpc-login) ; en général, le nœud se trouve sur un réseau fermé et ces champs restent vides. Vous pouvez revenir au nœud public au même endroit avec « Déconnecter votre nœud » : la réception des paiements ne s’interrompt pas.

Sur cette même page, sous chaque réseau, vous voyez si le panneau suit le réseau. Si un avertissement apparaît pour Monero, commencez par changer de nœud ; et si même le nœud public n’y change rien, voir Supervision de l’état de QryptoPay.

Étape 3. Vérifier la réception avec un paiement d’essai

Le terminal de test ne convient pas ici : il ne fonctionne pas avec les vrais réseaux et n’a pas besoin de portefeuilles. La vérification se fait sur le terminal de production et nécessite un vrai transfert : prenez le montant minimal.

1. Générez un lien de paiement depuis votre boutique et ouvrez-le.
2. Choisissez Monero parmi les moyens de paiement. S’il n’est pas dans la liste, vérifiez l’option de licence et que le portefeuille est activé.
3. Envoyez le montant indiqué à l’adresse de la page de paiement, depuis votre application Monero.
4. Attendez les confirmations : un paiement est comptabilisé après 10 confirmations du réseau, soit environ 20 minutes. Le compteur est visible par le client directement sur la page de paiement.
5. Vérifiez que la boutique a reçu la notification du webhook et que le paiement apparaît chez le marchand, dans l’onglet « Paiements ».

L’argent et la notification sont arrivés : la réception de Monero est configurée.

Ce que le panneau n’affiche pas pour Monero

• L’expéditeur du paiement. Le réseau Monero ne révèle pas de quelle adresse provient l’argent, ni au panneau, ni à un explorateur de blocs. On ne peut donc relier une entrée de fonds à un client que par les données que votre boutique a transmises à la création du paiement : pour un paiement arrivé sans facture, le client reste inconnu.
• Le bouton « Actualiser les soldes ». Il n’existe pas pour Monero : il n’y a rien à recalculer, le panneau lit déjà le solde sur le réseau.
• Le solde d’un portefeuille désactivé. La fiche reste vide jusqu’à ce que vous réactiviez le portefeuille ; l’argent, lui, ne va nulle part.
• Les opérations du portefeuille. Monero n’apparaît pas dans le journal des opérations : il n’y a ni retraits, ni regroupements de fonds, ni transferts de frais.
• Les entrées antérieures à la connexion du portefeuille — voir l’avertissement plus haut.

Étapes suivantes

• Gérer les portefeuilles dans QryptoPay — solde, activation, désactivation et suppression d’un portefeuille.
• Ajouter un portefeuille dans QryptoPay — clés pour les autres réseaux.
• Configurer les frais par devise dans QryptoPay — frais de paiement, Monero compris.
• Supervision de l’état de QryptoPay — soyez informé d’une panne avant vos clients.