Exploiter un paiement en ETH : prix, gas et confirmations

Accepter des ETH ne consiste pas simplement à afficher une adresse Ethereum et à attendre des transferts. Un paiement commercial nécessite un prix, une demande de paiement précise, une règle d’expiration, la gestion des confirmations, une référence de commande et une action fiable après le paiement.

Yolfi propose des liens de paiement en cryptomonnaie, des abonnements, des événements de paiement, des webhooks et le versement direct dans un portefeuille selon un modèle sans garde, pour les combinaisons d’actif et de réseau prises en charge. ETH sur Ethereum ne doit être proposé que si cette combinaison précise apparaît dans la configuration active et authentifiée du marchand ; une page publique consacrée à un actif ou à un réseau ne prouve pas à elle seule que le versement est activé.

Ce guide présente les choix opérationnels liés à un parcours de paiement en ETH : quand fixer le prix en ETH, quand utiliser plutôt un stablecoin sur le réseau Ethereum, comment gérer les frais de gas et les variations de taux de change, et ce que votre application doit faire avant et après la confirmation.

Que signifie accepter les paiements Ethereum ?

Ethereum est un réseau blockchain. ETH est son actif natif : il sert à payer les frais de transaction et peut également être transféré comme moyen de paiement. Ethereum permet aussi de transférer des jetons, notamment des stablecoins comme USDC et USDT. Ethereum.org propose une présentation plus générale du réseau dans Qu’est-ce qu’Ethereum ?.

Pour le contexte Yolfi, consultez la présentation du réseau Ethereum et la page de l’actif ETH. Ces pages publiques décrivent le réseau et l’actif, mais ne confirment pas la disponibilité du versement pour un compte donné.

Le paiement d’un client en ETH suit généralement ce parcours :

1. Votre page de paiement crée une demande associée à une commande ou à un client.
2. La demande indique ETH, le réseau Ethereum, l’adresse de réception, le montant exact et, le cas échéant, une heure d’expiration.
3. Le client approuve la transaction dans un portefeuille compatible.
4. La transaction est soumise au réseau Ethereum et passe à l’état « en attente ».
5. Votre système de paiement détecte le transfert et attend l’état de confirmation requis.
6. Un événement de paiement vérifié indique à votre application de traiter la commande, de mettre à jour une facture ou de prolonger un accès.

Cette dernière étape est essentielle. Un identifiant de transaction sert à identifier une transaction, mais sa seule présence ne prouve pas qu’elle a été diffusée, confirmée ou associée à la bonne commande.

ETH ou un stablecoin sur Ethereum ?

ETH et les stablecoins peuvent utiliser le même réseau, mais ils répondent à des besoins de tarification différents.

Proposez ETH lorsque les clients en détiennent déjà ou lorsque le prix du produit est naturellement fixé en ETH. Si un produit a un prix fixe en dollars, un stablecoin sur le réseau Ethereum peut être plus simple pour le client et l’équipe financière, car le montant du jeton ne doit pas suivre le cours de l’ETH.

Ne présentez pas un paiement en stablecoin comme un paiement en ETH au seul motif qu’il passe par Ethereum. « Payer 0,02 ETH sur Ethereum » et « Payer 50 USDC sur Ethereum » sont deux modes de paiement différents. Le second utilise un contrat de jeton, et le client a tout de même besoin d’un peu d’ETH pour payer les frais de réseau.

Pour une configuration propre aux stablecoins, consultez les guides sur l’acceptation des paiements en USDC et l’acceptation des paiements en USDT.

Quand accepter l’ETH est pertinent

ETH peut constituer un moyen de paiement supplémentaire utile lorsque :

• les clients utilisent déjà des portefeuilles Ethereum ;
• un produit s’adresse aux développeurs, aux entreprises du secteur des cryptomonnaies, aux collectionneurs, aux négociants ou à d’autres acheteurs familiers d’Ethereum ;
• un client souhaite régler une facture depuis un solde en ETH ;
• une entreprise veut que les paiements soient versés directement dans le portefeuille qu’elle a configuré ;
• le prix du produit ou du service est volontairement fixé en ETH ;
• les paiements confirmés doivent déclencher la livraison ou l’accès à un compte.

