Aller au contenu
Crypto Merchant

Les bases

Page de paiement

Les clients paient sur des pages hébergées par Crypto Merchant. Vous n’avez pas besoin de site web : partagez votre page de paiement ou un lien de paiement. Si vous en avez un, créez des factures avec l’API et envoyez vos clients vers la page de la facture.

Votre page de paiement

Chaque boutique a sa propre page de paiement à l’adresse /pay/<store>, où <store> est le nom court de votre boutique. Les clients peuvent y saisir un montant ou choisir l’un de vos liens de paiement. Partagez-la partout où vous échangez avec vos clients : votre site web, vos profils sur les réseaux sociaux, vos conversations ou vos e-mails.

Vous trouverez le lien dans le portail sous Votre page de paiement.

La page de la facture

Chaque facture a sa propre page à l’adresse /pay/i/<invoice_id>. L’API renvoie ce lien dans checkout_url. Sur cette page, le client :

  • choisit une crypto et un réseau parmi ceux que vous acceptez ;
  • voit une adresse de dépôt créée pour cette facture, avec un QR code, et le montant exact à envoyer, à un taux de change bloqué à ce moment-là ;
  • peut passer à une autre crypto tant qu’aucun paiement n’est détecté ;
  • suit l’évolution du statut en temps réel : en attente, en confirmation, puis payée.

Chaque facture reste ouverte pendant une durée limitée, affichée sous forme de compte à rebours. Si le temps s’écoule avant qu’un paiement soit détecté, la facture expire. Si vous définissez une redirect_url, le client peut revenir sur votre site après avoir payé.

Si un client a payé mais que le paiement n’est pas apparu avant l’expiration de la facture, il peut le signaler depuis la page de la facture. L’adresse est alors retirée de la rotation et reste sous surveillance, et notre équipe de support vérifie le paiement.

Un lien de paiement est un lien réutilisable pour un produit, un service ou un don, à l’adresse /pay/l/<link_id>. Donnez-lui un titre et soit un montant fixe, soit un montant vide pour que le client le saisisse. Chaque paiement effectué via un lien devient sa propre facture.

Créez des liens dans le portail sous Liens de paiement, ou avec l’API.

Aperçus de partage

Lorsque vous partagez un lien de paiement ou votre page de paiement dans WhatsApp, Telegram, Instagram, X et les applications similaires, l’application affiche une carte d’aperçu. Elle contient le nom de votre boutique, votre domaine vérifié si vous en avez un, et les cryptos que vous acceptez. Pour un lien de paiement, elle affiche aussi le produit et son prix.

Les liens de paiement ne sont pas référencés dans les moteurs de recherche : un lien n’atteint donc que les personnes avec qui vous le partagez.

Domaine vérifié

Si vous avez vérifié le domaine de votre site web, votre page de paiement, vos liens de paiement, les pages de vos factures et vos pages de remboursement l’affichent à côté du nom de votre boutique, par exemple shop.com · vérifié. Cela indique aux clients que la boutique de la page contrôle le DNS de ce domaine. Voir comment vérifier votre domaine.

Taux de change

Les factures sont libellées dans une devise comme le dollar américain. Lorsque le client choisit une crypto, le montant dans cette crypto est calculé à partir des prix en temps réel, puis bloqué. Les stablecoins comme l’USDT et l’USDC valent chacun un dollar américain. Si le paiement est détecté pour la première fois alors que la facture est encore ouverte, le taux bloqué s’applique.

Clients qui paient depuis un exchange

Les exchanges prélèvent généralement leurs frais de retrait sur le montant saisi par le client, si bien qu’il arrive moins que ce qui a été envoyé. C’est la cause la plus fréquente des factures insuffisamment payées. La page de la facture comporte une note Vous payez depuis un exchange ? qui demande au client de veiller à ce que le montant total arrive.

