Qu’est-ce qu’une passerelle de paiement crypto ?

Une passerelle de paiement crypto est le service qui se place entre le portefeuille de votre client et votre système de commandes : elle crée la demande de paiement, surveille la blockchain, prévient votre boutique quand l’argent est arrivé et conserve les fonds jusqu’à votre retrait. Ce guide explique comment cela fonctionne en pratique et ce qu’il faut vérifier avant d’en choisir une.

Ce que fait une passerelle de paiement crypto

Accepter la crypto sans passerelle, c’est donner une adresse de portefeuille à chaque client, surveiller soi-même la blockchain, rapprocher les transferts entrants des commandes et traiter chaque cas particulier à la main. Une passerelle prend en charge quatre tâches :

Elle crée le paiement. Votre système demande un paiement d’un certain montant ; la passerelle renvoie une page de paiement ou une adresse propre à cette commande.
Elle surveille le réseau. Elle voit arriver le transfert, compte les confirmations et décide quand le paiement est définitif.
Elle vous prévient. Elle informe votre boutique, en général par webhook, que la commande 1024 est payée, pour que vous puissiez expédier ou ouvrir l’accès.
Elle conserve et déplace les fonds. L’argent reçu arrive sur un solde commerçant, et vous le retirez vers votre propre portefeuille.

Une passerelle n’est ni un portefeuille dont vous détenez les clés, ni une plateforme d’échange. C’est une infrastructure de paiement : la partie d’un paiement par carte que la banque et le processeur vous cachent d’ordinaire, reconstruite pour les blockchains.

Comment un paiement traverse la passerelle

Chaque passerelle fonctionne un peu différemment, mais le parcours d’un paiement ressemble à ceci :

Votre serveur crée un paiement : un numéro de commande et un montant, en général en dollars.
Le client ouvre la page de paiement et choisit un actif et un réseau, par exemple l’USDT sur TRON. Le commerçant peut aussi présélectionner la méthode.
La passerelle fige le taux de change pour une durée limitée, afin que le montant à envoyer ne bouge pas pendant que le client paie. Chez Qvard, le taux est figé pendant une heure.
Le client envoie le montant exact depuis son propre portefeuille vers l’adresse affichée pour ce paiement.
La passerelle surveille le réseau, attend les confirmations et marque le paiement comme payé.
Elle notifie votre serveur. Votre code marque la commande comme payée et libère la marchandise.
L’argent apparaît sur votre solde commerçant. Vous le retirez vers votre portefeuille manuellement ou selon une règle que vous définissez.

Les paiements réels ne se déroulent pas toujours parfaitement : les clients envoient trop peu, trop, ou après l’expiration du taux. Une bonne passerelle a un statut défini pour chaque cas au lieu de vous laisser faire le rapprochement à la main. Chez Qvard, les statuts d’un paiement sont wait, partial, completed et rejected.

Passerelle, portefeuille, plateforme d’échange et processeur : quelle différence

Ces termes sont souvent confondus :

Portefeuille. Stocke les clés et permet d’envoyer et de recevoir. Il ne rapproche pas les paiements des commandes et ne prévient pas votre boutique.
Plateforme d’échange. Échange un actif contre un autre. Certaines proposent des outils pour commerçants, mais leur fonction principale est le trading.
Passerelle de paiement. Crée et suit les paiements de vos commandes et en communique le statut. C’est le sujet de ce guide.
Processeur ou acquéreur. Dans les paiements par carte, l’entreprise qui fait circuler l’argent entre les banques. En crypto, le mot « acquisition » est employé de façon approximative pour désigner tout le service ; voyez acquisition crypto et passerelle de paiement crypto pour comprendre la différence.

Custodial ou non custodial

Le choix de conception le plus important derrière toute passerelle est : qui détient les fonds entre le paiement et votre retrait ?

Dans une passerelle custodial, les paiements entrants vont vers des adresses contrôlées par le prestataire et sont crédités sur votre solde commerçant. Vous les retirez ensuite. Cela simplifie le rapprochement et permet des fonctions comme les retraits automatiques, mais vous dépendez du prestataire jusqu’au retrait ; ses conditions de retrait comptent donc.

Dans un modèle non custodial, les paiements vont directement vers votre portefeuille. Vous gardez les clés et le prestataire ne fait que suivre le paiement. Cela réduit le risque de contrepartie et vous confie la gestion des clés.

Qvard est custodial : les paiements sont crédités sur un solde commerçant et vous retirez vers votre portefeuille automatiquement selon une règle ou manuellement. Le retrait vers un portefeuille ne coûte que les frais de réseau, et il n’existe pas de retrait vers un compte bancaire.

Stablecoins et réseaux : pourquoi le réseau compte

Un même actif peut exister sur plusieurs blockchains. L’USDT, par exemple, existe sur TRON (TRC-20), Ethereum (ERC-20) et BNB Smart Chain (BEP-20). Un transfert n’est valide que sur le réseau demandé par la page de paiement, et les frais et la vitesse diffèrent d’un réseau à l’autre.

C’est pourquoi la passerelle affiche l’actif et le réseau ensemble, et que le choix du client doit être explicite. Pour le commerçant, les conséquences pratiques sont :