Il s’agit d’un choix par défaut moins adapté à un petit achat libellé en monnaie fiduciaire lorsque l’acheteur ne possède pas encore d’ETH. Le client devrait alors acquérir des ETH, gérer un portefeuille et payer des frais de réseau. Conservez les options de paiement par carte ou virement bancaire lorsqu’elles correspondent mieux au public visé.

ETH peut également être proposé aux côtés de stablecoins. Laissez la demande des clients déterminer les moyens affichés, plutôt que de présenter par défaut tous les actifs possibles.

Choisir le modèle de tarification avant de créer le parcours de paiement

Une demande de paiement en ETH doit reposer sur une source de référence claire pour le prix.

Prix fixe en ETH

Un prix fixe en ETH convient lorsque le vendeur raisonne en ETH. Un produit peut coûter un montant défini en ETH, quelle que soit sa valeur en monnaie fiduciaire au moment du paiement.

Ce modèle est simple sur la page de paiement, mais l’entreprise assume le risque de marché. Le chiffre d’affaires mesuré en monnaie locale peut varier entre la fixation du prix, le paiement et une conversion ultérieure.

Prix en monnaie fiduciaire converti en ETH

Pour un produit libellé en monnaie fiduciaire, le montant requis en ETH peut être calculé au début du paiement. La demande doit alors indiquer :

• le prix de référence en monnaie fiduciaire ;
• le montant exact en ETH à envoyer ;
• le taux ou le cours utilisé, s’il est affiché sur la page de paiement ;
• l’heure d’expiration du cours proposé ;
• ce qui se passe si le paiement arrive en retard ou si son montant diffère.

Ne laissez pas indéfiniment ouvert un cours volatil. Un client qui paie un ancien montant en ETH après une variation du marché risque de payer moins ou plus que le prix actuel.

Prix en stablecoin sur Ethereum

Pour un produit déjà libellé en dollars, un stablecoin pris en charge sur Ethereum peut éliminer l’essentiel du problème de conversion en ETH. Il ne supprime toutefois ni les frais de réseau, ni la gestion des confirmations, ni la vérification du jeton. La demande de paiement doit toujours préciser l’actif exact, le contrat de jeton reconnu par le système de paiement, le réseau, le montant, l’adresse et l’état.

Tenir compte des frais de gas sur Ethereum

Le gas correspond aux frais payés pour le calcul et le traitement des transactions sur Ethereum. L’expéditeur les paie en ETH, et leur montant peut varier selon la demande sur le réseau. La documentation d’Ethereum sur le gas explique les limites de gas, les frais de base, les frais de priorité et pourquoi les frais définitifs indiqués par un portefeuille dépendent de la transaction et des conditions du moment.

Pour les marchands, quatre règles permettent d’éviter toute confusion :

1. Séparez le gas du montant de l’achat. Si la demande de paiement porte sur 0,05 ETH, le marchand doit recevoir 0,05 ETH ; le portefeuille doit disposer d’ETH supplémentaires pour payer le gas.
2. Ne promettez pas de frais de réseau fixes. Affichez l’estimation actuelle du portefeuille ou informez le client que des frais de réseau Ethereum s’appliquent.
3. Vérifiez la pertinence économique des petits montants. Un paiement peut être techniquement valide, mais peu intéressant si le gas représente une part importante de l’achat.
4. Ne déduisez pas le gas d’un remboursement sans règle publiée. Précisez si l’entreprise ou le client prend en charge les frais de la transaction de remboursement distincte.

Un transfert de jetons consomme généralement plus de gas qu’un simple transfert d’ETH, car il fait appel à un contrat de jeton. Évitez de publier une comparaison permanente des frais : leur montant réel dépend de la transaction et des conditions du réseau.

