Configurer les frais par devise dans QryptoPay
QryptoPay peut ajouter au montant de la commande des frais distincts pour le paiement dans chaque cryptomonnaie : un pourcentage du montant, avec un seuil bas et un seuil haut facultatifs. Le réglage est unique pour tout le module : activez le commutateur général et définissez le pourcentage des devises voulues, et les frais s’appliquent aux nouveaux paiements.
ℹ️ Pourquoi c’est utile
L’argent du client n’arrive pas toujours directement sur votre portefeuille final : sur certains réseaux, il faut payer des frais de réseau pour regrouper les fonds reçus. Des frais supplémentaires sur le paiement aident à compenser ce coût. C’est aussi un moyen d’orienter le flux de paiements vers les devises qui vous intéressent, sans désactiver complètement les autres.
Trois façons de répartir ce coût
Vous décidez comment compenser le coût du transfert, et vous avez trois options :
- À vos frais. Le prix en boutique ne change pas, et le coût du transfert est prélevé à chaque fois sur votre portefeuille. Il n’est pas constant : il dépend de la devise choisie par le client.
- L’intégrer au prix de la boutique. Vous majorez vous-même le prix de l’article d’une estimation moyenne du coût. C’est une approche unique pour toutes les devises : la boutique transmet à QryptoPay le montant final du paiement, et le client ne choisit la devise précise qu’à l’étape du paiement. C’est simple et prévisible, mais le coût réel du transfert varie d’une devise à l’autre, alors que le prix, lui, reste le même.
- Confier le calcul à QryptoPay — l’option décrite dans cet article. C’est la seule qui permet de fixer des frais différents selon la devise et d’ajuster ainsi le flux de paiements : des frais plus élevés pour les devises qui vous arrangent le moins, des frais faibles ou nuls pour celles qui vous arrangent le plus. Les frais s’ajoutent au montant à la dernière étape du paiement et ne sont visibles du client qu’à ce moment-là, pas dans le prix de l’article.
QryptoPay ne fait pas la différence entre les deux premières options : de son côté, il s’agit simplement de « frais désactivés ». La seule différence tient à la façon dont vous établissez le prix dans votre boutique.
Comment les frais sont calculés
Les frais correspondent à un pourcentage du montant de la commande. Mais pour les petits paiements, un pourcentage seul peut ne pas suffire à couvrir à coup sûr le coût du réseau : c’est le rôle du seuil bas, le montant minimal des frais en USD. Pour les gros paiements, la logique s’inverse : le seuil haut plafonne les frais pour que l’achat reste avantageux pour le client. Gardez à l’esprit que, sur certains réseaux, les frais de transfert sont fixes et ne dépendent pas du montant transféré. Chaque seuil peut rester vide ; il n’y a alors aucune limite de ce côté.
💡 Soyez prudent avec les seuils
Un seuil trop haut ou trop bas peut dérouter le client au moment de payer. Par exemple, pour une commande de 10 USD avec des frais de 2 % et un seuil bas de 5 USD, les frais finaux sont de 5 USD et non de 0,20 USD : le seuil s’est déclenché. Avant de fixer des seuils, évaluez-les sur un montant de commande typique pour votre boutique. Ou définissez plutôt, au niveau de la boutique, un montant minimal pour le paiement en cryptomonnaie.
ℹ️ Les frais valent par devise, pas par réseau ni par marchand
L’USDT sur le réseau Ethereum et l’USDT sur le réseau Tron reçoivent les mêmes frais : il est impossible de les configurer séparément. Le réglage est en outre commun à tout le module : si vous avez plusieurs marchands, les frais s’appliquent de la même façon à tous, il n’y a pas de réglage par marchand.
Les frais sont figés une seule fois, au moment où la facture est émise pour le client. Si vous modifiez ensuite le pourcentage ou les seuils, les factures déjà émises ne sont pas touchées : les nouvelles valeurs ne s’appliquent qu’aux paiements suivants.
Ce que voit le client
Le montant à payer affiché sur la page de paiement inclut déjà les frais : inutile de les ajouter à part. Le montant des frais est indiqué pour chaque moyen de paiement et à côté du montant de la commande ; le client peut donc comparer les devises lui-même et choisir celle dont les frais sont les plus bas.
Ce que reçoit la boutique
Dans la notification de paiement, les frais apparaissent séparément du montant de la commande : vous savez donc toujours combien le client a payé, combien a été retenu et combien il vous reste.
⚠️ Revoyez le rapprochement des paiements
Si votre intégration compare le montant du paiement au montant de la commande, l’activation des frais change cette comparaison : le montant du paiement devient supérieur à celui de la commande, à hauteur des frais. Rapprochez les paiements à l’aide des nouveaux champs de la notification, et pas seulement du montant initial.
Configurer la boutique
Pour que la boutique traite correctement les frais, rapprochez la commande du montant effectivement revenu à la boutique, et non du montant total reçu du client. Voici un extrait de la notification de paiement, limité aux champs nécessaires (commande de 49 USD, frais de 5 USD) :
{
"payment_result": "success", // résultat du paiement
"amount_fiat": "54.00", // total reçu du client : commande et frais
"surcharge_fiat": "5.00", // frais retenus
"amount_fiat_net": "49.00" // reste à la boutique — rapprochez la commande de ce montant
}Le premier montant est toujours égal à la somme des deux autres : amount_fiat = amount_fiat_net + surcharge_fiat.
Les deux champs de frais sont toujours transmis, même quand les frais sont désactivés : surcharge_fiat vaut alors 0.00 et amount_fiat_net est égal à amount_fiat. Les intégrations déjà écrites continuent donc de fonctionner, et vous pouvez passer aux nouveaux champs dès maintenant, avant d’activer les frais.
Ce n’est qu’un extrait : la composition complète de la notification et la manière de la vérifier sont décrites dans l’article Intégrer la boutique à QryptoPay.
Ne traitez automatiquement que les paiements réussis
La notification contient un marqueur de résultat : le paiement s’est déroulé normalement (y compris si le sous-paiement reste dans la limite tolérée), un montant incorrect est arrivé, ou le paiement n’a donné lieu à aucune facture (le détail de chaque cas figure dans l’article Intégrer la boutique à QryptoPay). Cela influe aussi sur les frais : on ne peut les calculer avec précision que pour un paiement normal, et les deux autres cas se règlent plus sûrement à la main — complément de paiement, remboursement ou décision de laisser en l’état.
Bitcoin et Litecoin — le coût apparaît autrement
Pour Bitcoin et Litecoin, la réception d’un paiement ne coûte rien en soi : l’argent arrive directement chez vous, sans transfert distinct depuis l’adresse du client. Le coût apparaît plus tard, au retrait des fonds accumulés : le réseau regroupe les paiements reçus précédemment en une seule transaction, et le coût de cette transaction augmente avec le nombre de paiements regroupés, et non avec leur montant.
Le coût d’un retrait dans ces devises dépend donc du nombre de paiements reçus, et non de leurs montants. Des frais de paiement activés pour Bitcoin ou Litecoin ne reflètent pas directement ce coût : comme pour toute autre devise, c’est votre propre décision, et non un recalcul des dépenses réelles.
Monero — la réception est gratuite, le coût est de votre côté
La réception de Monero ne coûte rien non plus : l’argent du client arrive tout de suite sur votre portefeuille, sans transfert intermédiaire. Un coût n’apparaît que lorsque vous transférez vous-même cet argent plus loin, depuis votre application de portefeuille crypto — et c’est vous qui le payez, pas le panneau : QryptoPay n’effectue aucun transfert sortant en Monero.
Vous pouvez activer des frais de paiement pour Monero dans les mêmes conditions que pour toute autre devise ; gardez simplement à l’esprit qu’ils ne sont liés à aucun coût supporté par le panneau.
Comment les activer
Les frais se configurent dans QryptoPay → « Paramètres » → « Cryptomonnaies », dans le bloc « Frais » : le commutateur général active ou désactive les frais pour tout le module, et un clic sur une devise ouvre, pour elle seule, le pourcentage et les deux seuils.
💡 Pas de frais par défaut
Tant que vous n’avez pas défini explicitement un pourcentage, les frais d’une devise sont nuls : activer le commutateur général ne modifie pas, à lui seul, le coût des paiements.
Sur la même page, sous le bloc de priorité des devises, se trouve un autre bloc, « Sous-paiement toléré » : un réglage distinct qui permet de clôturer une facture lorsque le client a viré un peu moins que la somme due. Pour en savoir plus, consultez l’article Intégrer la boutique à QryptoPay.