Ajouter un portefeuille dans QryptoPay

Le portefeuille est un élément indispensable au bon fonctionnement du module QryptoPay : il sert à générer les adresses de paiement dérivées pour vos clients. Tant qu’aucun portefeuille n’est ajouté, le moyen de paiement correspondant n’est pas disponible sur la page de paiement.

Vous pouvez créer un portefeuille dans n’importe quelle application ou n’importe quel service crypto de confiance. Comme les blockchains utilisent des algorithmes de génération d’adresses différents, voici des exemples de configuration pour certaines des cryptomonnaies prises en charge.

⚠️ Important

Pour accepter des jetons (USDT, USDC), vous devez ajouter un portefeuille précisément sur le réseau où vous comptez recevoir les paiements. Par exemple, pour accepter de l’USDT TRC-20, il faut ajouter un portefeuille sur le réseau Tron (TRX).

Bitcoin, Litecoin et équivalents

Bitcoin et les blockchains dérivées utilisent une Extended public key pour générer des sous-portefeuilles dérivés. Cette approche permet de recevoir des fonds sans donner accès à leur gestion : vous pouvez donc recevoir les paiements en toute sécurité directement sur votre portefeuille principal.

Pour obtenir la clé publique étendue :

• rendez-vous sur https://iancoleman.io/bip39/ ;
• (fortement recommandé) déconnectez complètement l’ordinateur du réseau (Wi-Fi, LTE, etc.) ;
• saisissez votre phrase mnémonique ;
• choisissez BIP84, copiez l’Extended public key et enregistrez-la localement ;
• fermez l’onglet et rétablissez la connexion à Internet.

Ensuite, ouvrez QryptoPay → « Aperçu » → « Derniers portefeuilles » → « Ajouter un portefeuille » et renseignez les paramètres :

• Nom — le nom de votre choix (modifiable plus tard) ;
• Blockchain — BTC (ou LTC si vous ajoutez Litecoin) ;
• Format d’adresse — le type d’adresse de votre portefeuille (witness type) ;
• Clé publique — l’Extended public key générée ;
• E-mail de notification — votre adresse e-mail pour recevoir les notifications sur l’état du portefeuille.

Une fois le portefeuille créé, vous pourrez accepter des paiements dans la cryptomonnaie de la blockchain choisie.

💡 Astuce

Avant d’enregistrer, cliquez sur Vérifier la clé et saisissez l’adresse principale de votre portefeuille : la première adresse (index 0) du tableau des adresses dérivées, sous l’onglet BIP84. Si elle correspond, la clé est correcte.

Ethereum, Tron et équivalents

Ethereum et les blockchains similaires utilisent une private key pour générer des sous-portefeuilles dérivés, ce qui donne un accès total à la gestion des fonds. Il est donc vivement recommandé de créer, dans un service externe, un portefeuille « vide » distinct, utilisé uniquement comme intermédiaire pour recevoir les paiements des clients.

Lors de l’ajout du portefeuille dans QryptoPay, vous pouvez indiquer un portefeuille de retrait : ce sera votre portefeuille principal, vers lequel les fonds reçus seront transférés automatiquement.

⚠️ Important

Le portefeuille doit contenir un solde minimal pour payer les frais de réseau des transactions : définissez-le dans le champ « Seuil de la réserve de frais » ci-dessous.

⚠️ Important

Les micropaiements sur le réseau Tron (moins de 0,5 TRX, soit 500 000 SUN) ne sont pas traités, en raison du spam qui touche périodiquement la blockchain.

Pour obtenir la clé privée :

• rendez-vous sur https://iancoleman.io/bip39/ ;
• (fortement recommandé) déconnectez complètement l’ordinateur du réseau ;
• saisissez votre phrase mnémonique dans le champ BIP39 Mnemonic ;
• dans la liste déroulante Coin, choisissez ETH (ou TRX pour Tron) ;
• dans la section Derivation Path, passez à l’onglet BIP44 ;
• copiez l’Account Extended Private Key — la longue valeur du bloc BIP44, et non la courte Private Key du tableau des adresses dérivées en bas de la page — et enregistrez-la localement ;
• fermez l’onglet et rétablissez la connexion à Internet.

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

• Nom — le nom de votre choix ;
• Blockchain — ETH (ou TRX pour Tron) ;
• Clé privée — l’Account Extended Private Key que vous avez copiée ;
• Portefeuille de retrait — votre portefeuille personnel, où seront transférés les fonds des clients ;
• Seuil de retrait — montant à partir duquel les fonds sont retirés automatiquement (pertinent pour Tron, où les transactions sont payantes) ;
• Seuil de la réserve de frais — montant en USD à laisser sur le portefeuille pour payer les frais de réseau lors du retrait des jetons ;
• E-mail de notification — adresse e-mail pour les notifications sur l’état du portefeuille.

Une fois le portefeuille créé, vous pourrez accepter des paiements dans la cryptomonnaie de la blockchain correspondante. Pour en savoir plus sur le solde du portefeuille, le seuil de la réserve et les autres opérations possibles après la création, consultez l’article Gérer les portefeuilles dans QryptoPay.

💡 Astuce

Avant d’enregistrer, cliquez sur Vérifier la clé et saisissez l’adresse principale de votre portefeuille : la première adresse (index 0) du tableau des adresses dérivées, sous l’onglet BIP44. Si elle correspond, la clé est correcte.

Monero

Monero n’utilise ni clé publique étendue ni clé privée : vous fournissez au panneau l’adresse principale du portefeuille et sa clé de visualisation privée, une clé avec laquelle le panneau voit les entrées de fonds sans pouvoir en disposer. Ces valeurs proviennent de votre application Monero ; il n’y a rien à générer ailleurs.

Le formulaire de création est plus court que les autres : nom, blockchain, ces champs et l’e-mail de notification. Monero n’a ni portefeuille de retrait, ni seuil de retrait, ni réserve pour les frais de réseau : l’argent des clients arrive tout de suite sur votre portefeuille.

⚠️ La comptabilisation commence à la connexion

Le portefeuille Monero ne voit que les paiements reçus après sa connexion. Les entrées antérieures n’apparaîtront pas dans le panneau, et rien ne permet de les recalculer.

Le détail — où trouver ces valeurs, pourquoi un seul portefeuille Monero fonctionne par serveur et comment choisir un nœud — se trouve dans l’article Accepter Monero (XMR).

Étapes suivantes

• Ajouter votre premier portefeuille pour accepter des paiements — le chemin court : un portefeuille sur le réseau Ethereum, avec un exemple prêt à l’emploi.
• Accepter Monero (XMR) — le parcours complet : prérequis, portefeuille, nœud, paiement d’essai.
• Gérer les portefeuilles dans QryptoPay — soldes, réserve pour les frais de réseau, désactivation et suppression d’un portefeuille.