Réseau principal Ethereum et autres réseaux

« ETH » peut apparaître dans les portefeuilles sur le réseau principal Ethereum et sur d’autres réseaux. Des formats d’adresse similaires ne rendent pas ces réseaux interchangeables. Une transaction envoyée sur un autre réseau n’est pas un paiement sur le réseau principal Ethereum simplement parce que l’actif porte le symbole ETH ou que l’adresse de destination commence par 0x.

Utilisez le réseau principal Ethereum lorsqu’il s’agit de l’option précisément sélectionnée dans la page de paiement active. N’envisagez un autre réseau que si ces trois conditions sont réunies :

• il figure parmi les options prises en charge dans votre configuration Yolfi active ;
• votre portefeuille de versement est configuré et testé pour ce réseau ;
• vos clients l’utilisent réellement.

Ne déduisez pas la prise en charge d’un réseau à partir d’un portefeuille, d’un format d’adresse ou d’une liste de jetons. Ne publiez que les combinaisons d’actif et de réseau affichées dans le parcours de paiement actif. Le guide destiné aux marchands sur la prévention des paiements en cryptomonnaie sur le mauvais réseau décrit plus en détail les libellés de la page de paiement, les éléments à recueillir en cas d’incident et les nouvelles demandes de paiement.

Comment préparer un parcours de paiement en ETH avec Yolfi

1. Confirmer la disponibilité avant de configurer un portefeuille

Ouvrez la configuration des versements accessible après authentification et vérifiez si ETH sur Ethereum est réellement proposé pour votre compte. Si cette option est absente, ne présentez pas ETH comme moyen de paiement et ne demandez pas aux clients d’envoyer des fonds. Utilisez plutôt une combinaison d’actif et de réseau actuellement prise en charge.

Pour les combinaisons prises en charge, Yolfi utilise un modèle sans garde : les paiements vont du client au portefeuille configuré par le marchand, plutôt que vers un solde détenu par Yolfi. Cela supprime une étape de garde, mais confie au marchand la responsabilité de la sécurité du portefeuille, de la propriété de l’adresse et du rapprochement des paiements. Si ETH sur Ethereum devient disponible, ajoutez uniquement une adresse Ethereum de versement contrôlée par l’entreprise et vérifiez-la caractère par caractère.

2. Choisir ETH et le réseau exact indiqué

Sélectionnez ETH sur Ethereum uniquement lorsque cette combinaison est disponible dans la configuration active et authentifiée. Si Yolfi propose d’autres réseaux, considérez chacun d’eux comme un parcours de paiement distinct, avec ses propres tests, instructions aux clients et registres de versement.

La page de paiement doit indiquer « ETH sur Ethereum », et pas seulement « cryptomonnaie » ou « envoyez des ETH ici ». Répétez le nom du réseau au moment où le client approuve la transaction.

3. Définir le montant et la règle d’expiration

Pour un produit libellé en ETH, indiquez le montant exact en ETH. Pour un produit libellé en monnaie fiduciaire, laissez la page de paiement calculer un montant en ETH au cours proposé et définissez la durée de validité de ce cours.

Décidez à l’avance de la façon dont le système gère :

• une transaction soumise avant l’expiration, mais confirmée après celle-ci ;
• un paiement envoyé après l’expiration ;
• un montant inférieur à celui demandé ;
• un montant supérieur à celui demandé ;
• deux transactions envoyées pour une seule commande.

Ne résolvez pas ces cas en modifiant silencieusement l’historique des commandes. Soumettez les écarts à une vérification ou émettez une nouvelle demande de paiement conformément à une politique documentée.

4. Créer un lien de paiement ou intégrer la page de paiement

Un lien de paiement en cryptomonnaie est la solution structurée la plus rapide pour une facture, une offre de services, un produit numérique ou un client qui demande à payer en ETH. Il associe au transfert un montant et un contexte commercial, sans nécessiter d’intégration personnalisée.

Un produit en libre-service doit relier la page de paiement à ses propres données de commande et de client. Conservez des identifiants tels que :