décidez quels réseaux vous voulez accepter et vérifiez que la passerelle les prend en charge ;
attendez-vous à ce que les frais de réseau dépendent de la chaîne et de sa congestion, pas de la passerelle ;
préférez les stablecoins pour fixer les prix en dollars, car un paiement dans un actif volatil peut valoir nettement moins au moment du retrait.

Qvard accepte actuellement l’USDT et l’USDC sur les principaux réseaux, ainsi que le BTC et le LTC natifs ; TON est en préparation. La liste complète figure sur la page des monnaies et réseaux pris en charge.

Ce qu’il faut vérifier avant de choisir une passerelle

Une courte liste qui distingue une passerelle utilisable d’une passerelle risquée :

Réseaux et actifs. Prend-elle en charge ceux que vos clients utilisent vraiment ?
Frais. Que facture la passerelle, et quels sont les frais de réseau à part ? Qui paie quoi ?
Fonds et retraits. Qui détient l’argent, comment fonctionnent les retraits, et y a-t-il des limites ou des options en monnaie fiat dont vous pourriez avoir besoin ?
Qualité de l’API. Pouvez-vous créer un paiement en toute sécurité plusieurs fois avec le même numéro de commande ? Les erreurs sont-elles claires ? Le webhook est-il renvoyé si votre serveur était indisponible ?
Paiements atypiques. Comment sont traités le paiement insuffisant, le trop-perçu et les paiements expirés ?
Tests. Peut-on essayer le parcours sans déplacer d’argent réel ?
Support et documentation. Qui répond quand un paiement reste bloqué ?

Comment choisir un prestataire de paiements crypto passe cette liste en revue plus en détail.

À quoi ressemble une intégration minimale

Créer un paiement tient en une seule requête. Avec Qvard, vous envoyez votre propre numéro de commande et le montant en dollars américains, et vous recevez un identifiant de paiement et un lien vers la page de paiement hébergée. Redirigez le client vers cette page ; tout ce qui concerne le choix de l’actif et l’envoi du transfert s’y passe.

L’id que vous envoyez est votre numéro de commande : renvoyer le même id avec le même moyen de paiement retourne le paiement existant au lieu d’en créer un en double, ce qui rend les nouvelles tentatives sûres. Quand le client paie, Qvard envoie un webhook à votre serveur avec ce même id et le statut du paiement. Le parcours complet, avec du code pour votre backend, est dans comment accepter des paiements crypto sur un site web ; la référence se trouve sur la page développeurs.

curlPOST /api/v1/payment

curl -X POST https://api.qvard.com/api/v1/payment \
  -H "x-api-key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "id": "order_1024", "price": 149.99 }'

# 201 Created
{ "id": "8f3k2a1c", "redirectUrl": "https://my.qvard.com/pay/8f3k2a1c" }

Erreurs courantes

Se fier à la redirection. Un client revenu sur votre page de remerciement n’a pas forcément payé. Marquez une commande comme payée uniquement quand la passerelle indique un statut final.
Ignorer les paiements partiels. Si le client a envoyé moins que le montant, la commande n’est pas payée. Décidez à l’avance si vous demandez la différence ou si vous remboursez.
Ne pas tester la relance du webhook. Si votre serveur répond par une erreur à un webhook, la notification doit être renvoyée, et votre gestionnaire doit gérer sans problème le même événement reçu deux fois.
Fixer les prix dans un actif volatil. Cotez en dollars et laissez le client payer en stablecoin si vous ne pouvez pas porter le risque de prix.
Ne pas tester le chemin de retrait. Retirez un petit montant avant de compter sur la passerelle pour de vrais revenus.

Où se situe Qvard

Qvard est une passerelle de paiement crypto custodial pour les entreprises. Aujourd’hui, vous créez un paiement via l’API, vous envoyez le client vers la page de paiement hébergée, vous recevez le statut final par webhook et vous retirez de votre solde commerçant vers un portefeuille. Les autres façons d’encaisser, comme les liens de paiement, une fenêtre intégrée, un SDK et un terminal de point de vente, sont en développement. Vous pouvez voir la vraie page de paiement avec une facture de démonstration avant de créer un compte, et la page des tarifs explique le fonctionnement des frais.

FAQ

Une passerelle de paiement crypto est-elle la même chose qu’un portefeuille crypto ?

Non. Un portefeuille stocke des clés et envoie des transferts. Une passerelle crée un paiement pour une commande précise, le suit sur la blockchain, communique son statut à votre boutique et conserve l’argent sur un solde commerçant jusqu’à votre retrait.

Un paiement crypto peut-il être annulé ?

Non. Un transfert confirmé sur la blockchain est définitif. Si vous devez rembourser un client, vous envoyez vous-même un nouveau transfert ; définissez donc votre politique de remboursement avant de commencer à accepter des paiements.

Combien de temps faut-il pour confirmer un paiement ?

Cela dépend du réseau et du nombre de confirmations attendues par la passerelle. Certains réseaux confirment en quelques secondes, tandis que Bitcoin produit un bloc environ toutes les dix minutes. La page de paiement affiche le statut pendant l’attente du client.

Dois-je développer quelque chose de mon côté ?

Vous devez créer le paiement depuis votre backend et traiter le webhook qui en indique le statut. Tout le reste, de la page de paiement à la surveillance de la blockchain, est assuré par la passerelle.