Gérer les portefeuilles dans QryptoPay
Lors de la configuration initiale du module QryptoPay, puis au fil de son utilisation, vous devrez créer et modifier les portefeuilles qui reçoivent les paiements de vos clients. L’ajout d’un portefeuille est décrit dans l’article Ajouter un portefeuille dans QryptoPay ; nous détaillons ici les actions possibles sur un portefeuille : le modifier, l’activer, le désactiver et le supprimer.
Liste des portefeuilles
La section des portefeuilles affiche tous les portefeuilles que vous avez ajoutés, actifs et désactivés, regroupés par réseau : Bitcoin, Litecoin, Ethereum, Tron et Monero ont chacun leur onglet. Passez d’un onglet à l’autre si vous acceptez plusieurs cryptomonnaies.
La fiche de chaque portefeuille indique d’emblée combien d’argent il contient, sur quelle adresse arrivent les paiements et, pour Ethereum et Tron, où partent les fonds collectés : inutile d’ouvrir la modification simplement pour vérifier quelque chose. S’il n’y a pas encore de portefeuille sur ce réseau, ou si vous en voulez un autre, le bouton « Ajouter un portefeuille » ouvre la boîte de dialogue de création.
Solde du portefeuille
La fiche affiche des valeurs qui indiquent combien d’argent est passé par le portefeuille et combien est déjà disponible. Solde de l’adresse principale — l’argent qui se trouve directement sur cette adresse. Solde de toutes les adresses — le total du portefeuille, y compris l’argent présent sur les adresses que le panneau attribue à vos clients pour le paiement ; il est supérieur ou égal au premier. Pour Ethereum et Tron, une valeur supplémentaire s’ajoute : les Jetons, détaillés pour chaque jeton pris en charge, même si son solde est encore nul.
Si vous avez un doute sur la fraîcheur des chiffres, survolez l’icône d’horloge à côté du nombre : le panneau affiche la date à laquelle ils sont à jour.
Bitcoin et Litecoin
Pour Bitcoin et Litecoin, le panneau calcule lui-même le solde, mais seulement à partir du moment où cette fonctionnalité est apparue dans QryptoPay, et non à partir de l’ajout du portefeuille. Un portefeuille ajouté plus tôt peut donc contenir de l’argent que le panneau ne connaît pas encore. Pour le prendre en compte, survolez la fiche du portefeuille avec le curseur et cliquez sur « Actualiser les soldes », puis confirmez l’action dans la boîte de dialogue qui s’ouvre.
⚠️ Le recalcul alourdit le traitement des paiements
Ne le lancez pas sans nécessité : en une seule passe, le panneau recalcule tout l’historique des paiements du portefeuille.
Même après le recalcul, le solde peut être inférieur au solde réel, mais jamais supérieur : l’argent arrivé sans facture dans QryptoPay, ou avant l’apparition de cette fonctionnalité, ne sera pas retrouvé par le recalcul. Pour connaître le montant exact, consultez votre application de portefeuille crypto.
Tant que le recalcul n’a jamais été lancé pour un portefeuille, le solde est remplacé par l’indication « Pas encore calculé ».
Ethereum et Tron
Pour Ethereum et Tron, le solde de l’adresse principale est une réserve pour les frais de réseau, qui sert à payer les transferts des fonds collectés vers le portefeuille de retrait. Inutile de l’actualiser manuellement : le panneau lit le solde directement sur le réseau. Lorsque la réserve touche à sa fin, le panneau indique pour combien de retraits environ elle suffit encore ; si les fonds sont déjà insuffisants, il l’indique aussi, et l’argent des clients n’arrive plus au portefeuille de retrait tant que vous n’avez pas réapprovisionné la réserve. Le panneau peut aussi vous informer de l’état de la réserve par e-mail : activez pour cela les notifications (détails dans l’article Configurer les notifications e-mail de QryptoPay) et choisissez, lors de la modification du portefeuille, ce dont vous voulez être averti.
Vous décidez vous-même combien conserver pour les frais et à partir de quel montant transférer les fonds collectés vers le portefeuille de retrait, dans les champs « Seuil de la réserve de frais » et « Seuil de retrait » (à la création du portefeuille ou plus tard, lors de sa modification). Tant que le transfert n’a pas eu lieu, l’argent collecté auprès des clients apparaît dans le solde de toutes les adresses, mais pas dans celui de l’adresse principale : si ces nombres divergent nettement, la différence correspond à l’argent des clients qui n’a pas encore été envoyé en retrait.
Monero
Pour Monero, la fiche affiche le solde de l’adresse principale et le solde de toutes les adresses ; ce réseau n’a pas de jetons. Le panneau les lit sur le réseau, il n’y a donc pas besoin d’actualiser le solde manuellement : Monero n’a pas de bouton « Actualiser les soldes ».
Le solde d’un portefeuille Monero désactivé n’est pas affiché : la fiche reste vide jusqu’à ce que vous réactiviez le portefeuille. L’argent, lui, ne va nulle part.
Création d’un portefeuille
S’il n’y a pas encore de portefeuille sur le réseau voulu, ou si vous en voulez un autre, cliquez sur « Ajouter un portefeuille ». Le détail des champs à remplir pour chaque réseau — clé publique étendue pour Bitcoin et Litecoin, clé privée pour Ethereum et Tron, adresse principale et clé de visualisation pour Monero — est décrit dans l’article Ajouter un portefeuille dans QryptoPay.
ℹ️ Monero — un seul portefeuille par serveur
Un seul portefeuille de ce réseau fonctionne sur un serveur. Tant qu’un portefeuille Monero activé existe, l’option Monero est indisponible dans la boîte de dialogue de création — pour en savoir plus, consultez l’article Accepter Monero (XMR).
Modification d’un portefeuille
Ouvrez la boîte de dialogue « Modifier le portefeuille » pour changer le nom ou l’e-mail de notification. La blockchain ne peut pas être changée : un autre réseau nécessite un portefeuille distinct.
Pour Bitcoin et Litecoin, la clé publique et le format d’adresse indiqués à la création ne peuvent pas être modifiés : au lieu de modifier le portefeuille, vous pouvez supprimer l’actuel et en créer un nouveau. Il en va de même pour Monero : l’adresse principale et la clé de visualisation privée ne se définissent qu’une seule fois.
Pour Ethereum et Tron, davantage de champs sont modifiables. Le Portefeuille de retrait est l’adresse vers laquelle partent les fonds collectés ; il doit se trouver sur la même blockchain, et la nouvelle adresse s’applique à partir du prochain retrait. Le Seuil de retrait et le Seuil de la réserve de frais sont exprimés en dollars et non en cryptomonnaies : la conversion au cours du jour est faite par le panneau.
C’est aussi là que vous choisissez ce qui déclenche un avertissement par e-mail, et il vaut mieux tout activer : la réserve s’épuise, la réserve est épuisée et les retraits sont suspendus, et, pour Tron, l’impossibilité d’activer l’adresse d’un client, toujours à cause d’une réserve vide. Cette dernière option mérite particulièrement d’être activée : si la réserve Tron est épuisée, le panneau ne peut pas activer d’adresse pour le client, qui aura alors du mal à payer. Autrement dit, une réserve vide pénalise non seulement les retraits, mais aussi la réception des paiements.
Activation et désactivation d’un portefeuille
Pour désactiver un portefeuille, utilisez le commutateur de sa fiche. Un portefeuille désactivé ne participe plus à la réception des paiements : ses adresses ne sont plus attribuées aux nouveaux clients, mais tout ce que vous avez configuré et tout l’historique sont conservés. C’est pratique pour cesser temporairement d’accepter des paiements sur ce réseau, par exemple le temps de changer de portefeuille de retrait.
Pour Monero, ce commutateur détermine aussi quel portefeuille est en service : on ne peut pas en activer un second tant que le premier est actif, le panneau verrouille le commutateur et en indique la raison. Pour passer à un autre portefeuille Monero, désactivez d’abord l’actuel.
Suppression d’un portefeuille
Cliquez sur l’icône de suppression de la fiche : la boîte de dialogue « Confirmer la suppression du portefeuille » s’ouvre et vous avertit que la suppression peut perturber la réception des paiements de vos clients et le retrait des fonds déjà reçus. Pour confirmer, saisissez le nom du portefeuille dans le champ ci-dessous : le bouton « Supprimer » ne devient actif qu’en cas de correspondance exacte.
‼️ Un portefeuille supprimé ne peut pas être restauré
Un portefeuille avec ces clés et ces adresses ne peut pas être restauré, mais vous pouvez à tout moment en ajouter un nouveau pour le même réseau.
Étapes suivantes
- Ajouter votre premier portefeuille pour accepter des paiements — si vous n’avez pas encore de portefeuille : un exemple prêt à l’emploi pour le réseau Ethereum.
- Ajouter un portefeuille dans QryptoPay — clé publique étendue pour Bitcoin et Litecoin, clé privée pour Ethereum et Tron.
- Routage des paiements entre les portefeuilles dans QryptoPay — dirigez le flux de clients vers différents portefeuilles selon un paramètre de la boutique et le montant de la commande.
- Accepter Monero (XMR) — le parcours complet : prérequis, portefeuille, nœud, paiement d’essai.
- Journal des opérations dans QryptoPay — où consulter les retraits, les regroupements de fonds et les transferts de frais décrits plus haut.
- Configurer les notifications e-mail de QryptoPay — pour que les notifications sur la réserve et les retraits du portefeuille arrivent par e-mail.
- Intégrer la boutique à QryptoPay — menez votre boutique jusqu’à un paiement d’essai.