• l’identifiant du client ou du compte ;
• l’identifiant de la commande ou de la facture ;
• le produit et l’offre ;
• le prix de référence en monnaie fiduciaire et le montant en ETH proposé ;
• la date et l’heure de création et d’expiration du cours proposé ;
• l’actif et le réseau sélectionnés.

Ces champs permettent à l’assistance et à la comptabilité de travailler sans devoir interpréter l’activité du portefeuille.

5. Attendre l’état de confirmation requis

Les transactions Ethereum passent par plusieurs états. Elles peuvent rester en attente, être remplacées, échouer ou être incluses dans un bloc. La documentation sur les transactions Ethereum explique les champs des transactions, les frais, les nonces, les signatures et leur inclusion dans la blockchain.

Définissez une politique de confirmation adaptée à la valeur et au risque de la commande. N’affirmez pas que toutes les entreprises ont besoin du même nombre fixe de confirmations. Utilisez plutôt l’état confirmé produit par le parcours de paiement et appliquez toute règle supplémentaire exigée par votre entreprise.

Ne traitez jamais une commande sur la base d’une capture d’écran du portefeuille, d’une page de retour du navigateur ou d’un simple identifiant de transaction. Vérifiez la correspondance entre la transaction et le réseau, l’actif, la destination, le montant exact, la commande et l’état de confirmation demandés.

6. Traiter les événements de paiement de manière idempotente

Lorsque ETH sur Ethereum est pris en charge et activé, utilisez les événements de paiement ou les webhooks de Yolfi pour relier la confirmation à l’application. Un événement confirmé peut :

• marquer une facture comme payée ;
• livrer un téléchargement ou une licence ;
• ajouter des crédits ;
• activer un compte ;
• prolonger une période payante ;
• avertir l’équipe financière ou l’assistance.

Le traitement des webhooks doit être idempotent : recevoir plusieurs fois le même événement ne doit pas entraîner plusieurs livraisons ni prolonger plusieurs fois un abonnement. Enregistrez la référence du paiement et l’identifiant de la transaction, vérifiez l’événement selon la méthode documentée pour l’intégration, ne renvoyez une réponse positive qu’après un traitement durable et relancez les opérations internes de manière sûre si nécessaire.

Liens de paiement ou page de paiement intégrée ?

Choisissez la configuration la plus simple qui offre un niveau de contrôle suffisant.

Une simple adresse de portefeuille n’est pas un lien de paiement. Elle ne comporte ni demande unique, ni prix exact et actuel, ni expiration, ni référence de commande, ni état visible par le client.

Les abonnements en ETH nécessitent une règle de tarification

Yolfi propose des abonnements en cryptomonnaie pour les combinaisons de paiement prises en charge. Ne supposez pas que cela inclut automatiquement ETH sur Ethereum. Si cette combinaison apparaît dans la configuration active et authentifiée, déterminez si l’offre elle-même est libellée en ETH ou en monnaie fiduciaire avant de la proposer.

Une offre à montant fixe en ETH conserve le même montant de jetons, tandis que sa valeur en monnaie fiduciaire varie. Une offre libellée en monnaie fiduciaire nécessite un nouveau cours en ETH pour chaque prélèvement ou demande de paiement. Un stablecoin sur Ethereum peut être plus simple lorsque l’entreprise souhaite que le montant nominal reste proche d’un prix en monnaie fiduciaire.

Votre produit reste responsable des règles d’accès. Définissez :

• le moment où l’accès commence ;
• l’état de paiement qui prolonge la période payante ;
• le délai accordé au client pour résoudre un renouvellement en attente ou échoué ;
• l’existence éventuelle d’un délai de grâce ;
• les changements entraînés par une résiliation ;
• la manière dont sont traités les paiements en double ou tardifs.

Un événement de paiement communique un état financier. Il ne doit pas remplacer l’automate d’états qui gère l’abonnement du produit.

Remboursements et comptabilité

