Ajouter votre premier portefeuille pour accepter des paiements

Cet article fait suite à QryptoPay. Démarrage rapide. Le module est installé et le marchand créé : voyons maintenant comment définir où arrivera l’argent de vos clients.

QryptoPay génère à partir de votre portefeuille les adresses sur lesquelles vos clients paient : sans portefeuille, le module ne peut pas fournir d’adresse de paiement à un client.

Pourquoi commencer par Ethereum

La licence gratuite de QryptoPay inclut une limite de paiements et la réception sur le réseau Ethereum. Il est donc logique de créer votre premier portefeuille pour cette cryptomonnaie : la réception fonctionnera sans achat de licence.

ℹ️ Ce qui est réellement gratuit

L’ETH natif est accepté gratuitement. Les stablecoins USDT et USDC sur Ethereum, ainsi que Tron, Bitcoin, Litecoin et Monero, sont des options de licence distinctes : l’ajout d’un portefeuille Ethereum n’active pas à lui seul la réception d’USDT.

Pour le réseau Ethereum, QryptoPay utilise la clé privée du portefeuille, et une clé privée donne un accès total aux fonds. C’est pourquoi le portefeuille de réception doit être nouveau, créé de zéro : ni celui qui contient votre argent, ni un portefeuille dont vous avez déjà communiqué la clé à quelqu’un.

L’argent n’y reste pas : QryptoPay transfère automatiquement les fonds collectés auprès des clients vers votre portefeuille principal, que vous indiquerez dans le champ « Portefeuille de retrait ».

⚠️ Important

Le portefeuille de réception conserve une petite réserve pour les frais de réseau, qui sert à payer les transferts vers le portefeuille de retrait. Si cette réserve est épuisée, l’argent des clients n’arrive plus à votre portefeuille principal tant que vous ne l’avez pas réapprovisionnée.

Créer un portefeuille dans TrustWallet

Vous pouvez créer un portefeuille dans n’importe quelle application ou n’importe quel service de confiance ; voici un exemple avec TrustWallet :

1. Installez l’application depuis la boutique d’applications officielle.
2. Créez un nouveau portefeuille : n’en importez pas un existant.
3. Notez la phrase secrète (12 mots) et conservez-la hors ligne, sur papier ou dans un gestionnaire de mots de passe. C’est le seul moyen de retrouver l’accès au portefeuille.
4. Ne transférez pas vos propres fonds sur ce portefeuille : il ne sert que d’intermédiaire pour recevoir les paiements.

💡 Astuce

Les intitulés des menus des applications mobiles changent d’une version à l’autre. Si les libellés de votre version diffèrent, fiez-vous au sens de l’étape : « créer un nouveau portefeuille » et « enregistrer la phrase secrète ».

Profitez-en pour préparer un second portefeuille, celui des retraits : c’est vers lui que QryptoPay transférera l’argent collecté auprès des clients, et c’est lui qui doit être fiable. Votre portefeuille existant convient, par exemple un portefeuille matériel Ledger ou tout autre que vous utilisez déjà. Si vous n’en avez pas, créez un second portefeuille dans TrustWallet et gardez-le séparé de celui dont vous remettez la clé au panneau. Seule son adresse sera nécessaire : le panneau n’a pas besoin de la clé privée du portefeuille de retrait.

La clé privée pour le panneau

Le panneau n’a pas besoin de la clé d’une adresse isolée, mais de l’Account Extended Private Key : une clé au niveau du compte, à partir de laquelle sont générées les adresses de vos clients. TrustWallet ne l’affiche pas, on l’obtient donc à partir de la phrase secrète :

• ouvrez https://iancoleman.io/bip39/ ;
• (fortement recommandé) déconnectez complètement l’ordinateur du réseau ;
• saisissez la phrase secrète dans le champ BIP39 Mnemonic ;
• dans la liste Coin, choisissez ETH ;
• dans la section Derivation Path, passez à l’onglet BIP44 ;
• copiez l’Account Extended Private Key et enregistrez-la localement ;
• fermez l’onglet et rétablissez la connexion à Internet.

⚠️ Important

Il faut précisément la longue valeur Account Extended Private Key du bloc BIP44, et non la courte Private Key du tableau des adresses dérivées en bas de la page.

Copiez-y aussi la première adresse (index 0) du tableau des adresses dérivées : elle servira à vérifier la clé lors de l’enregistrement.

Le détail de cette étape et les clés pour les autres réseaux sont décrits dans l’article Ajouter un portefeuille dans QryptoPay.

Ajouter le portefeuille 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 — ETH ;
• Clé privée — l’Account Extended Private Key que vous avez copiée ;
• Portefeuille de retrait — l’adresse du portefeuille fiable que vous avez préparé plus haut ; il doit se trouver sur la même blockchain ;
• Seuil de retrait — montant en USD à partir duquel les fonds collectés sont envoyés vers le portefeuille de retrait. La valeur 0.00 signifie que l’argent est envoyé immédiatement, sans attendre d’accumulation ;
• Seuil de la réserve de frais — montant en USD à laisser sur le portefeuille pour payer les frais de réseau lors des retraits. Pour Ethereum, le panneau suggère 25, ce qui suffit au début ;
• E-mail de notification — adresse e-mail pour les messages sur l’état du portefeuille.

Dans le bloc « Notifications par e-mail », il est préférable de tout activer : « Réserve de frais de réseau faible », « Réserve de frais de réseau épuisée », « Échec de l’activation d’une adresse » et « Fonds reçus non rattachés ». Vous serez ainsi informé d’un problème de réception avant que votre client ne vous le signale.

💡 Astuce

Avant d’enregistrer, cliquez sur « Vérifier la clé » et saisissez dans le champ « Adresse principale » la première adresse de votre portefeuille. La réponse « La clé correspond à cette adresse » confirme que la clé a été copiée correctement ; « Cette adresse nécessite une autre clé » signifie que vous avez pris la mauvaise valeur.

ℹ️ Remarque

Un portefeuille ne peut être ajouté que pour le terminal de production. Le terminal de test n’a pas besoin de portefeuilles : les paiements qui y transitent n’exigent aucun transfert réel de cryptomonnaie.

Une fois le portefeuille enregistré, le module est prêt à accepter des paiements sur le réseau choisi. Les soldes, la réserve pour les frais, la désactivation et la suppression d’un portefeuille sont décrits dans l’article Gérer les portefeuilles dans QryptoPay.

Étape suivante

QryptoPay sait désormais où envoyer les fonds de vos clients et peut fournir des adresses de paiement. Reste à configurer la page de paiement sur laquelle vos clients paieront :

• Configurer la page de paiement QryptoPay — domaine, SSL et logo sur la page de paiement.