Lorsque les frais de retrait de Binance pour cette crypto et ce réseau sont disponibles, la note affiche aussi ces frais et le total à saisir sur Binance. Les autres exchanges facturent leurs propres frais, que le client doit vérifier sur l’écran de retrait.

Mauvaise crypto ou mauvais réseau

Il arrive que des clients paient dans une autre crypto que celle demandée par la facture, ou sur un autre réseau. Crypto Merchant surveille chaque adresse de facture pour toutes les cryptos prises en charge, sur tous les réseaux pris en charge qui utilisent cette adresse : ces paiements sont donc détectés.

Une même adresse EVM fonctionne sur Ethereum, BNB Smart Chain, Polygon, Base et Arbitrum One, et nous détenons sa clé sur tous ces réseaux. Ainsi, de l’USDC envoyé sur Base à une facture qui demandait de l’USDC sur Ethereum arrive quand même sur une adresse que nous contrôlons. Tron, Bitcoin, Litecoin, Solana, TON et XRP Ledger ont chacun leur propre type d’adresse. Sur ces réseaux, cela couvre une autre crypto sur le même réseau, par exemple du TRX envoyé à une facture en USDT sur Tron.

Quand le paiement est pris en compte automatiquement

Le paiement est pris en compte pour la facture de lui-même lorsque ces deux conditions sont réunies :

  • rien d’autre n’a encore été payé sur la facture ;
  • les cryptos couvrent le montant de la facture, dans la limite de votre tolérance de paiement insuffisant.

La facture passe alors à la crypto réellement envoyée. La page de la facture indique au client dans quelle crypto il a payé au lieu de celle demandée. Vous voyez la Crypto demandée sur le paiement et dans l’e-mail de paiement. Dans l’API, coin est ce qui a été payé et requested_coin est ce que la facture demandait.

Les cryptos sont évaluées ainsi :

  • les stablecoins comme l’USDT et l’USDC comptent chacun pour un dollar américain ;
  • la même crypto sur un autre réseau, par exemple de l’ETH sur Base pour une facture en ETH sur Ethereum, conserve le taux affiché au client ;
  • toute autre crypto est évaluée au prix du marché au moment de son arrivée.

Cela fonctionne aussi pour les paiements en retard : lorsque la facture a déjà expiré mais que son adresse est encore surveillée, ce qui est le cas pendant au moins 24 heures.

Montants plus faibles et tokens égarés

Tout le reste ne modifie jamais la facture : un paiement partiel dans une autre crypto, une deuxième crypto sur une facture qui a déjà reçu un paiement, ou un token égaré. Il est crédité sur votre solde comme un paiement sans facture, moins les frais de 1 %, et un ticket de support vous en informe, afin que vous puissiez régler la situation avec le client. Un token minuscule envoyé à l’adresse ne peut pas s’approprier une facture.

Un paiement en retard vers une facture annulée ou remboursée est traité de la même façon : il est crédité sur votre solde, et vous recevez un ticket.

Ce qui peut encore être perdu

Les cryptos envoyées sur un réseau ou dans une crypto que Crypto Merchant ne prend pas en charge, et les cryptos envoyées à une autre adresse que celle de la facture, ne peuvent pas être prises en compte et peuvent être perdues définitivement. Les clients doivent quand même envoyer la crypto indiquée, sur le réseau indiqué.

Factures insuffisamment payées

Vous définissez une tolérance de paiement insuffisant dans vos paramètres ; nous recommandons au moins 1 $US. Si un paiement confirmé est inférieur au montant dû d’un écart qui ne dépasse pas la tolérance, la facture compte comme payée.

Si l’écart est plus important, la facture passe au statut paiement insuffisant. Ce qui a été envoyé est conservé pour le client, qui peut soit envoyer le reste à la même adresse, soit obtenir le remboursement de ce qu’il a envoyé vers une adresse qu’il indique. Les frais de réseau d’un remboursement sont prélevés sur le remboursement.

