Accepter les paiements crypto dans une boutique en ligne, sans plugin

En bref

Comment ça fonctionne, étape par étape ?

Du moment où un client choisit « Payer en crypto » jusqu’à la sortie de la commande de votre entrepôt :

1. 1

   Créer la facture au moment du paiement

   Lorsque le client choisit la crypto, votre serveur appelle POST /invoices avec le total de la commande, votre order_id, l’e-mail du client, une redirect_url vers votre page de remerciement et toutes les metadata que vous souhaitez récupérer en retour. La réponse est la facture, avec une checkout_url.

2. 2

   Envoyer le client vers la page de la facture

   Redirigez vers checkout_url. La page liste les cryptos que vous acceptez ; lorsque le client en choisit une, le montant dans cette crypto est calculé à partir des prix en temps réel et bloqué, et une adresse de dépôt créée pour cette facture est affichée avec un QR code. La facture reste ouverte pendant la durée que vous définissez, 30 minutes par défaut.

3. 3

   Recevoir les webhooks signés

   Votre endpoint reçoit invoice.confirming lorsque le paiement est détecté sur la chaîne et invoice.paid une fois qu’il a suffisamment de confirmations. Vérifiez l’en-tête CM-Signature, enregistrez l’événement, répondez par un code 2xx en moins de 10 secondes, puis libérez la commande à partir de votre copie enregistrée. Les événements peuvent arriver deux fois : utilisez l’id de l’événement pour n’expédier qu’une seule fois.

4. 4

   Gérer les trois cas particuliers

   invoice.expired : aucun paiement n’est arrivé à temps, proposez donc une nouvelle facture. invoice.underpaid : le client peut envoyer le reste à la même adresse ou obtenir un remboursement depuis la page de la facture. Une facture payée en excédent est quand même payée ; l’excédent est conservé pour le client, qui peut le retirer depuis la page de la facture.

5. 5

   Recevoir votre versement

   Les paiements confirmés sont crédités sur votre solde, moins 1 %, et regroupés dans le portefeuille pool de votre entreprise. Demandez un versement à tout moment vers vos propres adresses, chaque crypto telle quelle ou tout converti dans une seule crypto de conservation.

Le seul appel d’API nécessaire

curl https://cryptomerchant.online/api/v1/invoices \
  -H "Authorization: Bearer $CM_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "64.00",
    "currency": "USD",
    "order_id": "ORD-20931",
    "description": "Order ORD-20931",
    "customer_email": "[email protected]",
    "redirect_url": "https://yourstore.example/orders/20931/thanks",
    "metadata": { "cart": "20931" }
  }'

# 201 → { "id": "inv_…", "status": "open", "checkout_url": "https://cryptomerchant.online/pay/i/inv_…", … }
# Send the customer to checkout_url. Ship on the "invoice.paid" webhook.

Combien ça coûte ?

1 % de chaque facture payée, déduits au moment où le paiement est crédité sur votre solde. Il n’y a pas de frais d’inscription, pas de frais mensuels et aucun paiement pour activer le compte ; les factures expirées et annulées ne coûtent rien. Le déplacement des cryptos (regroupements, conversions et versements) entraîne des frais de gas, prélevés sur votre solde de gas si vous en ajoutez un, sinon sur les cryptos déplacées. Les clients paient aussi des frais de gas sur chaque facture : ils s’ajoutent au montant qu’ils envoient, sont affichés sur la page de paiement et ne dépassent jamais 5 $US. Les taux de conversion incluent une marge de service de 1 %. Tous les coûts figurent dans un seul tableau sur la page Tarifs.

Ce que Crypto Merchant ne fait pas ici

• Pas de plugin de boutique. Il n’y a pas de module WooCommerce, Shopify, Magento, PrestaShop ou OpenCart. Vous ajoutez l’appel d’API vous-même, ou vous partagez votre page de paiement et vos liens de paiement.
• Pas de remboursement automatique ni d’appel de remboursement dans l’API. Un paiement crypto confirmé est définitif : un remboursement est donc un nouveau transfert. Pour un retour, un administrateur crée un lien de remboursement privé à partir du paiement reçu dans le portail ; le client saisit sa propre adresse, les frais de réseau sont prélevés sur le remboursement et les frais de 1 % ne sont pas restitués.
• Avec conservation (custodial), en crypto uniquement. Crypto Merchant détient les clés jusqu’à votre versement, et les versements vont vers vos propres adresses de portefeuille, pas vers un compte bancaire.

À qui cela s’adresse-t-il ?

• Les boutiques qui gèrent déjà leur propre parcours de paiement et peuvent ajouter un appel d’API et un webhook.
• Les boutiques qui vendent à des clients dans des pays où les cartes sont difficiles à obtenir ou où les rétrofacturations font mal.
• Les boutiques qui fixent leurs prix en dollars et veulent être réglées en USDT ou en USDC.

Pages associées

• Accepter la crypto sur Shopify sans plugin
• Accepter la crypto sur WooCommerce sans plugin
• Référence de l’API
• Webhooks
• Paiements insuffisants et excédentaires
• Les meilleures passerelles de paiement crypto
• Tarifs et frais

Autres cas d’usage

• SaaS et abonnements
• Freelances
• Biens numériques
• Dons

Tous les cas d’usage