Liste de contrôle opérationnelle pour les paiements crypto

Avant le lancement

À faire une fois, puis après tout changement sur votre serveur.

• La clé d'API est uniquement sur le serveur, dans une variable d'environnement ou un gestionnaire de secrets, jamais dans le code front-end ni dans un dépôt.
• L'URL de callback est enregistrée, publique et en HTTPS, et joignable depuis l'extérieur de votre réseau.
• Le gestionnaire de webhook répond exactement HTTP 200, rapidement, et peut être exécuté deux fois sans risque. Tout autre statut, un délai dépassé ou une redirection comptent comme une livraison échouée. Voir comment sécuriser les webhooks de paiement crypto.
• Un paiement de test fonctionne de bout en bout. Payez un petit montant réel, vérifiez que le webhook arrive et que la commande passe en payée. Il n'y a pas encore de sandbox, utilisez donc de petits montants réels.
• Une nouvelle tentative fonctionne. Faites échouer l'endpoint une fois et vérifiez que Qvard réessaie (cinq tentatives en six minutes environ) sans exécuter la commande deux fois.
• Un retrait fonctionne. Retirez un petit montant vers votre propre portefeuille. Il ne coûte que les frais de réseau.
• Les règles sont écrites : que faire d'un paiement incomplet, comment rembourser et qui répond aux clients.

Chaque jour

Quelques minutes, idéalement à la même heure.

• Commandes impayées hors de la fenêtre de taux. Le taux affiché sur la page de paiement est fixe pendant une heure. Regardez les commandes qui attendent encore après : elles ont été abandonnées ou une notification a été manquée.
• Paiements incomplets. Un paiement au statut partial n'envoie pas de webhook de fin. Vérifiez-les dans le tableau de bord, gardez la commande en attente et contactez le client. Voir comment traiter les paiements USDT incomplets.
• Erreurs sur l'endpoint du webhook. Une série de requêtes échouées ou de réponses 401 signale un endpoint cassé ou une clé qui ne correspond pas. Mettez en place une alerte plutôt que de le découvrir en fin de journée.
• Le total du jour. Comparez les commandes que vous avez marquées payées aux paiements du tableau de bord. L'API publique n'a pas de route pour lister les paiements ; c'est donc une comparaison avec votre propre journal de webhooks. Voir le rapprochement des paiements pour les commerçants crypto.

Chaque semaine

• Notifications manquées. Si le tableau de bord montre un paiement terminé que votre système de commandes ne montre pas, renvoyez la notification depuis le tableau de bord et laissez le gestionnaire idempotent l'appliquer.
• Tendances du support. Comptez les tickets sur les mauvais réseaux, les paiements incomplets et « j'ai payé, rien ne s'est passé ». Si l'un se répète, corrigez la formulation au paiement ou sur la page de commande plutôt que chaque ticket.
• Remboursements. Vérifiez que chaque remboursement envoyé est enregistré sur sa commande d'origine et est parti vers une adresse et un réseau confirmés par le client.
• Soldes par actif et réseau. Les paiements sur des réseaux différents s'accumulent séparément. Regardez ce qui se trouve où avant de décider quoi retirer.
• Stock et expiration. Si vous réservez du stock pour les commandes impayées, vérifiez que les commandes expirées le libèrent.

Chaque mois

• Rapprochez en entier. Croisez les commandes du mois, le journal des webhooks et les paiements du tableau de bord, et expliquez chaque écart. Comptabilisez le chiffre d'affaires en dollars à la valeur de la commande et enregistrez la commission et les frais de retrait sur des lignes distinctes.
• Examinez les retraits. Il n'y a pas d'abonnement ; la commission est individuelle pour votre projet et, selon la page des tarifs, commence à 1 % et peut descendre jusqu'à 0,1 %. Un retrait ne coûte que les frais de réseau, en général un montant fixe par transfert ; retirez donc par montants raisonnables plutôt qu'en de nombreux petits retraits. Voir les frais de réseau dans les opérations de paiement crypto.
• Renouvelez et auditez les accès. Vérifiez qui voit la clé d'API et le tableau de bord, et remplacez la clé si une personne qui l'avait est partie ou si vous soupçonnez une fuite.
• Relisez le texte destiné aux clients. Le paiement indique-t-il toujours les actifs et réseaux acceptés, la note sur les frais et la règle de remboursement ? Est-ce toujours exact ?
• Consultez votre comptable. Le traitement fiscal et comptable des encaissements crypto dépend de votre pays ; réexaminez la pratique régulièrement.

Quand quelque chose semble anormal

Un court scénario pour les cas courants.

• Un client dit avoir payé et la commande est impayée. Regardez le paiement dans le tableau de bord. S'il est terminé, renvoyez la notification. S'il est partial, demandez la différence. S'il n'existe pas, demandez les détails de la transaction et le réseau utilisé.
• Mauvais réseau. Les fonds n'arrivent pas comme prévu et demandent un traitement manuel. Gardez un contact support visible sur le parcours de paiement.
• Une commande payée a été exécutée deux fois. Le gestionnaire n'est pas idempotent. Rendez la mise à jour conditionnelle (« payée seulement si pas encore payée ») dans une seule instruction de base de données.
• Le webhook n'arrive plus. Testez l'endpoint depuis l'extérieur de votre réseau, regardez le code de réponse dans le journal d'accès et cherchez un pare-feu, une redirection ou un gestionnaire lent. Voir la stratégie de nouvelles tentatives des webhooks.
• Vous ne savez pas ce que fait l'API. La référence est l'API de paiement crypto pour les développeurs.

Gardez cette liste là où toute votre équipe la voit et notez qui est responsable de chaque ligne.

FAQ