Factures payées en excès

Si un client envoie plus que ce que demande la facture, celle-ci compte quand même comme payée. Ce qu’il advient de l’excédent dépend de sa valeur :

  • La facture compte comme payée, et l’excédent est conservé pour le client. Le client peut le retirer vers son propre portefeuille depuis la page de la facture, moins les frais de réseau pour l’envoi.
  • Jusque-là, Crypto Merchant le conserve pour le client. Il n’est pas ajouté au solde de l’entreprise et n’est jamais retenu à titre de frais.

Remboursements après un paiement

Vous pouvez renvoyer de l’argent sur un paiement encaissé, par exemple pour un retour ou une commande annulée. Ouvrez le paiement dans le portail et utilisez Rembourser ce paiement. Seuls les administrateurs peuvent le faire, et ils confirment d’abord leur identité avec un nouveau code reçu par e-mail ou généré par leur application d’authentification.

  • Vous pouvez rembourser n’importe quel montant jusqu’à ce que vous avez conservé sur ce paiement : ce qui vous a été crédité après les frais de 1 %, moins les remboursements précédents et les liens de remboursement encore ouverts. Les frais de 1 % ne sont pas remboursés.
  • Le montant est mis de côté sur votre solde immédiatement, afin qu’il ne puisse pas être versé par erreur entre-temps.
  • Si le paiement comporte l’e-mail du client, celui-ci reçoit un e-mail avec un lien privé. Vous pouvez aussi copier le lien et l’envoyer vous-même.
  • Le client ouvre le lien, saisit sa propre adresse pour cette crypto et ce réseau, coche une confirmation et valide. Le remboursement est envoyé depuis votre portefeuille pool, et les frais de réseau sont déduits du remboursement.
  • Un lien reste ouvert pendant 14 jours. Si le client ne le réclame pas à temps, ou si vous l’annulez, le montant revient automatiquement sur votre solde. Chaque lien ne peut être réclamé qu’une seule fois.

Un remboursement partiel laisse le paiement au statut Payée et affiche le montant remboursé. Rembourser tout ce que vous avez conservé le fait passer au statut Remboursée. Chaque réclamation envoie un webhook invoice.refunded, et l’objet facture indique le total dans refunded_amount.

Comme le client saisit l’adresse sur la page de remboursement, personne n’a à échanger d’adresses dans une conversation, où une faute de frappe ou un imposteur peut envoyer les cryptos au mauvais endroit. Les transferts de cryptos sont irréversibles : le client doit donc saisir une adresse qu’il contrôle, sur le réseau indiqué.

Les factures insuffisamment payées conservent leur propre option de remboursement pour le client sur la page de la facture, et les clients peuvent toujours y retirer un trop-perçu, comme décrit plus haut. Les parts déjà mises de côté pour les partenaires d’un partage des revenus ne sont pas reprises par un remboursement.

Frais

1 % de chaque facture payée est déduit lorsque le paiement est crédité sur votre solde. Les factures expirées et annulées ne coûtent rien.

Aucun frais supplémentaire ne s’applique lorsqu’un paiement est pris en compte alors qu’il est arrivé dans une autre crypto ou sur un autre réseau. Lorsque vous remboursez un paiement, les frais de 1 % ne sont pas remboursés, et les frais de réseau du remboursement sont déduits du remboursement.

Le montant dû inclut aussi des frais de gas pour déplacer ce paiement vers votre portefeuille pool, jamais plus de 5 $US. Sur la plupart des réseaux, c’est quelques centimes. L’USDT sur Tron coûte plus cher, car Tron brûle de l’énergie à chaque transfert de token. La page de paiement affiche les frais à côté du prix, et l’API les renvoie sous network_fee_amount et network_fee_usd. Ils couvrent le regroupement de ce paiement, ne sont pas vos revenus, et aucun frais de paiement n’est prélevé dessus.