Comment ajouter les paiements crypto à une boutique en ligne

Décidez d'abord

Quatre décisions évitent de refaire le travail plus tard.

1. Quels actifs et réseaux. Commencez petit : l'USDT et l'USDC couvrent la plupart des clients. Qvard prend en charge USDT, USDC, BTC, LTC, TRX, BNB et ETH, sur les réseaux TRC20, ERC20, BEP20, Bitcoin et Litecoin.
2. Prix en dollars. Gardez vos prix tels quels. Le paiement est créé en dollars américains et le montant crypto exact s'affiche sur la page de paiement, avec un taux fixe pendant une heure.
3. Ce que déclenche une commande payée. Expédition, clé de licence, accès à un contenu. Décidez de ce qui se passe au moment où le paiement est terminé.
4. Ce que vous faites quand quelque chose tourne mal. Paiements incomplets, remboursements, un client qui a payé sur le mauvais réseau. Écrivez la règle maintenant.

Étapes d'intégration

Qvard n'a pas encore de plugins prêts pour les boutiques, une boutique s'intègre donc via l'API. Cela fait deux morceaux de code serveur.

1. Créez un paiement quand le client choisit la crypto. Un POST vers https://api.qvard.com/api/v1/payment avec votre numéro de commande comme id et le total de la commande en dollars américains comme price, authentifié avec votre clé d'API. La réponse contient un redirectUrl ; envoyez le client dessus.
2. Recevez le résultat. Enregistrez une URL de callback dans le tableau de bord. Quand le paiement est terminé, Qvard envoie un POST avec votre numéro de commande et le statut. Marquez la commande comme payée et déclenchez l'exécution. Répondez exactement HTTP 200.
3. Rendez le gestionnaire sûr. Il peut être livré plus d'une fois, donc une répétition ne doit rien changer.

Les versions détaillées : comment accepter les paiements crypto sur un site web pour le flux générique, WordPress et WooCommerce pour ces plateformes, et l'API de paiement crypto pour les développeurs comme référence.

Associez les statuts aux états de votre commande

Un paiement a quatre statuts : wait, partial, completed et rejected. Votre commande a besoin d'états correspondants, et le webhook n'arrive que sur completed.

• Commande créée et impayée correspond à wait.
• Un paiement incomplet correspond à partial : gardez la commande en attente et demandez la différence au client.
• Une commande payée correspond à completed : exécutez-la.
• rejected : considérez le paiement comme échoué et laissez le client réessayer.

L'association complète, avec du code, se trouve dans les paiements crypto pour l'e-commerce.

Rédaction de la page de paiement

La plupart des tickets de support sur la crypto viennent d'une rédaction peu claire. À l'étape de paiement :

• nommez les pièces et réseaux acceptés ;
• dites que le montant doit être envoyé en entier et sur le réseau affiché sur la page de paiement ;
• indiquez que le taux est fixe pendant une heure ;
• expliquez comment fonctionnent les remboursements et où obtenir de l'aide.

Qvard ne propose pas encore d'URL de retour : le client arrive sur la page de paiement et c'est vous qui lui dites ce qui se passe ensuite. Une page de commande claire qui se met à jour après le webhook, plus un e-mail de confirmation, remplace la redirection.

Test et mise en production

Il n'y a pas encore de sandbox, testez donc avec de petits montants réels.

1. Payez un petit montant réel et suivez tout le parcours : paiement créé, client a payé, webhook reçu, commande marquée comme payée.
2. Faites échouer l'endpoint une fois et vérifiez que la nouvelle tentative (cinq tentatives en six minutes environ) n'exécute pas la commande deux fois.
3. Retirez un petit montant vers votre propre portefeuille pour vérifier cette étape. Il ne coûte que les frais de réseau.
4. Ajoutez la crypto au paiement et surveillez les premières commandes.

Après le lancement, tenez une routine courte ; la liste est dans la liste de contrôle opérationnelle pour les paiements crypto. Coût : pas d'abonnement, et la commission, individuelle pour votre projet, commence à 1 % et peut descendre jusqu'à 0,1 % selon la page des tarifs.

FAQ