Un paiement Ethereum confirmé n’est pas annulé au moyen d’une rétrofacturation sur le réseau de cartes. Un marchand peut néanmoins rembourser un client en envoyant une transaction distincte conformément à sa politique de remboursement.

Avant d’émettre un remboursement :

1. vérifiez la commande d’origine et la transaction confirmée ;
2. vérifiez le montant et l’actif approuvés pour le remboursement ;
3. obtenez et vérifiez l’adresse de remboursement selon une procédure documentée ;
4. indiquez comment les frais de réseau sont traités ;
5. exigez la validation interne appropriée ;
6. enregistrez la transaction de remboursement séparément du reçu d’origine.

Ne remboursez pas automatiquement une adresse copiée dans un message inattendu. Le payeur, le titulaire du compte et le destinataire proposé peuvent être des personnes différentes.

Pour chaque paiement, conservez la référence de commande, le client, l’actif, le réseau, le montant en cryptomonnaie, la valeur de référence en monnaie fiduciaire et l’horodatage utilisés par l’entreprise, l’adresse de versement, l’identifiant de transaction, l’état de confirmation, les frais enregistrés par votre entreprise et tout remboursement ultérieur. Le traitement comptable et fiscal varie selon les pays ; confirmez donc la méthode d’évaluation et de déclaration requise auprès d’un conseiller qualifié.

Erreurs courantes lors de l’acceptation des ETH

Publier uniquement une adresse de portefeuille

Une adresse n’indique au client ni le montant actuel, ni le réseau, ni la date d’expiration, ni la référence de commande. Utilisez une demande de paiement qui relie le transfert à l’achat.

Considérer ETH et Ethereum comme des synonymes

Ethereum est le réseau ; ETH est son actif natif. Les stablecoins et d’autres jetons peuvent également circuler sur Ethereum. Indiquez à la fois l’actif et le réseau dans les instructions destinées au client.

Ignorer la volatilité du gas

Le prix du marchand et les frais de gas du client sont distincts. N’annoncez pas de frais permanents et ne supposez pas que les frais sont identiques pour les transferts d’ETH et de jetons.

Laisser un cours en ETH ouvert trop longtemps

Un cours obsolète entraîne des paiements insuffisants ou excédentaires qui pourraient être évités. Utilisez une règle d’expiration explicite et émettez une nouvelle demande si nécessaire.

Traiter la commande depuis la page de retour

Le navigateur peut revenir avant qu’un paiement valide soit confirmé. Ne traitez la commande qu’après qu’un état de paiement vérifié ou un webhook vérifié a été associé à la demande.

Appliquer partout une seule règle de confirmation codée en dur

La politique de confirmation doit tenir compte de l’état de la transaction, de la valeur de la commande et du risque. Distinguez les décisions de traitement à haut risque de la simple apparition d’un identifiant de transaction.

Supposer que chaque transfert vers une adresse en 0x utilise le réseau principal Ethereum

Plusieurs réseaux utilisent des adresses au format Ethereum. Acceptez uniquement le réseau sélectionné dans le parcours de paiement actif et vérifiez la transaction sur ce réseau.

Oublier les procédures de remboursement et de tenue des comptes

Le versement direct dans un portefeuille ne supprime ni le travail d’assistance ni celui de comptabilité. Définissez la vérification des adresses, les validations, le traitement des frais de réseau, les relevés d’évaluation et le rapprochement avant que le volume augmente.

FAQ

Comment accepter les paiements Ethereum sur mon site web ?

Vérifiez d’abord qu’ETH sur Ethereum apparaît dans votre configuration Yolfi active et authentifiée. Si c’est le cas, configurez un portefeuille de versement et créez un lien de paiement ou une page de paiement intégrée. Affichez le montant exact et l’expiration, puis attendez un état de paiement confirmé ou un webhook vérifié avant de traiter la commande. Si cette combinaison n’apparaît pas, choisissez-en une qui est prise en charge au lieu d’accepter un transfert non géré.

Puis-je accepter les paiements en ETH sans procédure KYC ?

Ne déduisez pas la réponse d’une page publique consacrée à ETH. Vérifiez les exigences actuelles d’inscription et de configuration authentifiée pour la combinaison de paiement proposée à votre compte. Votre entreprise peut également être soumise à ses propres obligations juridiques, fiscales, de vérification des clients ou de déclaration selon son activité et son pays.

Les clients paient-ils les frais de gas Ethereum ?

Le portefeuille expéditeur paie les frais du réseau Ethereum en ETH. Séparez ces frais de gas du montant de l’achat. L’estimation peut varier selon la demande sur le réseau et le type de transaction.

Dois-je fixer les prix des produits en ETH ou en monnaie fiduciaire ?

Utilisez un prix fixe en ETH lorsque le produit est volontairement libellé en ETH et que l’entreprise accepte les variations de taux de change. Pour les biens libellés en monnaie fiduciaire, créez un cours en ETH à durée limitée ou proposez un stablecoin pris en charge si celui-ci correspond mieux au modèle de tarification.

Combien de confirmations un paiement en ETH doit-il avoir ?

Il n’existe pas de nombre unique adapté à tous les marchands et à toutes les commandes. Utilisez l’état confirmé du système de paiement et une politique de risque écrite, fondée sur l’état de la transaction, sa valeur et le risque lié au traitement de la commande. Ne considérez pas la soumission ou un identifiant de transaction comme une confirmation.

Puis-je accepter USDC ou USDT sur Ethereum plutôt que l’ETH ?

Oui, lorsque la combinaison exacte du stablecoin et d’Ethereum est proposée dans votre configuration Yolfi active. Les stablecoins conviennent aux produits libellés en monnaie fiduciaire, mais les clients ont toujours besoin d’ETH pour payer le gas et doivent utiliser le bon jeton et le bon réseau.

Puis-je accepter des ETH sur d’autres réseaux que le réseau principal Ethereum ?

N’activez un autre réseau que s’il apparaît dans votre configuration Yolfi active, si votre portefeuille de versement est correctement configuré pour celui-ci et si vos clients l’utilisent. Ne déduisez pas sa prise en charge d’un format d’adresse ou d’un libellé de portefeuille.

Les paiements en ETH sont-ils remboursables ?

Un paiement confirmé n’est pas annulé comme une rétrofacturation de carte. Le marchand peut émettre une transaction distincte conformément à sa politique de remboursement, après avoir vérifié la commande, le montant, l’actif, la destination, la validation et le traitement des frais de réseau.

Yolfi peut-il conserver ou convertir mes ETH ?

Pour les combinaisons de paiement prises en charge, le modèle documenté est le versement direct sans garde : les paiements des clients sont envoyés au portefeuille configuré par le marchand. Ne créez pas de processus reposant sur l’hypothèse que Yolfi conserve, convertit ou reverse ultérieurement les ETH, et ne supposez pas qu’ETH est pris en charge s’il n’apparaît pas dans la configuration authentifiée.

Conclusion

Pour accepter les paiements Ethereum de manière fiable, considérez la page de paiement comme un système de paiement plutôt que comme une simple page affichant une adresse de portefeuille. Choisissez ETH ou un stablecoin sur Ethereum selon le modèle de tarification, séparez le gas du montant de l’achat, faites expirer les cours volatils, affichez précisément le réseau et attendez des données de paiement confirmées.

Si ETH sur Ethereum apparaît dans la configuration Yolfi active et authentifiée, commencez par un seul produit et un seul parcours de paiement. Testez le montant exact, l’expiration, la transaction du portefeuille, la confirmation, le webhook, le traitement de la commande, le rapprochement et la procédure de remboursement. N’ajoutez des abonnements ou d’autres options de réseau qu’une fois ce parcours opérationnel et lorsque la demande des clients justifie cette complexité supplémentaire. Si cette combinaison n’est pas disponible, n’improvisez pas avec une simple adresse de portefeuille.